Developer Docs

Integrate ChronoSeek into your product

Use https://api.chronoseek.org to search inside publicly accessible videos and retrieve ranked timestamp intervals for the exact moment a scene or event happens.

Create Account Open Swagger

Base URL

https://api.chronoseek.org

The public developer integration supports both POST /v1/searches for a single JSON response and POST /v1/searches/stream for SSE updates.

Authentication

x-api-key: YOUR_API_KEY

API keys are account-scoped. Every successful search request debits credits from the account that owns the key.

Important Input Rule

The source video must be publicly accessible. ChronoSeek needs a retrievable video URL so the subnet can download and analyze the media before returning timestamp intervals.

Search Endpoint

POST /v1/searches accepts a public video URL and a natural-language query, then returns ranked timestamp windows.
POST /v1/searches/stream accepts the same payload and streams accepted, result, and terminal done/error events.

1. Generate an API key

Create an account, verify your email, then open the account page to generate an API key. Copy the secret immediately. Existing keys only expose the prefix later, not the full secret.

2. Send a search request

curl -X POST "https://api.chronoseek.org/v1/searches" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "protocol_version": "2026-04-10",
    "query": "the moment where two people start fighting",
    "top_k": 5,
    "video": {
      "url": "https://cdn.example.com/public-video.mp4"
    }
  }'

3. Parse the ranked moments

{
  "protocol_version": "2026-04-10",
  "request_id": "req_123",
  "status": "completed",
  "results": [
    {
      "start": 45,
      "end": 53,
      "confidence": 0.91
    },
    {
      "start": 139,
      "end": 149,
      "confidence": 0.72
    }
  ]
}

Each result includes start, end, and confidence. Results are returned in ranked order.