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

{
  "entity_id": "org:/nvidia",
  "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": {
    "share_of_voice": 0.12,
    "theil_sen_slope": 0.15,
    "streak": 4,
    "coefficient_of_variation": 0.65,
    "current_week": 15,
    "prior_week": 10,
    "source_diversity": 12,
    "recency_score": 0.95,
    "mk_tau": 0.78,
    "mk_p_value": 0.002
  },
  "scale": "High",
  "direction": "Rising",
  "confidence": "Significant",
  "stability": "Steady",
  "priority": "High",
  "priority_reasoning": "High-scale entity with significant upward trend and steady coverage; reliable signal of growing dominance.",
  "content_type_mix": {"analysis": 90, "event": 66},
  "value_chain_distribution": {"Infrastructure": 80, "Foundation Models": 45},
  "market_force_distribution": {"Competitive Dynamics": 70, "Capital & Investment": 50},
  "related_entities": [
    {
      "entity_id": "org:/tsmc",
      "name": "TSMC",
      "type": "Organization",
      "co_occurrence_count": 28
    },
    {
      "entity_id": "org:/amd",
      "name": "AMD",
      "type": "Organization",
      "co_occurrence_count": 22
    }
  ]
}
​
name_or_id
string
required
Entity ID or URL-encoded display name (e.g., NVIDIA or org:/nvidia).
​
entity_id
string
Canonical entity ID (e.g., org:/nvidia).
​
display_name
string
Human-readable entity name.
​
type_primary
string
Entity type. See Entities for all 15 types.
​
signal_count
integer
Total signals mentioning this entity.
​
trend
object
Trend analytics across four dimensions.
​
scale
string
High, Medium, or Low.
​
direction
string
Rising, Stable, Declining, or New. Null if fewer than 8 mentions.
​
confidence
string
Significant or Insignificant.
​
stability
string
Volatile or Steady.
​
priority
string
High, Medium, Low, or Negligible.
​
priority_reasoning
string
Explanation of the priority assignment.
​
related_entities
array
Co-occurring entities ranked by frequency.
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/entities/NVIDIA"

{
  "entity_id": "org:/nvidia",
  "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": {
    "share_of_voice": 0.12,
    "theil_sen_slope": 0.15,
    "streak": 4,
    "coefficient_of_variation": 0.65,
    "current_week": 15,
    "prior_week": 10,
    "source_diversity": 12,
    "recency_score": 0.95,
    "mk_tau": 0.78,
    "mk_p_value": 0.002
  },
  "scale": "High",
  "direction": "Rising",
  "confidence": "Significant",
  "stability": "Steady",
  "priority": "High",
  "priority_reasoning": "High-scale entity with significant upward trend and steady coverage; reliable signal of growing dominance.",
  "content_type_mix": {"analysis": 90, "event": 66},
  "value_chain_distribution": {"Infrastructure": 80, "Foundation Models": 45},
  "market_force_distribution": {"Competitive Dynamics": 70, "Capital & Investment": 50},
  "related_entities": [
    {
      "entity_id": "org:/tsmc",
      "name": "TSMC",
      "type": "Organization",
      "co_occurrence_count": 28
    },
    {
      "entity_id": "org:/amd",
      "name": "AMD",
      "type": "Organization",
      "co_occurrence_count": 22
    }
  ]
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Include in every request as X-API-Key: gld_your_key_here.

Path Parameters

​
name_or_id
string
required

Response

Entity profile with related entities.

The response is of type Response Get Entity V1 Entities Name Or Id Get · object.