Audio transcript

Any audio URL → timestamped chunks. Sync or async.

POST /v1/audio/transcript 20 / 2 min Media

A general-purpose audio transcription endpoint. Resolves the audio asset behind YouTube, X Spaces, SoundCloud, Apple Podcasts, Overcast, Facebook video, TikTok, and direct MP3/M4A/WAV/OGG URLs, then transcribes with timestamps. For anything longer than ~90 seconds, use the async variant: POST to /v1/audio/transcript/async, get a run_id back, poll /v1/scrape/runs/{run_id}.

The hard part

Every host hides its audio differently, and the URLs age out on different schedules. Even when you find the file, transcribing a 90-minute episode takes longer than most networks will hold a single request open. We resolve the audio per host and ship an async variant so long jobs don't die on a timeout halfway through.

What it does

Sources: YouTube, X Spaces, SoundCloud, Apple Podcasts, Overcast, Facebook video, TikTok, direct MP3 / M4A / WAV / OGG.
Sync at `/v1/audio/transcript`, async at `/v1/audio/transcript/async` (returns 202 + run_id).
Per-chunk timestamps. Optional `language` hint for accuracy.
`cookies` (Netscape cookies.txt for gated YouTube audio) and `include_usage` supported.

Send a call

curl -X POST https://scrapenest.dev/v1/audio/transcript/async \
  -H "Authorization: Bearer sn_••••" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }'

import httpx, time

base = "https://scrapenest.dev"
headers = {"Authorization": "Bearer sn_••••"}

submitted = httpx.post(
    f"{base}/v1/audio/transcript/async",
    headers=headers,
    json={"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"},
).json()
run_id = submitted["run_id"]

while True:
    run = httpx.get(f"{base}/v1/scrape/runs/{run_id}", headers=headers).json()
    if run["status"] in ("completed", "failed"):
        break
    time.sleep(2)
print(run["result"]["chunks"][:3])

const headers = {
  "Authorization": "Bearer sn_••••",
  "Content-Type": "application/json",
};
const start = await fetch("https://scrapenest.dev/v1/audio/transcript/async", {
  method: "POST",
  headers,
  body: JSON.stringify({ url: "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }),
});
const { run_id } = await start.json();
while (true) {
  const run = await (await fetch(
    `https://scrapenest.dev/v1/scrape/runs/${run_id}`,
    { headers },
  )).json();
  if (["completed", "failed"].includes(run.status)) break;
  await new Promise((r) => setTimeout(r, 2000));
}

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "time"
)

func main() {
    body, _ := json.Marshal(map[string]string{
        "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    })
    req, _ := http.NewRequest("POST",
        "https://scrapenest.dev/v1/audio/transcript/async",
        bytes.NewReader(body))
    req.Header.Set("Authorization", "Bearer sn_••••")
    req.Header.Set("Content-Type", "application/json")
    r, _ := http.DefaultClient.Do(req)
    var submitted struct{ RunID string `json:"run_id"` }
    json.NewDecoder(r.Body).Decode(&submitted)
    r.Body.Close()

    for {
        poll, _ := http.NewRequest("GET",
            "https://scrapenest.dev/v1/scrape/runs/"+submitted.RunID, nil)
        poll.Header.Set("Authorization", "Bearer sn_••••")
        pr, _ := http.DefaultClient.Do(poll)
        var run struct{ Status string }
        json.NewDecoder(pr.Body).Decode(&run)
        pr.Body.Close()
        fmt.Println(run.Status)
        if run.Status == "completed" || run.Status == "failed" { break }
        time.Sleep(2 * time.Second)
    }
}

Request body

{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "language": "en"
}

Response shape

{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "audio_url": "https://rr5---sn-...googlevideo.com/...mp4",
  "title": "Never Gonna Give You Up",
  "channel": "Rick Astley",
  "duration_seconds": 213.0,
  "language": "en",
  "source": "youtube",
  "chunks": [
    {"start": 0.0, "end": 3.1, "text": "We're no strangers to love"}
  ],
  "text": "We're no strangers to love... [full transcript]",
  "took_ms": 8400,
  "cache_hit": false,
  "credits_charged": 40
}

What it costs

20 credits per 2 minutes of audio, rounded up. Same pricing on the async variant. Cache hits bill at 1.

The edge timeout is ~100 s. Anything longer than ~90 s of audio should use the async variant: same pricing, no timeout risk.