Getting Started

IntelCenter API

Welcome to the IntelCenter Developer Portal.

The IntelCenter API provides programmatic access to IntelCenter intelligence data services, enabling developers and AI systems to search, analyze, and retrieve intelligence content directly from their own applications.

This portal contains documentation for authenticating with the API, making requests, and exploring available endpoints — including traditional REST access, natural language search, Domain GenAI capabilities, and Model Context Protocol (MCP) integrations.

🚀 What's New (v1.1.0)

The latest release introduces major new capabilities for discovery and analysis:

New Features

Natural Language Search
- /v1/icd/nl-search
- /v1/icdb/nl-search
- Search using descriptive or conceptual queries instead of exact keywords
Domain GenAI
- /v1/icd/domain-genai
- /v1/icdb/domain-genai
- Ask questions and receive synthesized intelligence answers
Expanded MCP Support
- New tools available via /mcp-all
- Supports Natural Language Search and Domain GenAI

Improvements

Improved error response consistency
Enhanced permission handling across datasets and features
Expanded and reorganized documentation

➡ See the full Changelog

Available Data

The IntelCenter API provides access to multiple intelligence datasets:

ICD Video — curated video intelligence records
ICDB Video — additional video intelligence records
ICD Image — curated image intelligence records
ICDB Image — additional image intelligence records

These datasets contain content generated by entities and individuals of national security interest. IntelCenter analyzes this content to produce transcripts, summaries, and visual and audio analysis, making spoken, visual, and contextual information searchable via text.

Core Capabilities

Across datasets, the API supports multiple ways to access and interact with intelligence data:

Structured Search

Full-text keyword search
Filtering by metadata (entity, country, date, etc.)
Pagination and sorting
Retrieval of individual records by UUID

Natural Language Search

Query datasets using descriptive or conceptual questions
Matches across transcripts, summaries, visual analysis, and metadata
Returns structured results with relevance scoring

Domain GenAI

Ask questions and receive synthesized answers from intelligence data
Uses analyzed source material (transcripts, visual analysis, audio analysis, summaries, and metadata)
Supports optional filtering by entity or country to focus responses
Designed for analytical, investigative, and complex queries

Media Access

Secure streaming video player URLs
Secure signed URLs for image viewing

Base URL

All API requests should be sent to:

https://api.intelcenter.com

All requests must be made over HTTPS.

Authentication

All requests to the IntelCenter API require a valid API key.

Authentication is performed using a Bearer token in the HTTP Authorization header.

Example:

Code
Authorization: Bearer YOUR_API_KEY

If authentication fails, the API will return a 401 Unauthorized response.

See the Authentication section for full details.

Search & Filtering

Most endpoints support flexible query parameters for searching and filtering data.

Common parameters include:

search — full-text or natural language query
country — filter by primary country
entity — filter by associated entity
page — page number for pagination
per_page — number of results per page
sort — control result ordering
date_from / date_to — filter by date range

These parameters can be combined to create precise or exploratory queries across large datasets.

MCP (Model Context Protocol)

In addition to REST access, the IntelCenter API supports Model Context Protocol (MCP) for AI integrations.

MCP allows AI assistants and tools to:

Discover available IntelCenter tools dynamically
Perform structured and natural language searches
Retrieve intelligence records
Access media viewers and player endpoints
Interact with Domain GenAI capabilities

Available MCP endpoints:

/mcp-icd — ICD-only tools (curated datasets)
/mcp-all — full access to ICD and ICDB tools (requires appropriate permissions)

MCP uses the same authentication model and fully respects API key dataset and entity-level access controls.

Access Control

API access is controlled at multiple levels:

Dataset-level access (ICD vs ICDB)
Entity-level restrictions (for ICDB and other scoped datasets)
Endpoint-level capabilities (e.g., Domain GenAI, natural language search)

All requests automatically enforce these permissions based on the API key.

Rate Limits

API requests may be subject to rate limits and usage quotas depending on your access level.

Standard endpoints (search, detail, media) have general rate limits
Domain GenAI endpoints have stricter limits due to computational cost

If limits are exceeded, the API will return a 429 Too Many Requests response with details about the restriction.

Example Requests

Search ICDB videos:

Code
curl --request GET \
  --url "https://api.intelcenter.com/v1/icdb/videos?search=houthis&page=2&per_page=5" \
  --header "Authorization: Bearer YOUR_API_KEY"

Retrieve a specific image:

Code
curl --request GET \
  --url https://api.intelcenter.com/v1/icd/images/{uuid} \
  --header "Authorization: Bearer YOUR_API_KEY"

Query Domain GenAI:

Code
curl --request POST \
  --url https://api.intelcenter.com/v1/icd/domain-genai \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "question": "What recent activity has been reported involving this entity?",
    "entity": "Example Entity"
  }'

Most resources are identified by a UUID, returned in search results and used to retrieve specific records.

API Reference

The full interactive API reference is available here:

➡ API Reference

You can explore endpoints, parameters, and response formats directly from the portal.

Getting Started

To begin using the IntelCenter API:

