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": "gld:/a1b2c3d4e5f6",
  "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": "Large",
  "direction": "Rising",
  "confidence": "Significant",
  "stability": "Steady",
  "notability": "High",
  "notability_reasoning": "Large-scale entity with confirmed upward trend and consistent coverage; notable upward shift reliably gaining share.",
  "content_type_mix": {"analysis": 90, "factual_event": 66},
  "value_chain_distribution": {"Infrastructure": 80, "Foundation Models": 45},
  "market_force_distribution": {"Competitive Dynamics": 70, "Capital & Investment": 50},
  "related_entities": [
    {
      "entity_id": "gld:/b2c3d4e5f6a7",
      "name": "TSMC",
      "type": "organization",
      "co_occurrence_count": 28
    },
    {
      "entity_id": "gld:/c3d4e5f6a7b8",
      "name": "AMD",
      "type": "organization",
      "co_occurrence_count": 22
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.gildea.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
name_or_id
string
required
Public entity ID (gld:/…) or URL-encoded display name (e.g., NVIDIA or gld:/a1b2c3d4e5f6). Internal prefix-encoded IDs are rejected with a 400.
​
entity_id
string
Stable, opaque public entity ID (e.g., gld:/a1b2c3d4e5f6).
​
display_name
string
Human-readable entity name.
​
type_primary
string
Entity type. See Entities for all 8 types.
​
signal_count
integer
Total signals mentioning this entity.
​
trend
object
Trend analytics across four dimensions.
​
scale
string
Large, Medium, or Small.
​
direction
string
Rising, Stable, Declining, or New. Null if fewer than 8 mentions.
​
confidence
string
Significant or Insignificant.
​
stability
string
Volatile or Steady.
​
notability
string
High, Medium, Low, or Negligible. How much this entity warrants attention right now.
​
notability_reasoning
string
Explanation of the notability assignment.
​
content_type_mix
object
Signal count by content type (e.g., {"analysis": 90, "factual_event": 66}).
​
value_chain_distribution
object
Signal count by value chain theme.
​
market_force_distribution
object
Signal count by market force theme.
​
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": "gld:/a1b2c3d4e5f6",
  "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": "Large",
  "direction": "Rising",
  "confidence": "Significant",
  "stability": "Steady",
  "notability": "High",
  "notability_reasoning": "Large-scale entity with confirmed upward trend and consistent coverage; notable upward shift reliably gaining share.",
  "content_type_mix": {"analysis": 90, "factual_event": 66},
  "value_chain_distribution": {"Infrastructure": 80, "Foundation Models": 45},
  "market_force_distribution": {"Competitive Dynamics": 70, "Capital & Investment": 50},
  "related_entities": [
    {
      "entity_id": "gld:/b2c3d4e5f6a7",
      "name": "TSMC",
      "type": "organization",
      "co_occurrence_count": 28
    },
    {
      "entity_id": "gld:/c3d4e5f6a7b8",
      "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.