OmniPath Get Ligand Receptor Interactions

Overview

Get ligand-receptor interaction pairs from OmniPath, the largest integrated intercellular communication database. Combines data from CellPhoneDB, CellChatDB, CellTalkDB, connectomeDB, Ramilowski2015, Guide2Pharma, HPMR, and 20+ other curated resources. Returns source/target proteins with directionality, stimulation/inhibition flags, supporting databases, and curation effort scores. Essential for cell-cell communication analysis in single-cell transcriptomics (CellPhoneDB/CellChat/LIANA workflows). Example: querying TGFB1 returns 30 ligand-receptor interactions including TGFB1->TGFBR2 (135 curation effort, 34 databases), TGFB1->ACVRL1 (14 curation effort, 26 databases); querying CD274 (PD-L1) finds CD274->PDCD1 immune checkpoint interaction supported by 22 databases.

Status

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

Last probed

1d ago

Last success

1d ago

Last latency

87ms

Schema

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

{
  "properties": {
    "databases": {
      "description": "Filter by specific source database(s), comma-separated. Options include: CellPhoneDB, CellChatDB, CellTalkDB, connectomeDB2020, Ramilowski2015, Guide2Pharma, HPMR, iTALK, scConnect, Baccin2019, ICELLNET, LRdb, Cellinker. Default: all databases.",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum number of interactions to return. Default: no limit (returns all).",
      "type": [
        "integer",
        "null"
      ]
    },
    "organisms": {
      "description": "NCBI taxonomy ID for species filter. Default: 9606 (human). Options: 9606 (human), 10090 (mouse), 10116 (rat).",
      "type": [
        "integer",
        "null"
      ]
    },
    "partners": {
      "description": "Gene symbol(s) or UniProt ID(s) to query as interaction partners (either source or target). Comma-separated for multiple. Examples: 'TGFB1', 'CD274,PDCD1', 'EGFR', 'P01137'.",
      "type": [
        "string",
        "null"
      ]
    },
    "sources": {
      "description": "Gene symbol(s) or UniProt ID(s) for source (ligand) proteins only. Use instead of 'partners' to get outgoing interactions. Examples: 'TGFB1', 'WNT3A'.",
      "type": [
        "string",
        "null"
      ]
    },
    "targets": {
      "description": "Gene symbol(s) or UniProt ID(s) for target (receptor) proteins only. Use instead of 'partners' to get incoming interactions. Examples: 'EGFR', 'PDCD1'.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [],
  "type": "object"
}

Examples (1)

{}

Identifiers

Catalog ID

tu_OmniPath_get_ligand_receptor_interactions

Tool name

OmniPath_get_ligand_receptor_interactions

Added

2026-04-30 22:47Z

Tags

tooluniverse