List Entities - Gildea API

# List organizations
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/entities?type_primary=organization&limit=10"

# Find rising entities with statistical significance
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/entities?direction=Rising&confidence=Significant&sort=trend&limit=10"

{
  "data": [
    {
      "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}
    }
  ],
  "has_more": true,
  "next_cursor": "eyJzaWduYWxfY291bnQiOjE1Nn0="
}

GET

entities

# List organizations
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/entities?type_primary=organization&limit=10"

# Find rising entities with statistical significance
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/entities?direction=Rising&confidence=Significant&sort=trend&limit=10"

{
  "data": [
    {
      "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}
    }
  ],
  "has_more": true,
  "next_cursor": "eyJzaWduYWxfY291bnQiOjE1Nn0="
}

theme

string

Filter by theme label.

type_primary

string

Filter by entity type (e.g., organization, person, model, hardware, other). See Entities for all 8 types.

string

Search entity names.

sort

string

default:"signal_count"

Sort field: signal_count, first_seen, trend.

direction

string

Filter by trend direction: Rising, Stable, Declining, New.

confidence

string

Filter by trend significance: Significant, Insignificant.

stability

string

Filter by coverage consistency: Volatile, Steady.

scale

string

Filter by share-of-voice scale: Large, Medium, Small.

notability

string

Filter by notability: High, Medium, Low, Negligible.

limit

integer

default:"25"

Results per page (1–50).

cursor

string

Opaque pagination cursor from a previous response.

data

array

List of entity objects.

Show Entity object

entity_id

string

Stable, opaque public entity ID (e.g., gld:/a1b2c3d4e5f6).

display_name

string

Human-readable entity name.

type_primary

string

Entity type (e.g., organization, model). See Entities for all 8 types.

wikipedia_url

string

Wikipedia link, if available.

signal_count

integer

Total signals mentioning this entity.

first_seen

string

ISO 8601 date of first mention.

last_seen

string

ISO 8601 date of most recent mention.

trend

object

Trend analytics. See Entities for field descriptions.

scale

string

Large, Medium, or Small.

direction

string

Rising, Stable, Declining, or New. Null if fewer than 8 mentions.

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 (e.g., {"Infrastructure": 80}).

market_force_distribution

object

Signal count by market force theme (e.g., {"Competitive Dynamics": 70}).

has_more

boolean

Whether more results exist.

next_cursor

string

Cursor for the next page.

# List organizations
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/entities?type_primary=organization&limit=10"

# Find rising entities with statistical significance
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/entities?direction=Rising&confidence=Significant&sort=trend&limit=10"

{
  "data": [
    {
      "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}
    }
  ],
  "has_more": true,
  "next_cursor": "eyJzaWduYWxfY291bnQiOjE1Nn0="
}

Authorizations

X-API-Key

string

header

required

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

Query Parameters

theme

string | null

Filter by theme label.

type_primary

string | null

Filter by entity type: 'organization', 'person', 'model', 'hardware', 'location', 'event', 'regulation_policy', 'other'.

string | null

Search entity names.

sort

string

default:signal_count

Sort field: 'signal_count', 'first_seen', 'trend'.

direction

string | null

Filter by direction: 'Rising', 'Stable', 'Declining', 'New'.

confidence

string | null

Filter by confidence: 'Significant', 'Insignificant'.

stability

string | null

Filter by stability: 'Volatile', 'Steady'.

scale

string | null

Filter by scale: 'Large', 'Medium', 'Small'.

notability

string | null

Filter by notability: 'High', 'Medium', 'Low', 'Negligible'.

cursor

string | null

limit

integer

default:25

Required range: 1 <= x <= 50

Response

Successful Response

has_more

boolean

required

Whether more results are available beyond this page.

data

EntityProfile · object[]

required

List of entity profiles.

Show child attributes

next_cursor

string | null

Opaque cursor to pass as cursor query param for the next page. Null when has_more is false.

Get Signal

Get Entity

Documentation Index

Authorizations

Query Parameters

Response