Chapters and answers for YouTube videos, from your own code

Send a YouTube link to the Bumpups API and get back timestamped chapters, ready to paste into a description. Then ask questions about the video. It comes with Pro and uses the same minutes as the app.

Get your API key Read the docs

Included with Pro. The output shown is real: a Harvard lecture processed by the API.

Three calls from link to chapters

  1. 1

    Create a key

    On Pro, open the API page in the app and create a key. It’s shown once, so store it on your server.

    Authorization: Bearer bu_live_…
  2. 2

    Send a YouTube link

    The video is accepted right away and processed in the background. It costs its length in minutes.

    POST /v1/videos {"url": "…"}
  3. 3

    Get chapters, then ask

    Check back until the status is ready. Use the chapters, or ask questions about the video.

    GET /v1/videos/{id}

What comes back

The same chapters and answers you get in the app, as JSON.

Chapters

A list with start times in seconds, plus chapters_text for a YouTube description.

[
  {
    "start_seconds": 0,
    "timestamp": "0:00",
    "title": "Intro credits and course framing"
  },
  {
    "start_seconds": 150,
    "timestamp": "2:30",
    "title": "Audience poll: trolley dilemma choices"
  },
  {
    "start_seconds": 327,
    "timestamp": "5:27",
    "title": "Bridge variant: would you push the fat man?"
  }
]

Answers

Ask anything about the video and get Markdown back. Follow-up questions keep the context.

Which cases does the professor use to test our moral intuitions?

The professor presents five main cases to test moral intuitions:

  • The trolley car driver: You are driving a runaway trolley and must choose between staying on the track to kill five workers or turning onto a side track to kill one.
  • The onlooker on the bridge: You are watching a runaway trolley and can save five workers on the track by pushing a heavy man off a bridge to stop the trolley, killing him.
  • The transplant surgeon: You have five patients who will die without organ transplants. You can save them by killing a healthy patient who came in for a checkup and harvesting his organs.

One account, shared limits

Pro is $20 a month for 1,000 minutes. The API and the web app draw on the same balance, and every API video appears in your Workspace.

See Pro plans
Plan
Pro. Keys stop working while an account is on Free and start again after an upgrade.
Minutes
A video costs its length in whole minutes (at least 1), from the same balance as the web app. No chapters, no charge.
Questions
25 per video, counted together with web chat, one at a time. They don't use minutes.
Videos
Public YouTube videos up to 3 hours. Unlisted videos need to be 30 minutes or longer. Live streams and premieres aren't supported.
Keys
Up to 5 per account. Revoked keys stop working within a minute.
Requests
JSON bodies up to 16 KB. Keys are for servers: browsers can't call the API.

Built the way developers expect

REST and JSON

Versioned paths, predictable resources, snake_case fields and RFC 3339 times.

OpenAPI 3.1

A machine-readable description of every endpoint, for code generators and AI agents.

Problem details

Errors in the RFC 9457 format, with a stable code and a request id.

Safe retries

Send an Idempotency-Key and a retried request never charges twice.

Async by design

Long work answers 202 with a Location to check and a Retry-After hint.

Keys you control

Shown once, stored only as a hash, revoked from the app in a minute.

API questions

Build with the Bumpups API

Included with Pro: $20 a month for 1,000 minutes.

Get your API key Read the docs