Quickstart

1. Get a token

Sign up at apify.com (free) and copy your API token from Settings → Integrations.

2. Pick an endpoint

3. Call it

The simplest integration is the synchronous run endpoint — it starts the run, waits, and returns the dataset items in one response:

curl -X POST \
  "https://api.apify.com/v2/acts/ethereal_wool~any-url-transcript/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "videoUrls": [
      "https://www.tiktok.com/@tiktok/video/7649091368656194847",
      "https://v.douyin.com/iRNBho6u/",
      "https://www.bilibili.com/video/BV1GJ411x7h7"
    ]
  }'

For long batches, start the run asynchronously and fetch the dataset when it finishes:

# start
curl -X POST "https://api.apify.com/v2/acts/ethereal_wool~any-url-transcript/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" -d '{"videoUrls": [...]}'
# → returns {"data": {"id": "<runId>", "defaultDatasetId": "<datasetId>", ...}}

# poll, then fetch items
curl "https://api.apify.com/v2/datasets/<datasetId>/items?token=$APIFY_TOKEN"

Output schema

Each transcribed video is one dataset item with this shape (uniform across platforms):

{
  "url": "https://www.tiktok.com/@tiktok/video/7649091368656194847",
  "platform": "tiktok",
  "videoId": "7649091368656194847",
  "author": "tiktok",
  "title": "…",
  "durationSec": 34.2,
  "playCount": 1284000,
  "language": "en",
  "transcript": "full spoken text …",
  "sentences": [
    { "beginTime": 0,    "endTime": 3400, "text": "First sentence…" },
    { "beginTime": 3400, "endTime": 7100, "text": "Second sentence…" }
  ],
  "billedMinutes": 0.57
}

beginTime/endTime are milliseconds — converting to SRT/VTT subtitle cues is a 10-line script.

Errors & billing guarantees