Skip to main content
GET
https://api.gildea.ai
/
v1
/
entities
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/entities?type_primary=Organization&limit=10"

{
  "data": [
    {
      "entity_id": "ent_01JABCDEF123456789",
      "display_name": "NVIDIA",
      "type_primary": "Organization",
      "wikipedia_url": "https://en.wikipedia.org/wiki/Nvidia",
      "signal_count": 156,
      "first_seen": "2025-10-03T00:00:00Z",
      "last_seen": "2026-02-14T00:00:00Z",
      "trend": {
        "momentum_wow": 0.50,
        "momentum_4w": 0.25,
        "acceleration": 0.10,
        "z_score": 2.1,
        "persistence": 0.83,
        "share_of_voice": 0.12,
        "share_of_voice_history": [0.08, 0.07, 0.09, 0.12],
        "streak": 4,
        "current_week": 15,
        "prior_week": 10
      },
      "content_type_mix": {"analysis": 90, "event": 66},
      "value_chain_distribution": {"AI Infrastructure": 80, "Foundation Models": 45},
      "market_force_distribution": {"Competitive Dynamics": 70, "Supply & Demand": 50}
    }
  ],
  "has_more": true,
  "next_cursor": "eyJzaWduYWxfY291bnQiOjE1Nn0="
}
​
theme
string
Filter by theme label.
​
type_primary
string
Filter by entity type: Organization, Person, Product.
​
q
string
Search entity names.
​
sort
string
default:"signal_count"
Sort field: signal_count, last_seen, momentum_wow.
​
limit
integer
default:"25"
Results per page (1–50).
​
cursor
string
Opaque pagination cursor from a previous response.
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/entities?type_primary=Organization&limit=10"

{
  "data": [
    {
      "entity_id": "ent_01JABCDEF123456789",
      "display_name": "NVIDIA",
      "type_primary": "Organization",
      "wikipedia_url": "https://en.wikipedia.org/wiki/Nvidia",
      "signal_count": 156,
      "first_seen": "2025-10-03T00:00:00Z",
      "last_seen": "2026-02-14T00:00:00Z",
      "trend": {
        "momentum_wow": 0.50,
        "momentum_4w": 0.25,
        "acceleration": 0.10,
        "z_score": 2.1,
        "persistence": 0.83,
        "share_of_voice": 0.12,
        "share_of_voice_history": [0.08, 0.07, 0.09, 0.12],
        "streak": 4,
        "current_week": 15,
        "prior_week": 10
      },
      "content_type_mix": {"analysis": 90, "event": 66},
      "value_chain_distribution": {"AI Infrastructure": 80, "Foundation Models": 45},
      "market_force_distribution": {"Competitive Dynamics": 70, "Supply & Demand": 50}
    }
  ],
  "has_more": true,
  "next_cursor": "eyJzaWduYWxfY291bnQiOjE1Nn0="
}