Obtain an API key from IntelCenter
Review the Authentication documentation
Send your first request using the Quickstart guide
Explore endpoints in the API Reference
(Optional) Integrate with MCP for AI-driven workflows

Support

If you need assistance integrating with the IntelCenter API:

[email protected]

or visit:

https://www.intelcenter.com

Last modified on May 5, 2026

Quickstart

Getting Started

IntelCenter API

Welcome to the IntelCenter Developer Portal.

🚀 What's New (v1.1.0)

The latest release introduces major new capabilities for discovery and analysis:

New Features

Natural Language Search
- /v1/icd/nl-search
- /v1/icdb/nl-search
- Search using descriptive or conceptual queries instead of exact keywords
Domain GenAI
- /v1/icd/domain-genai
- /v1/icdb/domain-genai
- Ask questions and receive synthesized intelligence answers
Expanded MCP Support
- New tools available via /mcp-all
- Supports Natural Language Search and Domain GenAI

Improvements

Improved error response consistency
Enhanced permission handling across datasets and features
Expanded and reorganized documentation

➡ See the full Changelog

Available Data

The IntelCenter API provides access to multiple intelligence datasets:

ICD Video — curated video intelligence records
ICDB Video — additional video intelligence records
ICD Image — curated image intelligence records
ICDB Image — additional image intelligence records

Core Capabilities

Across datasets, the API supports multiple ways to access and interact with intelligence data:

Structured Search

Full-text keyword search
Filtering by metadata (entity, country, date, etc.)
Pagination and sorting
Retrieval of individual records by UUID

Natural Language Search

Query datasets using descriptive or conceptual questions
Matches across transcripts, summaries, visual analysis, and metadata
Returns structured results with relevance scoring

Domain GenAI

Ask questions and receive synthesized answers from intelligence data
Uses analyzed source material (transcripts, visual analysis, audio analysis, summaries, and metadata)
Supports optional filtering by entity or country to focus responses
Designed for analytical, investigative, and complex queries

Media Access

Secure streaming video player URLs
Secure signed URLs for image viewing

Base URL

All API requests should be sent to:

https://api.intelcenter.com

All requests must be made over HTTPS.

Authentication

All requests to the IntelCenter API require a valid API key.

Authentication is performed using a Bearer token in the HTTP Authorization header.

Example:

Code
Authorization: Bearer YOUR_API_KEY

If authentication fails, the API will return a 401 Unauthorized response.

See the Authentication section for full details.

Search & Filtering

Most endpoints support flexible query parameters for searching and filtering data.

Common parameters include:

search — full-text or natural language query
country — filter by primary country
entity — filter by associated entity
page — page number for pagination
per_page — number of results per page
sort — control result ordering
date_from / date_to — filter by date range

These parameters can be combined to create precise or exploratory queries across large datasets.

MCP (Model Context Protocol)

In addition to REST access, the IntelCenter API supports Model Context Protocol (MCP) for AI integrations.

MCP allows AI assistants and tools to:

Discover available IntelCenter tools dynamically
Perform structured and natural language searches
Retrieve intelligence records
Access media viewers and player endpoints
Interact with Domain GenAI capabilities

Available MCP endpoints:

/mcp-icd — ICD-only tools (curated datasets)
/mcp-all — full access to ICD and ICDB tools (requires appropriate permissions)

MCP uses the same authentication model and fully respects API key dataset and entity-level access controls.

Access Control

API access is controlled at multiple levels:

Dataset-level access (ICD vs ICDB)
Entity-level restrictions (for ICDB and other scoped datasets)
Endpoint-level capabilities (e.g., Domain GenAI, natural language search)

All requests automatically enforce these permissions based on the API key.

Rate Limits

API requests may be subject to rate limits and usage quotas depending on your access level.

Standard endpoints (search, detail, media) have general rate limits
Domain GenAI endpoints have stricter limits due to computational cost

If limits are exceeded, the API will return a 429 Too Many Requests response with details about the restriction.

Example Requests

Search ICDB videos:

Code
curl --request GET \
  --url "https://api.intelcenter.com/v1/icdb/videos?search=houthis&page=2&per_page=5" \
  --header "Authorization: Bearer YOUR_API_KEY"

Retrieve a specific image:

Code
curl --request GET \
  --url https://api.intelcenter.com/v1/icd/images/{uuid} \
  --header "Authorization: Bearer YOUR_API_KEY"

Query Domain GenAI:

Code
curl --request POST \
  --url https://api.intelcenter.com/v1/icd/domain-genai \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "question": "What recent activity has been reported involving this entity?",
    "entity": "Example Entity"
  }'

Most resources are identified by a UUID, returned in search results and used to retrieve specific records.

API Reference

The full interactive API reference is available here:

➡ API Reference

You can explore endpoints, parameters, and response formats directly from the portal.

Getting Started

To begin using the IntelCenter API:

Obtain an API key from IntelCenter
Review the Authentication documentation
Send your first request using the Quickstart guide
Explore endpoints in the API Reference
(Optional) Integrate with MCP for AI-driven workflows

Support

If you need assistance integrating with the IntelCenter API:

[email protected]

or visit:

https://www.intelcenter.com

Last modified on May 5, 2026

Quickstart