L1000FWD Sig Search

Overview

Transcriptomic signature query against the LINCS L1000 Connectivity Map via the L1000FWD Fireworks REST API (maayanlab.cloud/L1000FWD). Accepts two gene sets representing transcriptional changes in a condition of interest: genes increasing and genes decreasing. Internally issues a POST to /sig_search to register the query, then fetches ranked hits from /result/topn/{result_id}. Each returned hit is an L1000 perturbation record containing sig_id, combined score, p-value, and q-value. mode='similar' retrieves perturbations that activate the same transcriptional programme (e.g. disease mimics); mode='opposite' retrieves perturbations that invert it, the classical computational drug-repurposing approach. No authentication required.

Status

The most recent probe succeeded. Safe to call from the agent today.

Last probed

1d ago

Last success

1d ago

Last latency

95ms

Schema

JSON Schema the agent (or your API call) must match.

{
  "properties": {
    "down_genes": {
      "description": "List of down-regulated gene symbols (e.g., ['CDKN1A', 'RB1'])",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "mode": {
      "default": "similar",
      "description": "Return signatures 'similar' to or 'opposite' of the query signature (default: 'similar')",
      "enum": [
        "similar",
        "opposite"
      ],
      "type": "string"
    },
    "n_results": {
      "default": 10,
      "description": "Number of top results to return (default 10)",
      "maximum": 1000,
      "minimum": 1,
      "type": "integer"
    },
    "operation": {
      "description": "Operation type",
      "enum": [
        "sig_search"
      ],
      "type": "string"
    },
    "up_genes": {
      "description": "List of up-regulated gene symbols (e.g., ['MYC', 'TP53'])",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "operation",
    "up_genes",
    "down_genes"
  ],
  "type": "object"
}

Examples (1)

{
  "down_genes": [],
  "n_results": 1,
  "operation": "",
  "up_genes": []
}

Identifiers

Catalog ID

tu_L1000FWD_sig_search

Tool name

L1000FWD_sig_search

Added

2026-04-30 22:47Z

Tags

tooluniverse