API Endpoints
The IntelCenter API provides access to intelligence data through a RESTful interface.
All endpoints are versioned and currently available under:
https://api.intelcenter.com/v1
Overview
The API is organized into datasets and capabilities. Each dataset follows a consistent pattern:
- Search — retrieve paginated results with filtering and sorting
- Get by UUID — retrieve detailed record data
- Media Access — retrieve a player or viewer URL (where applicable)
In addition, the API provides:
- Natural Language Search — concept-based search across datasets
- Domain GenAI — AI-powered question answering over intelligence data
Available Datasets
Video Data
- ICD Video —
/v1/icd/videos - ICDB Video —
/v1/icdb/videos
Image Data
- ICD Image —
/v1/icd/images - ICDB Image —
/v1/icdb/images
Advanced Capabilities
Natural Language Search
Search across transcripts, summaries, visual analysis, and metadata using natural language.
/v1/icd/nl-search/v1/icdb/nl-search
Example:
Code
Best for:
- Conceptual queries
- Descriptive searches
- Situational discovery
Domain GenAI
Ask analytical questions and receive synthesized answers based on IntelCenter intelligence data.
/v1/icd/domain-genai/v1/icdb/domain-genai
Example:
Code
Best for:
- Analytical questions
- Intelligence summaries
- Cross-source synthesis
Common Endpoint Patterns
Search
Retrieve a list of records with optional filtering, pagination, and sorting.
Code
Example:
Code
Supported Query Parameters
search— full text search across indexed fieldsentity— filter by associated entitycountry— filter by primary countrypage— page number (starting at 1)per_page— number of results per pagedate_from— return results on or after this date (YYYY-MM-DD)date_to— return results on or before this date (YYYY-MM-DD)sort— optional sorting (advanced usage)
Additional parameters (NL search):
source_component— filter by content typetop_k— control retrieval depth
All parameters are optional and can be combined.
Get by UUID
Retrieve detailed information for a specific record.
Code
Example:
Code
Replace {uuid} with the record identifier.
Media Access
Retrieve a secure media URL for playback or viewing.
Video Player
Code
Example:
Code
Image Viewer
Code
Example:
Code
MCP Endpoints
In addition to REST endpoints, the IntelCenter API provides MCP (Model Context Protocol) endpoints for AI assistants and automation tools.
Available MCP Routes
/mcp-icd— ICD datasets only/mcp-all— ICD + ICDB datasets
Available MCP Tools
MCP exposes tools corresponding to API operations, including:
- Video search and retrieval
- Image search and retrieval
- Media player and viewer access
- Natural language search
- Domain GenAI chat
Examples:
searchIcdVideossearchIcdbImagessearchIcdNlsearchIcdbNlicdDomainGenAiChaticdbDomainGenAiChat
Notes on MCP Usage
- MCP tools map directly to REST endpoints
- Parameters are automatically translated
- Access is controlled by your API key permissions
- Some tools may be unavailable depending on dataset or feature access
Consistent Response Structure
All search endpoints return a standardized paginated response:
items— array of resultsitemsReceived— number of items in current responsecurPage— current pagenextPage/prevPage— navigationperPage— results per pageitemsTotal— total matching recordspageTotal— total number of pages
This consistent structure applies across all datasets.
Access Control
Access to datasets and features is controlled per API key.
- Some keys may only access ICD datasets
- Some keys may have restricted ICDB entity access
- Some keys may not include Natural Language or Domain GenAI capabilities
If access is not permitted, the API will return a 403 Forbidden response.
Next Steps
- Explore the API Reference for full endpoint details
- Test queries with different filters and pagination
- Use Natural Language Search for exploratory queries
- Use Domain GenAI for analytical workflows
- Integrate endpoints into your applications or MCP workflows
