Copy page

Getting Started

Quickstart

This guide shows how to send your first request to the IntelCenter API.

---

Base URL

All API requests are made to:

https://api.intelcenter.com

All requests must be made over HTTPS.

---

Step 1 — Obtain an API Key

To use the IntelCenter API you must obtain an API key from IntelCenter.

Your API key is used to authenticate all requests.

---

Step 2 — Send Your First Request (Structured Search)

The following request searches ICD video records using standard keyword search.

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

---

Example Response

A successful request returns paginated results with a standardized response structure.

Code
{
  "itemsReceived": 1,
  "curPage": 1,
  "nextPage": null,
  "prevPage": null,
  "offset": 0,
  "perPage": 25,
  "itemsTotal": 1,
  "pageTotal": 1,
  "items": [
    {
      "uuid": "11111111-1111-1111-1111-111111111111",
      "primary_id": 123456,
      "primary_date": "2026-03-12",
      "entity": "Example Entity",
      "primary_country": "USA",
      "title": "Example Video Title",
      "summary": "Example summary describing the content of the video."
    }
  ]
}

---

Natural Language Search

You can also search using descriptive or conceptual queries.

Code
curl --request GET \
  --url "https://api.intelcenter.com/v1/icd/nl-search?search=missile launch activity in iran" \
  --header "Authorization: Bearer YOUR_API_KEY"

This method matches concepts across transcripts, summaries, visual analysis, and metadata.

---

Domain GenAI (Ask Questions)

You can ask direct analytical questions and receive synthesized answers from intelligence data.

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"
  }'

Domain GenAI is best suited for complex or investigative queries where you want a direct answer instead of a list of results.

---

Get a Single Record

You can retrieve detailed information for a specific record using its UUID.

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

---

Access Media (Viewer / Player)

Some endpoints provide access to associated media via a viewer or player URL.

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

---

Usage Limits

API usage is subject to limits based on your API key.

These include:

• Rate Limits — Requests per minute for search and detail endpoints
• Domain GenAI Limits — Additional per-minute, hourly, and daily limits for Domain GenAI endpoints
• Daily Quotas — Maximum requests per day
• Monthly Quotas — Maximum requests per month
• Per-Request Limits — Maximum results per request (per_page)

Limits vary depending on your API key tier.

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

Example:

Code
{
  "error": "quota_exceeded",
  "message": "This API key exceeded a usage or rate limit and the request was blocked.",
  "tier": "trial",
  "rate_limit": "domain-genai",
  "limits": {
    "daily_requests": 100,
    "monthly_requests": 1000
  }
}

---

Available Endpoints

• /v1/icd/videos
• /v1/icdb/videos
• /v1/icd/images
• /v1/icdb/images
• /v1/icd/nl-search
• /v1/icdb/nl-search
• /v1/icd/domain-genai
• /v1/icdb/domain-genai

Each dataset supports search, retrieval by UUID, and media access.

---

Next Steps

1. Explore endpoints in the API Reference
2. Review the Authentication guide
3. Integrate API calls into your application
4. (Optional) Use MCP for AI-powered workflows

---

Need Help?

[email protected]