Documentation

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

How It Works

When you submit segment timestamps (intro/recap/outro), they go through a verification process before appearing in the public API.

You submit start/end timestamps for intro, recap, or outro.

Your submission enters the queue and awaits verification.

Once enough users submit similar timestamps for the same episode, the system aggregates them.

The aggregated, verified timestamps become available via the public API.

We use aggregation instead of trusting a single submission to ensure accuracy:

Multiple submissions are clustered based on similarity

The median of the largest cluster becomes the consensus

This prevents accidental or malicious incorrect timestamps

Admins can fast-track submissions that are clearly correct

Pending

Awaiting verification, needs more matching submissions or admin review

Accepted

Your submission contributed to the live aggregate

Rejected

Your submission was too far from the consensus or was manually rejected