Documentation

Everything you need to know about using IntroDB and contributing timestamps.

API Reference

IntroDB provides a free API for fetching intro, recap, and outro timestamps and submitting new data.

Segment Endpoints

Use GET /segments and POST /segments/submit for new integrations. The legacy /intro route remains available for intro-only clients.

Read segments

GET /segments?imdb_id=tt0903747&season=1&episode=1

Submit (signed-in user)

POST /segments/submit
Authorization: Bearer <clerk_token>
Content-Type: application/json

{
  "imdb_id": "tt0903747",
  "segment_type": "intro",
  "season": 1,
  "episode": 1,
  "start_sec": "00:00:02",
  "end_sec": "00:00:58"
}

Submit (API key)

POST /submit
X-API-Key: idb_...
Content-Type: application/json

{
  "imdb_id": "tt0903747",
  "segment_type": "recap",
  "season": 1,
  "episode": 2,
  "start_sec": 30,
  "end_sec": 135
}

`segment_type` is required for bulk and strongly recommended everywhere. `start_sec` and `end_sec` accept seconds or clock-style strings (`mm:ss`, `hh:mm:ss`).

Interactive API Documentation

View our complete API reference with interactive examples, request/response schemas, and try-it-out functionality.

View API Docs