# Douyin Transcripts: speech-to-text, 抖音 video to text (`pikoulas/douyin-transcripts`) Actor

Transcribe Douyin (抖音) videos to text or timestamped segments, by video URL, share link or ID, with each video's caption, hashtags, date, author and likes. Speech-to-text by Whisper inside the run; Mandarin in Simplified Chinese, and about 100 other languages.

- **URL**: https://apify.com/pikoulas/douyin-transcripts.md
- **Developed by:** [Spyridon Pikoulas](https://apify.com/pikoulas) (community)
- **Categories:** AI, Social media, Videos
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 audio minute transcribed (whisper base)s

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Douyin Transcripts: speech-to-text, 抖音 video to text

**Retired on 2026-11-15.** Douyin's operator has won suits against those who took data from it, and its [user agreement](https://www.douyin.com/draft/douyin_agreement/douyin_agreement_user.html) prohibits crawlers, so this Actor no longer reads Douyin. A run reads nothing, charges nothing and ends with this notice.

Get the transcript of Douyin (抖音) videos as clean text, or as timestamped segments, from their
URLs, the share links the app copies, or their IDs. Mandarin comes out in Simplified Chinese,
and about 100 other languages are recognised too.

The speech-to-text runs inside the actor: OpenAI's Whisper model, open source, on Apify's
servers. Nothing is sent to an outside AI service, and no Douyin account or cookies are needed.

Every result also carries what Douyin shows about the video: its caption, hashtags, date,
duration, likes, comments, shares and saves, the author's name and Douyin ID, the sound used, and
Douyin's label where the author declared the video AI-generated.

It costs **$0.008 per minute of audio** on Apify's paid plans ($0.016 on the free plan) with
Whisper small, the default, and $0.003 ($0.006) with the faster Whisper base, counted in started
minutes: a 45-second video is $0.008. Videos without speech are free.

### What people use it for

- **Market research in China:** what sellers, brands and creators say about products, as text
  you can search, translate and analyse.
- **AI and LLM pipelines:** summaries, translation, RAG over Douyin videos, training data.
- **Content and trend research:** the scripts behind videos that sell or go viral.
- **Subtitles and repurposing:** timestamped lines for subtitles, quotes and translations.

### How to transcribe a Douyin video

1. Click **Try for free**; Apify's free plan covers a first run.
2. Paste video URLs, share links or IDs under **Douyin videos**. The whole text the app's
   **Share → Copy link** gives works as it is.
3. Click **Start**, then download the results as JSON, CSV, Excel or HTML, or read them through
   the API.

**Max minutes per video** transcribes, and charges, only each video's first minutes.
**Speech-to-text model** picks between Whisper small, more accurate, and Whisper base, about
three times faster and cheaper but with more wrong characters in Mandarin. **Language** fixes
the language spoken when you know it; otherwise each video's is detected. Turn on **Include
timestamps** for `segments`, each line with its start and end.

```json
{
  "urls": [
    "https://www.douyin.com/video/7685708860878769454",
    "https://www.douyin.com/jingxuan?modal_id=7702256834182253862",
    "7693093964693490980"
  ],
  "model": "small",
  "includeTimestamps": true
}
```

### Output

```json
{
  "input": "https://www.douyin.com/video/7685708860878769454",
  "id": "7685708860878769454",
  "url": "https://www.douyin.com/video/7685708860878769454",
  "description": "2026新手版！AI设计必备整合包重磅更新！ … #AI视频 #AI生成视频",
  "hashtags": ["AI视频", "AI生成视频"],
  "createdAt": "2026-09-15T10:35:45Z",
  "durationSeconds": 43,
  "likes": 341,
  "comments": 5,
  "shares": 17,
  "saves": 114,
  "authorName": "Ai工作流辣妹",
  "authorDouyinId": "25677521181",
  "authorUrl": "https://www.douyin.com/user/…",
  "musicTitle": "@Ai工作流辣妹创作的原声一Ai工作流辣妹",
  "label": "作者声明：内容由 AI 生成",
  "language": "zh",
  "languageProbability": 1,
  "text": "兄弟们大得来了 这是一期老破晓也能无限生成电商设计的工作流 首先第一个必须给到H3多参生视频工作流 想做产品宣传 又没有模特的回专业团队 …",
  "transcribedSeconds": 43.3,
  "isComplete": true,
  "billedMinutes": 1,
  "segments": [{"start": 0, "end": 1.16, "text": "兄弟们大得来了"}]
}
```

A video stopped short by **Max minutes per video**, the run's spending limit or its timeout
comes with what was transcribed, `isComplete: false`, its `transcribedSeconds` and a
`stoppedBecause`, and is charged only for those minutes. A video without speech (music only), a
photo post, or a video that's deleted or private comes with what's known of it and a
`noTranscriptReason`, and costs nothing.

### Use it as an API

Apify's API starts a run and returns its dataset as JSON; its Python and JavaScript clients, and
its Make, Zapier and n8n integrations, work the same way.

```bash
curl -X POST "https://api.apify.com/v2/acts/pikoulas~douyin-transcripts/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://www.douyin.com/video/7685708860878769454"]}'
```

AI agents can call it as a tool through Apify's MCP server: `https://mcp.apify.com?tools=pikoulas/douyin-transcripts`.

### How much does it cost to transcribe Douyin videos?

With Whisper small you pay **$0.008 per started minute of audio** on Apify's paid plans, and
$0.016 on the free plan: most Douyin videos are under a minute or two, so $8–16 per 1,000 videos
($16–32 on the free plan). Whisper base is $0.003 per started minute ($0.006 on the free plan).
`billedMinutes` shows each video's. Videos without speech are free. If Douyin refuses Apify's
servers, the actor reads its pages through Apify's residential proxy, charged at
$0.0012 per 100 KB: about 40 KB a video, $0.0005. The video files themselves come straight from
Douyin's servers, at no charge. There are no monthly fees.

The run stops at the spending limit you set, mid-video if need be, and charges only what it
transcribed.

### Good to know

- Whisper writes what it hears: names, brands, slang and fast speech can come out as the wrong
  characters, Whisper base more often than small. Speakers aren't told apart, and captions burned into the video aren't read,
  only speech.
- Chinese is written in Simplified characters, converted from Whisper's output, which mixes in
  Traditional ones.
- A run transcribes about 3 minutes of audio a minute with Whisper small at the default 4 GB of
  memory, and about 8 with Whisper base. More memory is faster, at the same price per minute.
- Videos are read one by one, by URL or ID; a creator's whole profile, search results and
  comments aren't read.
- Deleted, private and friends-only videos can't be read; the result says so.
- A video given twice in one run is transcribed once.

### FAQ

#### Is it legal to transcribe Douyin videos?

It reads only what Douyin shows publicly, without logging in. Videos are their creators'
copyrighted work: a transcript for your own research, analysis or accessibility is often
allowed, depending on your country's copyright law, but republishing it may need the rights
holder's permission, and personal data in it is protected by laws such as the GDPR, the CCPA
and China's PIPL. [Douyin's user agreement](https://www.douyin.com/draft/douyin_agreement/douyin_agreement_user.html) prohibits crawlers, and your use of it is your own responsibility. If you're unsure,
ask a lawyer; Apify's [Is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/) is a
good start.

Not affiliated with Douyin or ByteDance; their names are trademarks of their owners.

#### Something missing or not working?

Open an issue on the **Issues** tab with the input you used, or ask there for a field you need.

If it does what you need, a review on the **Reviews** tab helps others find it.

#### Transcripts from other sites?

[YouTube](https://apify.com/pikoulas/youtube-transcripts), [TikTok](https://apify.com/pikoulas/tiktok-transcripts), [Instagram Reels](https://apify.com/pikoulas/instagram-transcripts), [podcasts (Apple Podcasts and RSS)](https://apify.com/pikoulas/podcast-transcripts) and [any other video or audio URL](https://apify.com/pikoulas/video-transcriber) each have an Actor of their own.

# Actor input Schema

## `urls` (type: `array`):

Douyin video URLs (www.douyin.com/video/..., or a page with ?modal_id=...), share links (v.douyin.com/..., or the whole text the app's Share button copies) or video IDs.

## `maxMinutesPerVideo` (type: `integer`):

Transcribes only each video's first minutes, and charges only those. Empty: whole videos.

## `model` (type: `string`):

Whisper base is fast and good on clear speech. Whisper small is more accurate, on Mandarin above all, takes about three times as long and costs $0.008 per started minute against base's $0.003 ($0.016 and $0.006 on Apify's free plan).

## `language` (type: `string`):

The language spoken, as a code (zh, en, ja...), when all the videos share one. Empty: detected for each video. Chinese comes out in Simplified characters.

## `includeTimestamps` (type: `boolean`):

Adds the transcript as segments with their start and end in seconds, next to the plain text.

## `proxyConfiguration` (type: `object`):

Not needed: when Douyin refuses the run's IP, it switches to Apify's residential proxy by itself. Used for Douyin's pages, never for the video files.

## Actor input object example

```json
{
  "urls": [
    "https://www.douyin.com/video/7702256834182253862"
  ],
  "model": "small",
  "language": "",
  "includeTimestamps": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://www.douyin.com/video/7702256834182253862"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("pikoulas/douyin-transcripts").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "urls": ["https://www.douyin.com/video/7702256834182253862"] }

# Run the Actor and wait for it to finish
run = client.actor("pikoulas/douyin-transcripts").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://www.douyin.com/video/7702256834182253862"
  ]
}' |
apify call pikoulas/douyin-transcripts --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,pikoulas/douyin-transcripts"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/juhIFEKOugtKaskVk/builds/KNpi4tsddbbDP6wS8/openapi.json
