Other endpoints
Search ICDB Video Component
Search analyzed ICDB video records from the ICDB Video Component using keywords, entities, countries, date ranges and other filters. Results include structured metadata and summaries derived from IntelCenter analysis of entity-generated video, audio, transcripts and related context. Best for precise searches using known terms or filters.
query Parameters
searchFull text search term.
countryFilter by primary country.
entityFilter by associated entity.
pagePage number.
per_pageNumber of results per page.
sortSort order for results.
date_fromReturn results on or after this date.
date_toReturn results on or before this date.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Search ICDB Video Component › Responses
Search results
itemsReceivedcurPagenextPageprevPageoffsetperPageitemsTotalpageTotalGet ICDB Video Detail by Component ID
Retrieve the full intelligence record for a specific ICDB video using its human-facing numeric Component ID. Database and Component are established by this route; use the UUID detail route when the record UUID is known. Existing ICDB entity and access-tag restrictions remain authoritative.
path Parameters
component_idHuman-facing numeric ICDB Video Component ID.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Get ICDB Video Detail by Component ID › Responses
Video details or a not-found response when the record is absent or outside the authorized scope.
uuidprimary_idprimary_dateentityprimary_countrysecond_geo_layerdominant_latdominant_longtitlesummaryreporttranscriptGet ICDB Video Geo Manifest
Retrieve a lightweight, cursor-paginated manifest of authorized ICDB video records with valid map coordinates. Results use deterministic newest-first ordering, and continuation remains stable during live ingestion. Full records remain available through the existing detail endpoint.
query Parameters
searchFull-text search term.
countryFilter by primary country.
entityFilter by associated entity.
date_fromReturn results on or after this date.
date_toReturn results on or before this date.
cursorOpaque next_cursor from the preceding response. Reuse it only with the exact same dataset, component, filters, page size, and format. If it is rejected, restart the request without a cursor.
per_pageAuthorized source records examined per cursor request. Invalid coordinates are excluded from returned items.
formatReturn the manifest as JSON or GeoJSON.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Get ICDB Video Geo Manifest › Responses
Lightweight authorized Geo manifest cursor page.
statusdatabasecomponentitems_returneditems_returned_totalCumulative valid map records returned in this cursor traversal.
source_items_scannedAuthorized source records examined for this response.
source_items_scanned_totalCumulative authorized source records examined in this traversal.
pagination_modenext_cursorOpaque continuation bound to this dataset and filter snapshot. Repeat the same filters with this cursor.
pageOne-based response ordinal for this cursor traversal.
per_pagemappable_matchesValid map records encountered. Null until an uncapped traversal completes.
completeresult_limitMaximum authorized source-result window available to this consumer.
limit_reachedsort_orderDeterministic newest-first ordering. Component ID descending resolves records with the same primary date.
next_pageprevious_pagetotal_matchesReserved exact authorized match count. Null in the count-free Phase 1.5 contract.
Get ICDB Video Detail Record
Retrieve the full intelligence record for a specific ICDB video, including metadata, transcript, summary, and IntelCenter analysis. Use this after finding a relevant video record to review its detailed content.
path Parameters
uuidHeaders
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Get ICDB Video Detail Record › Responses
Video details
uuidprimary_idprimary_dateentityprimary_countrysecond_geo_layerdominant_latdominant_longtitlesummaryreporttranscriptICDB Video Player
Retrieve a secure streaming player URL and related metadata for a specific ICDB video. Use this when you need to play or present the original video content associated with an intelligence record.
path Parameters
uuidHeaders
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
ICDB Video Player › Responses
Player information
statusembed_urlexpiresuuidtitleSearch ICD Video Component
Search analyzed ICD video records from the ICD Video Component using keywords, entities, countries, date ranges and other filters. Results include structured metadata and summaries derived from IntelCenter analysis of entity-generated video, audio, transcripts and related context. Best for precise searches using known terms or filters.
query Parameters
searchFull text search term.
countryFilter by primary country.
entityFilter by associated entity.
pagePage number.
per_pageNumber of results per page.
sortSort order for results.
date_fromReturn results on or after this date.
date_toReturn results on or before this date.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Search ICD Video Component › Responses
Search results
itemsReceivedcurPagenextPageprevPageoffsetperPageitemsTotalpageTotalGet ICD Video Detail by Component ID
Retrieve the full intelligence record for a specific ICD video using its human-facing numeric Component ID. Database and Component are established by this route; use the UUID detail route when the record UUID is known.
path Parameters
component_idHuman-facing numeric ICD Video Component ID.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Get ICD Video Detail by Component ID › Responses
Video details
uuidprimary_idprimary_dateentityprimary_countrysecond_geo_layerdominant_latdominant_longtitlesummaryreporttranscriptGet ICD Video Geo Manifest
Retrieve a lightweight, cursor-paginated manifest of authorized ICD video records with valid map coordinates. Results use deterministic newest-first ordering, and continuation remains stable during live ingestion. Full records remain available through the existing detail endpoint.
query Parameters
searchFull-text search term.
countryFilter by primary country.
entityFilter by associated entity.
date_fromReturn results on or after this date.
date_toReturn results on or before this date.
cursorOpaque next_cursor from the preceding response. Reuse it only with the exact same dataset, component, filters, page size, and format. If it is rejected, restart the request without a cursor.
per_pageAuthorized source records examined per cursor request. Invalid coordinates are excluded from returned items.
formatReturn the manifest as JSON or GeoJSON.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Get ICD Video Geo Manifest › Responses
Lightweight authorized Geo manifest cursor page.
statusdatabasecomponentitems_returneditems_returned_totalCumulative valid map records returned in this cursor traversal.
source_items_scannedAuthorized source records examined for this response.
source_items_scanned_totalCumulative authorized source records examined in this traversal.
pagination_modenext_cursorOpaque continuation bound to this dataset and filter snapshot. Repeat the same filters with this cursor.
pageOne-based response ordinal for this cursor traversal.
per_pagemappable_matchesValid map records encountered. Null until an uncapped traversal completes.
completeresult_limitMaximum authorized source-result window available to this consumer.
limit_reachedsort_orderDeterministic newest-first ordering. Component ID descending resolves records with the same primary date.
next_pageprevious_pagetotal_matchesReserved exact authorized match count. Null in the count-free Phase 1.5 contract.
Get ICD Video Detail Record
Retrieve the full intelligence record for a specific ICD video, including metadata, transcript, summary, and IntelCenter analysis. Use this after finding a relevant video record to review its detailed content.
path Parameters
uuidHeaders
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Get ICD Video Detail Record › Responses
Video details
uuidprimary_idprimary_dateentityprimary_countrysecond_geo_layerdominant_latdominant_longtitlesummaryreporttranscriptICD Video Player
Retrieve a secure streaming player URL and related metadata for a specific ICD video. Use this when you need to play or present the original video content associated with an intelligence record.
path Parameters
uuidHeaders
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
ICD Video Player › Responses
Player information
statusembed_urlexpiresuuidtitleSearch ICD Image Component
Search analyzed ICD image records using keywords, entities, countries, date ranges and other filters. Results include structured metadata and summaries derived from IntelCenter visual and contextual analysis of entity-generated image content. Best for precise searches using known terms or filters.
query Parameters
searchFull text search term.
countryFilter by primary country.
entityFilter by associated entity.
pagePage number.
per_pageNumber of results per page.
sortSort order for results.
date_fromReturn results on or after this date.
date_toReturn results on or before this date.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Search ICD Image Component › Responses
Search results
itemsReceivedcurPagenextPageprevPageoffsetperPageitemsTotalpageTotalGet ICD Image Detail by Component ID
Retrieve the full intelligence record for a specific ICD image using its human-facing numeric Component ID. Database and Component are established by this route; use the UUID detail route when the record UUID is known.
path Parameters
component_idHuman-facing numeric ICD Image Component ID.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Get ICD Image Detail by Component ID › Responses
Image details
uuidprimary_idprimary_dateentityprimary_countrysecond_geo_layerdominant_latdominant_longtitlesummaryreporttranscriptGet ICD Image Geo Manifest
Retrieve a lightweight, cursor-paginated manifest of authorized ICD image records with valid map coordinates. Results use deterministic newest-first ordering, and continuation remains stable during live ingestion. Full records remain available through the existing detail endpoint.
query Parameters
searchFull-text search term.
countryFilter by primary country.
entityFilter by associated entity.
date_fromReturn results on or after this date.
date_toReturn results on or before this date.
cursorOpaque next_cursor from the preceding response. Reuse it only with the exact same dataset, component, filters, page size, and format. If it is rejected, restart the request without a cursor.
per_pageAuthorized source records examined per cursor request. Invalid coordinates are excluded from returned items.
formatReturn the manifest as JSON or GeoJSON.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Get ICD Image Geo Manifest › Responses
Lightweight authorized Geo manifest cursor page.
statusdatabasecomponentitems_returneditems_returned_totalCumulative valid map records returned in this cursor traversal.
source_items_scannedAuthorized source records examined for this response.
source_items_scanned_totalCumulative authorized source records examined in this traversal.
pagination_modenext_cursorOpaque continuation bound to this dataset and filter snapshot. Repeat the same filters with this cursor.
pageOne-based response ordinal for this cursor traversal.
per_pagemappable_matchesValid map records encountered. Null until an uncapped traversal completes.
completeresult_limitMaximum authorized source-result window available to this consumer.
limit_reachedsort_orderDeterministic newest-first ordering. Component ID descending resolves records with the same primary date.
next_pageprevious_pagetotal_matchesReserved exact authorized match count. Null in the count-free Phase 1.5 contract.
Get ICD Image Detail Record
Retrieve the full intelligence record for a specific ICD image, including metadata, summary and IntelCenter visual and contextual analysis. Use this after finding a relevant image record to review its detailed content.
path Parameters
uuidHeaders
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Get ICD Image Detail Record › Responses
Image details
uuidprimary_idprimary_dateentityprimary_countrysecond_geo_layerdominant_latdominant_longtitlesummaryreporttranscriptICD Image Viewer
Retrieve a secure signed URL for viewing a specific ICD image. Use this when direct access to the original image content is needed.
path Parameters
uuidHeaders
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
ICD Image Viewer › Responses
Signed image URL
statussigned_urluuidtitleSearch ICDB Image Component
Search analyzed ICDB image records using keywords, entities, countries, date ranges and other filters. Results include structured metadata and summaries derived from IntelCenter visual and contextual analysis of entity-generated image content. Best for precise searches using known terms or filters.
query Parameters
searchFull text search term.
countryFilter by primary country.
entityFilter by associated entity.
pagePage number.
per_pageNumber of results per page.
sortSort order for results.
date_fromReturn results on or after this date.
date_toReturn results on or before this date.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Search ICDB Image Component › Responses
Search results
itemsReceivedcurPagenextPageprevPageoffsetperPageitemsTotalpageTotalGet ICDB Image Detail by Component ID
Retrieve the full intelligence record for a specific ICDB image using its human-facing numeric Component ID. Database and Component are established by this route; use the UUID detail route when the record UUID is known. Existing ICDB entity and access-tag restrictions remain authoritative.
path Parameters
component_idHuman-facing numeric ICDB Image Component ID.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Get ICDB Image Detail by Component ID › Responses
Image details or a not-found response when the record is absent or outside the authorized scope.
uuidprimary_idprimary_dateentityprimary_countrysecond_geo_layerdominant_latdominant_longtitlesummaryreporttranscriptGet ICDB Image Geo Manifest
Retrieve a lightweight, cursor-paginated manifest of authorized ICDB image records with valid map coordinates. Results use deterministic newest-first ordering, and continuation remains stable during live ingestion. Full records remain available through the existing detail endpoint.
query Parameters
searchFull-text search term.
countryFilter by primary country.
entityFilter by associated entity.
date_fromReturn results on or after this date.
date_toReturn results on or before this date.
cursorOpaque next_cursor from the preceding response. Reuse it only with the exact same dataset, component, filters, page size, and format. If it is rejected, restart the request without a cursor.
per_pageAuthorized source records examined per cursor request. Invalid coordinates are excluded from returned items.
formatReturn the manifest as JSON or GeoJSON.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Get ICDB Image Geo Manifest › Responses
Lightweight authorized Geo manifest cursor page.
statusdatabasecomponentitems_returneditems_returned_totalCumulative valid map records returned in this cursor traversal.
source_items_scannedAuthorized source records examined for this response.
source_items_scanned_totalCumulative authorized source records examined in this traversal.
pagination_modenext_cursorOpaque continuation bound to this dataset and filter snapshot. Repeat the same filters with this cursor.
pageOne-based response ordinal for this cursor traversal.
per_pagemappable_matchesValid map records encountered. Null until an uncapped traversal completes.
completeresult_limitMaximum authorized source-result window available to this consumer.
limit_reachedsort_orderDeterministic newest-first ordering. Component ID descending resolves records with the same primary date.
next_pageprevious_pagetotal_matchesReserved exact authorized match count. Null in the count-free Phase 1.5 contract.
Get ICDB Image Detail Record
Retrieve the full intelligence record for a specific ICDB image, including metadata, summary and IntelCenter visual and contextual analysis. Use this after finding a relevant image record to review its detailed content.
path Parameters
uuidHeaders
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Get ICDB Image Detail Record › Responses
Image details
uuidprimary_idprimary_dateentityprimary_countrysecond_geo_layerdominant_latdominant_longtitlesummaryreporttranscriptICDB Image Viewer
Retrieve a secure signed URL for viewing a specific ICDB image. Use this when direct access to the original image content is needed.
path Parameters
uuidHeaders
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
ICDB Image Viewer › Responses
Signed image URL
statussigned_urluuidtitleICD Natural Language Search
Search ICD video and image intelligence records using natural language queries. The system matches concepts across transcripts, visual analysis, audio analysis, summaries and metadata. Returns structured results with relevance scores. Best for exploratory, conceptual or descriptive searches where keyword search may be too narrow.
query Parameters
searchcountryentitysource_componentpageper_pagetop_kdate_fromReturn results on or after this date.
date_toReturn results on or before this date.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
ICD Natural Language Search › Responses
Natural language search results
statusitemsReceivedcurPagenextPageprevPageoffsetperPageitemsTotalpageTotalretrieval_questionsource_component_filtertop_kICDB Natural Language Search
Search ICDB video and image intelligence records using natural language queries. The system matches concepts across transcripts, visual analysis, audio analysis, summaries and metadata. Returns structured results with relevance scores. Best for exploratory, conceptual or descriptive searches where keyword search may be too narrow.
query Parameters
searchcountryentitysource_componentpageper_pagetop_kdate_fromReturn results on or after this date.
date_toReturn results on or before this date.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
ICDB Natural Language Search › Responses
Natural language search results
statusitemsReceivedcurPagenextPageprevPageoffsetperPageitemsTotalpageTotalretrieval_questionsource_component_filtertop_kICD Domain GenAI Chat
Ask questions and receive synthesized answers from ICD intelligence data. This IntelCenter Domain GenAI uses analyzed source material, including transcripts, visual analysis, audio analysis, summaries and metadata, to produce a focused response. Optional entity and primary_country parameters can focus on a particular domain. Best for analytical or complex questions where a direct answer is needed rather than a list of search results.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
ICD Domain GenAI Chat › Request Body
questionconversation_idOpaque identifier returned by a successful earlier turn. Omit it to start a new conversation.
primary_countryentitytop_kICD Domain GenAI Chat › Responses
ICD Domain GenAI chat response
statusanswerresponse_idconversation_idconversation_expires_atconversation_absolute_expires_atrag_prompt_tokensCompatibility alias. Use usage.prompt_tokens for new integrations.
rag_output_tokensCompatibility alias. Use usage.output_tokens for new integrations.
rag_total_tokensCompatibility alias. Use usage.total_tokens for new integrations.
ICDB Domain GenAI Chat
Ask questions and receive synthesized answers from ICDB intelligence data. This IntelCenter Domain GenAI uses analyzed source material, including transcripts, visual analysis, audio analysis, summaries and metadata, to produce a focused response. Optional entity and primary_country parameters can focus on a particular domain. Best for analytical or complex questions where a direct answer is needed rather than a list of search results.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
ICDB Domain GenAI Chat › Request Body
questionconversation_idOpaque identifier returned by a successful earlier turn. Omit it to start a new conversation.
primary_countryentitytop_kICDB Domain GenAI Chat › Responses
ICDB Domain GenAI chat response
statusanswerresponse_idconversation_idconversation_expires_atconversation_absolute_expires_atrag_prompt_tokensCompatibility alias. Use usage.prompt_tokens for new integrations.
rag_output_tokensCompatibility alias. Use usage.output_tokens for new integrations.
rag_total_tokensCompatibility alias. Use usage.total_tokens for new integrations.
Delete ICD Domain GenAI Conversation
Ends the authenticated API key's conversation and removes its retained conversation context. The operation is idempotent and does not consume a billable interaction.
path Parameters
conversation_idOpaque conversation identifier returned by Domain GenAI.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Delete ICD Domain GenAI Conversation › Responses
The conversation is no longer available. Repeating the request has the same result.
Delete ICDB Domain GenAI Conversation
Ends the authenticated API key's conversation and removes its retained conversation context. The operation is idempotent and does not consume a billable interaction.
path Parameters
conversation_idOpaque conversation identifier returned by Domain GenAI.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Delete ICDB Domain GenAI Conversation › Responses
The conversation is no longer available. Repeating the request has the same result.