Skip to content
nData API v1 · public beta

Video transcripts, with the timestamps you need.

Retrieve existing captions or generate a transcript from a public video. Choose plain text, sentence timestamps or word timestamps.

How it works

  1. Send a permitted public post URL to POST /v1/transcriptions, with an API key and a unique idempotency key.
  2. Choose native captions or generated speech recognition, and flat, sentence or word timestamps.
  3. Save the accepted job ID. Poll its resource URL or use a signed webhook to receive the terminal result.

Choose the right transcript mode

Native mode retrieves the source caption track. Generated mode runs speech recognition on the primary video. Native mode does not silently fall back to generated mode. Missing captions or unsupported timing produce explicit errors.

{
  "url": "PUBLIC_VIDEO_POST_URL",
  "mode": "generated",
  "timestamps": "word"
}

These are illustrative request bodies. Replace the placeholder with a supported URL. Read the full contract and error cases.

Supported sources and limits

Individual public posts on YouTube, Instagram, TikTok, LinkedIn, Reddit, X and Threads. Profiles, feeds, search results and private sources are outside the beta. Source and caption availability can vary.

Configurable defaults allow videos up to 3 hours, aggregate selected media up to 500 MB per post and batches up to 1,000 URLs. Credits and daily processing quotas also apply. These are limits, not completion-time or availability guarantees.

Beta credits and data handling

The default starter grant is 100 one-time credits for an eligible verified personal workspace. Extraction reserves 5 credits and transcription reserves 2. Successful jobs settle once; failed jobs release their reservation. Rates are provisional and the workspace balance is authoritative.

Read beta credits and limits and data handling and source retention. The anonymous playground uses static fixtures and never fetches your URL.

Keep exploring