Overview
Signals
Entities
Search
System
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": ["Infrastructure"],
"market_force": ["Competitive Dynamics"]
},
"entities": [
{"entity_id": "org:/nvidia", "name": "NVIDIA", "type": "Organization"}
],
"verified_text_unit_count": 12
}
],
"has_more": true,
"next_cursor": "eyJwdWJsaXNoZWRfYXQiOiIyMDI2LTAxLTE1VDEwOjAwOjAwWiJ9"
}
Signals
List Signals
Retrieve a paginated list of signals. Without filters, returns the most recent signals.
GET
/
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": ["Infrastructure"],
"market_force": ["Competitive Dynamics"]
},
"entities": [
{"entity_id": "org:/nvidia", "name": "NVIDIA", "type": "Organization"}
],
"verified_text_unit_count": 12
}
],
"has_more": true,
"next_cursor": "eyJwdWJsaXNoZWRfYXQiOiIyMDI2LTAxLTE1VDEwOjAwOjAwWiJ9"
}
Filter by canonical entity ID or exact entity name (case-insensitive).
Filter by theme label (e.g., “Infrastructure”).
Full-text keyword search.
Filter by content type:
analysis or event.ISO 8601 date — only signals published after this date.
ISO 8601 date — only signals published before this date.
Results per page (1–50).
Opaque pagination cursor from a previous response.
All filters are optional. Without filters, returns the most recent signals sorted by date.
List of signal objects.
Show Signal object
Show Signal object
Unique signal identifier.
Source article title.
Source article URL.
ISO 8601 publication date.
Source domain (e.g.,
example.com).analysis or event.Article author, if available.
Thesis text (analysis) or summary text (event).
Theme tags with
value_chain and market_force arrays.Entities mentioned in this signal.
Count of verified text units in decomposition.
Whether more results exist.
Cursor for the next page. Pass as
cursor parameter.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": ["Infrastructure"],
"market_force": ["Competitive Dynamics"]
},
"entities": [
{"entity_id": "org:/nvidia", "name": "NVIDIA", "type": "Organization"}
],
"verified_text_unit_count": 12
}
],
"has_more": true,
"next_cursor": "eyJwdWJsaXNoZWRfYXQiOiIyMDI2LTAxLTE1VDEwOjAwOjAwWiJ9"
}
Authorizations
API key for authentication. Include in every request as X-API-Key: gld_your_key_here.
Query Parameters
Filter by canonical entity ID or exact entity name (case-insensitive).
Filter by theme label.
Full-text keyword search.
Filter by content type: 'analysis' or 'event'.
ISO 8601 date — only signals published after this date.
ISO 8601 date — only signals published before this date.
Required range:
1 <= x <= 50Response
Successful Response
⌘I