v1

latestOpenAPI 3.0.32026-07-226744340.8 KB

Entities

Search Entities

Discover linked people and organizations that connect to Stories and Events. Entity taxonomy filters operate on linked Story/Event evidence.

get/api/v2/entities

Query parameters

searchstring

Entity name or phrase to search for. Aliases q, query, keyword, and name are accepted (first non-empty wins); for high-recall cross-source discovery see GET /api/v2/search. Resolved filters are echoed in the response applied_filters block, with unrecognized params under applied_filters.ignored.

type'person' | 'organization'

Optional entity type filter.

date_startstring date

Example:2026-04-11

Inclusive start date in YYYY-MM-DD, matched against the event or story date. Alias start_date is accepted for compatibility. Omit dates for the default recent window; explicit windows may not exceed 30 days.

date_endstring date

Example:2026-04-17

Inclusive end date in YYYY-MM-DD, matched against the event or story date. Alias end_date is accepted for compatibility. Omit dates for the default recent window; explicit windows may not exceed 30 days.

event_family'conflict' | 'cameoplus'

Deprecated legacy filter. Prefer category, which implies Conflict vs CAMEO+. Still accepted for backwards compatibility.

categorystring

Example:Battles

Stable linked Event product category. Use a Conflict event type such as Battles, Protests, or Explosions/Remote violence, or one CAMEO+ domain such as POLITICAL, INFRASTRUCTURE, or CRIME; values may be single or comma-separated. On Story endpoints this filters linked Event evidence. Use story_category only for legacy Story-cluster categories such as conflict_security. Full list: Taxonomy & Codes.

subcategorystring

Example:Armed clash

More specific linked Event subtype, CAMEO+ event description, or CAMEO+ code. Requires parent category and must belong to at least one selected category. For Conflict categories, use sub-event types such as Armed clash, Peaceful protest, or Air/drone strike. Validation errors include accepted_values, nearest_values when practical, and a corrected example. Full list: Taxonomy & Codes.

Deprecated legacy CAMEO+ domain enum. Prefer category/categories for new integrations; retained for backwards compatibility. Full list: Taxonomy & Codes.

has_fatalitiesboolean

Example:true

Set true for fatality monitoring. v2 intentionally exposes only this boolean fatality filter.

civilian_targetingboolean

Filter Conflict-linked evidence by ACLED civilian_targeting. true keeps records where civilians are the primary target; false excludes those records.

sort'significance' | 'recent'

significance is the default analyst ranking. Use recent when freshness matters more than importance.

limitinteger

Example:25

Number of records to return.

cursorstring

Pagination cursor from pagination.next_cursor.

Response

Entity cards

successtrue