Core Concepts
Choosing the Right Endpoint
The IntelCenter API provides multiple ways to access data depending on your use case.
Use the guidance below to select the appropriate endpoint.
Keyword Search (Videos / Images)
Endpoints:
/v1/icd/videos/v1/icdb/videos/v1/icd/images/v1/icdb/images
Use when:
- You know specific keywords, entities, or filters
- You want precise, structured results
- You need pagination and sorting control
Best for:
- Exact matching
- Filtering by entity, country, or date
Natural Language Search
Endpoints:
/v1/icd/nl-search/v1/icdb/nl-search
Use when:
- You are exploring a topic
- You want concept-based matching
- You do not know exact keywords
Best for:
- Discovery
- Broad or descriptive queries
- Finding related intelligence across transcripts and analysis
Domain GenAI
Endpoints:
/v1/icd/domain-genai/v1/icdb/domain-genai
Use when:
- You want a direct answer or analysis
- You are asking complex or analytical questions
- You want synthesized intelligence instead of raw results
Best for:
- Summaries
- Intelligence assessments
- Question-answering workflows
Recommended Workflow
- Start with Natural Language Search for discovery
- Use UUIDs from results to retrieve full records
- Use Domain GenAI for deeper analysis or synthesis
Tip
If you are unsure where to start:
- Use Natural Language Search for exploration
- Use Keyword Search for precision
- Use Domain GenAI for answers
Last modified on