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"

import requests

entity = requests.get(
    "https://api.gildea.ai/v1/entities/NVIDIA",
    headers={"X-API-Key": "gld_your_key"},
).json()

const resp = await fetch(
  "https://api.gildea.ai/v1/entities/NVIDIA",
  { headers: { "X-API-Key": "gld_your_key" } }
);
const entity = await resp.json();

{
  "entity_id": "gld:/a1b2c3d4e5f6",
  "name": "NVIDIA",
  "type": "organization",
  "signal_count": 156,
  "first_seen": "2025-10-03T00:00:00Z",
  "last_seen": "2026-02-14T00:00:00Z",
  "trend": {
    "share_of_voice": 0.12,
    "streak": 4,
    "current_week": 15,
    "prior_week": 10,
    "source_diversity": 12
  },
  "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, "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
    }
  ]
}

{
  "error": {
    "code": "not_found",
    "message": "Entity 'nonexistent' not found",
    "status": 404
  }
}
​
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).
​
name
string
Human-readable entity name.
​
type
string
Entity type. See Entities for all 8 types.
​
signal_count
integer
Total signals mentioning this entity.
​
trend
object
Trend analytics.
​
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, "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"

import requests

entity = requests.get(
    "https://api.gildea.ai/v1/entities/NVIDIA",
    headers={"X-API-Key": "gld_your_key"},
).json()

const resp = await fetch(
  "https://api.gildea.ai/v1/entities/NVIDIA",
  { headers: { "X-API-Key": "gld_your_key" } }
);
const entity = await resp.json();

{
  "entity_id": "gld:/a1b2c3d4e5f6",
  "name": "NVIDIA",
  "type": "organization",
  "signal_count": 156,
  "first_seen": "2025-10-03T00:00:00Z",
  "last_seen": "2026-02-14T00:00:00Z",
  "trend": {
    "share_of_voice": 0.12,
    "streak": 4,
    "current_week": 15,
    "prior_week": 10,
    "source_diversity": 12
  },
  "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, "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
    }
  ]
}

{
  "error": {
    "code": "not_found",
    "message": "Entity 'nonexistent' not found",
    "status": 404
  }
}

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.

​
entity_id
string
required

Stable public entity ID.

Example:

"gld:/a1b2c3d4e5f6"

​
name
string
required

Canonical display name.

Example:

"NVIDIA"

​
type
string
required

Entity type.

Example:

"organization"

​
signal_count
integer
required

Total signals mentioning this entity.

​
trend
EntityTrend · object
required

Legible trend counts. Raw estimators (Theil-Sen, Mann-Kendall, etc.) are not exposed — the interpretation fields (scale/direction/...) summarize them.

​
first_seen
string | null

Earliest signal mention (ISO date).

​
last_seen
string | null

Most recent signal mention (ISO date).

​
content_type_mix
Content Type Mix · object
​
value_chain_distribution
Value Chain Distribution · object
​
market_force_distribution
Market Force Distribution · object
​
scale
enum<string> | null

Interpretation: relative scale.

Available options:
Large,
Medium,
Small
​
direction
enum<string> | null

Interpretation: trend direction.

Available options:
Rising,
Stable,
Declining,
New
​
confidence
enum<string> | null

Interpretation: statistical confidence.

Available options:
Significant,
Insignificant
​
stability
enum<string> | null

Interpretation: signal stability.

Available options:
Volatile,
Steady
​
notability
enum<string> | null

Interpretation: foreground vs background.

Available options:
High,
Medium,
Low,
Negligible
​
notability_reasoning
string | null
​
related_entities
RelatedEntity · object[]