---
title: "Get Entity"
method: GET
path: "/api/v2/entities/{entity_id}"
tags: ["Entities"]
---

# Get Entity

`GET /api/v2/entities/{entity_id}`

Fetch one Entity profile with linked Stories and Events. Admin/internal callers can set include_tone=true to join cached Entity Tone coverage; when no tone score exists, the response returns tone_status=not_available rather than hiding the entity or treating missing tone as neutral.

## Path parameters

- `entity_id` string, required

## Query parameters

- `date_start` string, date
- `date_end` string, date
- `limit` integer
- `include_images` boolean
- `include_tone` boolean
- `include_registry` boolean

## Response `200`

Entity detail

- object
  - `success` true
  - `data` EntityCard — One canonical Entity, deduplicated by Wikipedia URL across raw_name variants on the public list surface. Low-quality matches (disambiguation pages, common nouns, extraction artifacts) are filtered server-side. GDELT-derived per-article metrics (mention_count, avg_salience) are not part of the public contract — story_count, article_count, and event_count are the canonical activity signals. Entity detail can include cached Entity Tone metadata when include_tone=true; missing tone is reported as not_available, not neutral.
    - `id` string
    - `url` string, uri, nullable
    - `name` string — Canonical display name — the most-mentioned raw_name variant pointing at this Wikipedia URL.
    - `type` 'person' | 'organization', nullable
    - `wikipedia_url` string, uri, nullable
    - `latest_date` string, date, nullable — Most recent date the Entity appeared in a Story or Event within the requested window.
    - `image_url` string, uri, nullable — Best-effort Wikipedia thumbnail URL for UI rendering.
    - `avatar_url` string, uri, nullable — Best-effort compact avatar URL, usually the same as image_url.
    - `wikipedia` object, nullable — Compact Wikipedia enrichment when available, including thumbnail_url, description, page_url, and summary on detail responses.
    - `metrics` object — Aggregated activity counts over the requested window, summed across all raw_name variants that map to this Wikipedia URL.
      - `article_count` integer — Total articles in matched Stories and Events mentioning the entity.
      - `story_count` integer — Distinct GDELT Cloud Stories (cluster_ids) the entity appeared in.
      - `event_count` integer — Distinct coded Events (Conflict + CAMEO+) linked to the entity.
    - `story_refs` object[]
    - `event_refs` object[]
    - `entity_tone` object, nullable — Present on Entity detail when include_tone=true and the caller is allowed to access preview tone metadata. tone_status may be scored, reviewable, partial, or not_available.
      - `tone_status` 'scored' | 'reviewable' | 'partial' | 'not_available'
      - `coverage` object
      - `latest_series` object[]
      - `analytics_url` string, nullable
      - `methodology` object

## Other responses

- `404` — Resource not found

---

[API](https://skmtc.net/gdeltcloud/apis/gdelt-cloud-api-v2.md) · [All operations](https://skmtc.net/gdeltcloud/apis/gdelt-cloud-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gdeltcloud/gdelt-cloud-api-v2/revisions/01aaa6255180/schema)