List Entities - Gildea API

# List organizations
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/entities?type=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"

import requests

headers = {"X-API-Key": "gld_your_key"}

# List organizations
resp = requests.get(
    "https://api.gildea.ai/v1/entities",
    headers=headers,
    params={"type": "organization", "limit": 10},
)
entities = resp.json()

# Find rising entities with statistical significance
resp = requests.get(
    "https://api.gildea.ai/v1/entities",
    headers=headers,
    params={"direction": "Rising", "confidence": "Significant", "sort": "trend", "limit": 10},
)
rising = resp.json()

const headers = { "X-API-Key": "gld_your_key" };

// List organizations
const resp = await fetch(
  "https://api.gildea.ai/v1/entities?type=organization&limit=10",
  { headers }
);
const entities = await resp.json();

// Find rising entities with statistical significance
const rising = await fetch(
  "https://api.gildea.ai/v1/entities?direction=Rising&confidence=Significant&sort=trend&limit=10",
  { headers }
).then(r => r.json());

{
  "entities": [
    {
      "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}
    }
  ],
  "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=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"

import requests

headers = {"X-API-Key": "gld_your_key"}

# List organizations
resp = requests.get(
    "https://api.gildea.ai/v1/entities",
    headers=headers,
    params={"type": "organization", "limit": 10},
)
entities = resp.json()

# Find rising entities with statistical significance
resp = requests.get(
    "https://api.gildea.ai/v1/entities",
    headers=headers,
    params={"direction": "Rising", "confidence": "Significant", "sort": "trend", "limit": 10},
)
rising = resp.json()

const headers = { "X-API-Key": "gld_your_key" };

// List organizations
const resp = await fetch(
  "https://api.gildea.ai/v1/entities?type=organization&limit=10",
  { headers }
);
const entities = await resp.json();

// Find rising entities with statistical significance
const rising = await fetch(
  "https://api.gildea.ai/v1/entities?direction=Rising&confidence=Significant&sort=trend&limit=10",
  { headers }
).then(r => r.json());

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

theme

string

Filter by theme label (see Themes for valid labels). An unknown label returns 404, not an empty list.

type

string

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

name

string

Filter entities by name (matches names containing this text). For natural-language semantic retrieval, use GET /v1/search.

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.

entities

array

List of entity objects.

Show Entity object

entity_id

string

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

name

string

Human-readable entity name.

type

string

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

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, "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=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"

import requests

headers = {"X-API-Key": "gld_your_key"}

# List organizations
resp = requests.get(
    "https://api.gildea.ai/v1/entities",
    headers=headers,
    params={"type": "organization", "limit": 10},
)
entities = resp.json()

# Find rising entities with statistical significance
resp = requests.get(
    "https://api.gildea.ai/v1/entities",
    headers=headers,
    params={"direction": "Rising", "confidence": "Significant", "sort": "trend", "limit": 10},
)
rising = resp.json()

const headers = { "X-API-Key": "gld_your_key" };

// List organizations
const resp = await fetch(
  "https://api.gildea.ai/v1/entities?type=organization&limit=10",
  { headers }
);
const entities = await resp.json();

// Find rising entities with statistical significance
const rising = await fetch(
  "https://api.gildea.ai/v1/entities?direction=Rising&confidence=Significant&sort=trend&limit=10",
  { headers }
).then(r => r.json());

{
  "entities": [
    {
      "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}
    }
  ],
  "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 (see GET /v1/themes for valid labels). An unknown label returns 404, not an empty list.

type

enum<string> | null

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

Available options:

organization,

person,

model,

hardware,

location,

event,

regulation_policy,

other

name

string | null

Filter entities by name (matches names containing this text). For natural-language semantic retrieval, use GET /v1/search.

sort

enum<string>

default:signal_count

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

Available options:

signal_count,

first_seen,

trend

direction

enum<string> | null

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

Available options:

Rising,

Stable,

Declining,

New

confidence

enum<string> | null

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

Available options:

Significant,

Insignificant

stability

enum<string> | null

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

Available options:

Volatile,

Steady

scale

enum<string> | null

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

Available options:

Large,

Medium,

Small

notability

enum<string> | null

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

Available options:

High,

Medium,

Low,

Negligible

cursor

string | null

Opaque cursor from a previous response's next_cursor. Omit for the first page.

limit

integer

default:25

Page size (1–50, default 25). These endpoints are cursor-paginated: pass the returned next_cursor as cursor to walk the full result set. (Relevance-ranked GET /v1/search is not paginated — its limit is the total top-N returned, not a page size.)

Required range: 1 <= x <= 50

Response

Successful Response

entities

EntityProfile · object[]

required

Entity profiles matching the query.

Show child attributes

has_more

boolean

required

Whether more results are available beyond this page.

next_cursor

string | null

Cursor for the next page; null when has_more is false.

Entities

Get Entity