Quickstart

Get an API key, make one call, and read the response.

Examples use VIDEO_ID and clp_live_... as placeholders.

Create an API key

Go to API Keys and create one. It's shown once, so copy it somewhere safe.

Make a call

Swap in your own video ID and key. The video needs captions.

curl -X POST "https://clypso-eta.vercel.app/v1/extract" \
  -H "Authorization: Bearer clp_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=VIDEO_ID"}'

Read the response

artifact.content holds the output. cached tells you whether it came from cache. If you get a 202, poll the job as described in Extraction.

Check ok before you read the output, because a 200 can still report a failure. When ok is false, error.code says why. If you run the example with VIDEO_ID left in, you get ok: false and invalid_url, since a video ID has 11 characters.