Skip to main content
GET
https://api.gildea.ai
/
v1
/
signals
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/signals?entity=NVIDIA&limit=5"

{
  "data": [
    {
      "signal_id": "sig_01JABCDEF123456789",
      "title": "NVIDIA H200 Shipments Surge as Supply Eases",
      "url": "https://example.com/article",
      "published_at": "2026-01-15T10:00:00Z",
      "registrable_domain": "example.com",
      "content_type": "analysis",
      "author": "John Smith",
      "decomposition_text": "NVIDIA's H200 shipments increased significantly in Q4 as supply chain constraints eased.",
      "tags": {
        "value_chain": ["AI Infrastructure"],
        "market_force": ["Supply & Demand"]
      },
      "entities": [
        {"entity_id": "ent_01J...", "name": "NVIDIA", "type": "Organization"}
      ],
      "verified_text_unit_count": 12
    }
  ],
  "has_more": true,
  "next_cursor": "eyJwdWJsaXNoZWRfYXQiOiIyMDI2LTAxLTE1VDEwOjAwOjAwWiJ9"
}
​
entity
string
Filter by entity ID or name.
​
theme
string
Filter by theme label (e.g., “AI Infrastructure”).
​
q
string
Full-text keyword search.
​
content_type
string
Filter by content type: analysis or event.
​
published_after
string
ISO 8601 date — only signals published after this date.
​
published_before
string
ISO 8601 date — only signals published before this date.
​
limit
integer
default:"25"
Results per page (1–50).
​
cursor
string
Opaque pagination cursor from a previous response.
At least one of entity, theme, or q is required. Requests without any filter return 400.
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/signals?entity=NVIDIA&limit=5"

{
  "data": [
    {
      "signal_id": "sig_01JABCDEF123456789",
      "title": "NVIDIA H200 Shipments Surge as Supply Eases",
      "url": "https://example.com/article",
      "published_at": "2026-01-15T10:00:00Z",
      "registrable_domain": "example.com",
      "content_type": "analysis",
      "author": "John Smith",
      "decomposition_text": "NVIDIA's H200 shipments increased significantly in Q4 as supply chain constraints eased.",
      "tags": {
        "value_chain": ["AI Infrastructure"],
        "market_force": ["Supply & Demand"]
      },
      "entities": [
        {"entity_id": "ent_01J...", "name": "NVIDIA", "type": "Organization"}
      ],
      "verified_text_unit_count": 12
    }
  ],
  "has_more": true,
  "next_cursor": "eyJwdWJsaXNoZWRfYXQiOiIyMDI2LTAxLTE1VDEwOjAwOjAwWiJ9"
}