Skip to main content
GET
https://api.gildea.ai
/
v1
/
entities
/
{name_or_id}
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/entities/NVIDIA"

{
  "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},
  "related_entities": [
    {
      "entity_id": "ent_01J...",
      "name": "TSMC",
      "type": "Organization",
      "co_occurrence_count": 28
    },
    {
      "entity_id": "ent_01J...",
      "name": "AMD",
      "type": "Organization",
      "co_occurrence_count": 22
    }
  ]
}
​
name_or_id
string
required
Entity ID or URL-encoded display name (e.g., NVIDIA or ent_01JABCDEF123456789).
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/entities/NVIDIA"

{
  "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},
  "related_entities": [
    {
      "entity_id": "ent_01J...",
      "name": "TSMC",
      "type": "Organization",
      "co_occurrence_count": 28
    },
    {
      "entity_id": "ent_01J...",
      "name": "AMD",
      "type": "Organization",
      "co_occurrence_count": 22
    }
  ]
}