Documentation
Everything you need to know about using IntroDB and contributing timestamps.
Reference
API Reference
IntroDB provides a free API for fetching intro, recap, and outro timestamps and submitting new data.
Free & open
No API key needed to read
Auth for writes
Clerk JWT or API key
Rate limited
Fair usage enforced
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=1Submit (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
Full OpenAPI reference with interactive examples and try-it-out.