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

{
  "data": [
    {
      "entity_id": "ent_01J...",
      "display_name": "DeepSeek",
      "type_primary": "Organization",
      "signal_count": 34,
      "first_seen": "2025-12-10T00:00:00Z",
      "last_seen": "2026-02-14T00:00:00Z",
      "trend": {
        "momentum_wow": 1.20,
        "momentum_4w": 0.85,
        "acceleration": 0.35,
        "z_score": 3.4,
        "persistence": 0.67,
        "share_of_voice": 0.08,
        "share_of_voice_history": [0.02, 0.03, 0.05, 0.08],
        "streak": 4,
        "current_week": 12,
        "prior_week": 5
      },
      "content_type_mix": {"analysis": 20, "event": 14},
      "value_chain_distribution": {"Foundation Models": 28},
      "market_force_distribution": {"Competitive Dynamics": 22}
    }
  ]
}
​
mode
string
required
Ranking mode: rising, hot, consistent, new.
​
theme
string
Filter by theme label.
​
type_primary
string
Filter by entity type: Organization, Person, Product.
​
limit
integer
default:"25"
Max entities to return (1–50).
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/entities/trending?mode=rising&limit=10"

{
  "data": [
    {
      "entity_id": "ent_01J...",
      "display_name": "DeepSeek",
      "type_primary": "Organization",
      "signal_count": 34,
      "first_seen": "2025-12-10T00:00:00Z",
      "last_seen": "2026-02-14T00:00:00Z",
      "trend": {
        "momentum_wow": 1.20,
        "momentum_4w": 0.85,
        "acceleration": 0.35,
        "z_score": 3.4,
        "persistence": 0.67,
        "share_of_voice": 0.08,
        "share_of_voice_history": [0.02, 0.03, 0.05, 0.08],
        "streak": 4,
        "current_week": 12,
        "prior_week": 5
      },
      "content_type_mix": {"analysis": 20, "event": 14},
      "value_chain_distribution": {"Foundation Models": 28},
      "market_force_distribution": {"Competitive Dynamics": 22}
    }
  ]
}