Get API Key

API Documentation

Integrate IntroHater skip segments into your own applications.

Interactive Swagger Reference Guide

Authentication

All API endpoints require an API key. Pass it in the header:

X-API-Key: your_api_key
Rate Limits: Default is 100 requests per 15-minute window per key.

Available Endpoints

GET /api/segments/:videoId

Retrieve all segments for a specific video.

Parameters

  • videoId - IMDB ID (e.g. tt1234567 or tt1234567:1:1)
POST /api/submit

Submit a new segment for a video. Requires 'write:segments' permission.

Request Body

{
    "videoId": "tt1234567:1:1",
    "startTime": 120.5,
    "endTime": 180.2,
    "category": "intro",
    "userId": "stremio:123...",
    "token": "auth_token",
    "timestamp": 1678900000000,
    "nonce": "unique-nonce"
}
POST /api/generate-token

Generate a temporary authentication token for submissions/votes.

{ "userId": "stremio:123..." }
PATCH /api/segments/:segmentId/vote

Vote on an existing segment (up/down). Requires 'write:votes' permission.

{
    "vote": "up", // or "down"
    "userId": "stremio:123...",
    "token": "auth_token",
    ...
}