Douyin Account short dramas API

List the short dramas a Douyin author published by user_id, one row per drama: name, status_text, episode_count, is_paid and created_at, for $0.79 per 1,000 calls.

  • The row fields are the same as in series_detail.
  • sub_genres is often missing here, so use series_detail for it.
  • Failed calls and empty results are not charged.

API health

24h health
Normal
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Normal

Last 24 hours

Last 30 days

  1. 1Request

    POST /api/v1/social
    {
      "platform": "douyin",
      "action": "user_series",
      "params": {
        "user_id": "https://www.douyin.com/user/MS4wLjABAAAAxKtExlVPfMALHjIWbFLJ1HhhJUebELJXNU6UQw42-kY"
      }
    }
  2. 2JSON response

    {
      "results": [
        {
          "author_uid": "",
          "series_id": "7709817571482011689",
          "name": "短剧 · 远赴边城相见,才知他另有牵挂",
          "description": "结婚五年、求子多年的林茵终于等来怀孕。她揣着孕检单坐了二十多个小时车,去西北边城给驻守项目的丈夫贺临惊喜,却在挂满红灯笼的小院里听见另一个孩子喊他爸爸。贺临解释是报答救命恩人、照顾工友遗孀。林茵从画册、照片和招待所登记本里,一点点拼出他在边城的四年。她藏起孕检单追问到项目部,真相浮出——安安与贺临、许曼关系不简单。她不再哭闹,面对以孩子为由的挽留和长辈劝说,她会如何选择?"
        },
        …
      ],
      "count": 20
    }
  3. 3Rows

    author_uidseries_idnamedescription
    7709817571482011689短剧 · 远赴边城相见,才知他另有牵挂结婚五年、求子多年的林茵终于等来怀孕。她揣着孕检单坐了二十多个小时车,去西北边城给驻守项目的丈夫贺临惊喜,却在挂满红灯笼的小院里听见另一个孩子喊他爸爸。贺临解释是报答救命恩人、照顾工友遗孀。林茵从画册、照片和招待所登记本里,一点点拼出他在边城的四年。她藏起孕检单追问到项目部,真相浮出——安安与贺临、许曼关系不简单。她不再哭闹,面对以孩子为由的挽留和长辈劝说,她会如何选择?
    7709794114602010678短剧 · 我大专毕业当柜姐,亮出实力后他们慌了大专毕业的苏念隐去家世,在珠宝店做柜姐,实则是雕刻泰斗苏万钧的孙女,承袭一手月牙雕刻绝技。她凭实力拿下大客户,却因戳破前男友未婚妻高价买下注油祖母绿的真相,遭投诉刁难。结识方家后,她受邀做订婚宴珠宝顾问,却在鉴定藏品时发现有人调包变卖。停职危机压来,她不肯低头——而鉴赏会上,那个姓氏背后的秘密,才刚刚浮出水面。
  4. 4CSV

    douyin-user_series-sample.csv series_id,name,description,url,cover_image_url,genres,sub_genres,status_text,episode_count,updated_to_episode,play_count,collect_count,is_paid,paid_episode_count,episode_price_cny,full_price_cny,icp_number,author_id,author_uid,author_name,author_douyin_id,author_avatar_url,author_is_verified,author_follower_count,created_at,updated_at,last_episode_at,platform

A request with user_id goes in, and one page of that author's short dramas comes back; each row in results is one drama, listed as a field table and a CSV file.

What data you get

The table shows a real call for douyin.com/user/MS4wLjABAAAAxKtExlVPfMALHjIWbFLJ1HhhJUebELJXNU6UQw42-kY, captured November 21, 2026 at 07:17 (UTC), that returned 20 rows; gray bars mark removed personal information (••• in the CSV). Your own calls return these fields as listed in the field reference.

series_idnamedescriptionurlcover_image_urlgenressub_genresstatus_textepisode_countupdated_to_episodeplay_countcollect_countis_paidpaid_episode_countepisode_price_cnyfull_price_cnyicp_numberauthor_idauthor_uidauthor_nameauthor_douyin_idauthor_avatar_urlauthor_is_verifiedauthor_follower_countcreated_atupdated_atlast_episode_atplatform
7709817571482011689短剧 · 远赴边城相见,才知他另有牵挂结婚五年、求子多年的林茵终于等来怀孕。她揣着孕检单坐了二十多个小时车,去西北边城给驻守项目的丈夫贺临惊喜,却在挂满红灯笼的小院里听见另一个孩子喊他爸爸。贺临解释是报答救命恩人、照顾工友遗孀。林茵从画册、照片和招待所登记本里,一点点拼出他在边城的四年。她藏起孕检单追问到项目部,真相浮出——安安与贺临、许曼关系不简单。她不再哭闹,面对以孩子为由的挽留和长辈劝说,她会如何选择?https://www.iesdouyin.com/share/playlet/detail/7709817571482011689/?schema_type=43&object_id=7709817571482011689&from_ssr=1https://p3-sign.douyinpic.com/tos-cn-i-dy/b78f360b14c95f2af5ee2ac6868adb59~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1795417200&x-signature=GMqnVuqf2dF9fu4Dqn67sGSaVLc%3D&from=4080365293&s=PackSourceEnum_SERIES_PUBLISH&se=false&sc=series_cover&biz_tag=aw…["其他"]nullnull67000true66nullnull(抖音)微短剧备字(2026)第116470号MS4wLjABAAAAxKtExlVPfMALHjIWbFLJ1HhhJUebELJXNU6UQw42-kY月•••场true02026-11-19T09:49:47+00:002026-11-20T10:08:46+00:002026-11-19T10:30:33+00:00douyin
7709794114602010678短剧 · 我大专毕业当柜姐,亮出实力后他们慌了大专毕业的苏念隐去家世,在珠宝店做柜姐,实则是雕刻泰斗苏万钧的孙女,承袭一手月牙雕刻绝技。她凭实力拿下大客户,却因戳破前男友未婚妻高价买下注油祖母绿的真相,遭投诉刁难。结识方家后,她受邀做订婚宴珠宝顾问,却在鉴定藏品时发现有人调包变卖。停职危机压来,她不肯低头——而鉴赏会上,那个姓氏背后的秘密,才刚刚浮出水面。https://www.iesdouyin.com/share/playlet/detail/7709794114602010678/?schema_type=43&object_id=7709794114602010678&from_ssr=1https://p3-sign.douyinpic.com/tos-cn-i-dy/56aefa2df51ff3eed392f5c4730b17ef~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1795417200&x-signature=hLrAC3m%2BXRdN%2BSDVWSL9yEUBCpM%3D&from=4080365293&s=PackSourceEnum_SERIES_PUBLISH&se=false&sc=series_cover&biz_ta…["其他"]nullnull96000true95nullnull(抖音)微短剧备字(2026)第115873号MS4wLjABAAAAxKtExlVPfMALHjIWbFLJ1HhhJUebELJXNU6UQw42-kY月•••场true02026-11-19T08:18:46+00:002026-11-20T11:03:07+00:002026-11-19T08:32:27+00:00douyin

Use cases

  • List the dramas of a producer account

    Read name, episode_count and is_paid of each drama under an author to see how many the author made and which ones are paid.

  • Track new releases

    Read created_at and last_episode_at on a schedule to see whether a new drama or a new episode appeared.

  • Compare prices from one author

    Read episode_price_cny and full_price_cny of the paid dramas and compare the prices.

  • Read details and episodes next

    Pass series_id to series_detail for the details or to series_posts for the episodes.

Douyin Open Platform vs EveryInfra

Here is how the Douyin Open Platform documentation and EveryInfra user_series compare on what you need to connect.

ComparedDouyin Open PlatformEveryInfra
Access you needThe documentation says that third-party developers who have applied for the user management permission and have the user's authorization can get the matching data.One EveryInfra API key in the Authorization: Bearer header. The request carries only user_id, and the author does not need to authorize anything.

The Douyin Open Platform documentation is in Chinese. The table shows a translation, checked against the page on 2026-11-22. The page shows no update date. The Open Platform short drama documentation is about mini apps that host their own episodes. It has no endpoint that lists the dramas of an author, so this row compares only what you need to connect. Official sources: User information access solution

Limits and gotchas

  • user_id is required: the secUid of a Douyin user (it starts with MS4w) or a profile link https://www.douyin.com/user/<secUid>. A nickname, a Douyin ID and a short link are not accepted.
  • One call returns one page, and the page may hold fewer rows than usual. To get the next page, pass next_page_token back as page_token and keep the other parameters. The token is valid for 24 hours, and the last page has no next_page_token.
  • sub_genres is often missing here. When it is missing, the row has no sub_genres key. Use series_detail when you need it.
  • Only paid dramas carry episode_price_cny and full_price_cny, in yuan. play_count is not a real play count, and a value of 0 does not mean nobody watched.
  • status_text is the update status text as the Douyin page shows it, and some dramas have none.

Pricing

You pay $0.000792 per call, not per row. One call returns one page, so each page you read counts as one call. Failed calls and empty results are not charged.

CallsCost
10,000$7.92
100,000$79.17
1,000,000$791.67

Totals use the list price per call.

Code samples

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "douyin",
  "action": "user_series",
  "params": {
    "user_id": "https://www.douyin.com/user/MS4wLjABAAAAxKtExlVPfMALHjIWbFLJ1HhhJUebELJXNU6UQw42-kY"
  }
}'

OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

API reference

See the parameters, response fields, errors and billing for user_series, and copy the page or open it as Markdown for an AI assistant.

POST

AI prompt

#
Please help me write a data collection script with the EveryInfra Douyin Account short dramas endpoint (douyin/user_series).

How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to douyin and action to user_series, and put the parameters inside params.
- Required parameters:
  - user_id: The account whose short dramas you want: its secUid (starting MS4w) or a profile link https://www.douyin.com/user/<secUid>. Nicknames, Douyin IDs and short links are not accepted.
- Optional parameters:
  - page_token: Page token for user_series. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, keeping the other inputs unchanged. Tokens last 24 hours.
- Returns a list of records. Main fields of each record: series_id, name (Name of the collection (user_mixes)), description (Description of the collection (user_mix…), url, cover_image_url (Cover image URL: the cover of a video o…), genres, sub_genres, status_text, episode_count (How many episodes the collection has (u…), updated_to_episode, play_count (Real only on Hot Spot Treasure and mixes), collect_count; 27 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Example request body:
{
  "platform": "douyin",
  "action": "user_series",
  "params": {
    "user_id": "https://www.douyin.com/user/MS4wLjABAAAAxKtExlVPfMALHjIWbFLJ1HhhJUebELJXNU6UQw42-kY"
  }
}
- Price: $0.79 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.

Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.

Request parameters

#
NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYesdouyinPlatform identifier, fixed value.
actionbodystringYesuser_seriesCapability identifier, fixed value.
user_idbody.paramsstringYes-The account whose short dramas you want: its secUid (starting MS4w) or a profile link https://www.douyin.com/user/<secUid>. Nicknames, Douyin IDs and short links are not accepted.
page_tokenbody.paramsstringNo-Page token for user_series. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, keeping the other inputs unchanged. Tokens last 24 hours; the last page has no next_page_token. A page holds up to 20 dramas.

Response example

#
Captured November 21, 2026 at 07:17 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2. id, billing and quota differ on every call, so only their shape is shown.
json
{  "id": "req_…",  "platform": "douyin",  "action": "user_series",  "results": [    {      "series_id": "7709817571482011689",      "name": "短剧 · 远赴边城相见,才知他另有牵挂",      "description": "结婚五年、求子多年的林茵终于等来怀孕。她揣着孕检单坐了二十多个小时车,去西北边城给驻守项目的丈夫贺临惊喜,却在挂满红灯笼的小院里听见另一个孩子喊他爸爸。贺临解释是报答救命恩人、照顾工友遗孀。林茵从画册、照片和招待所登记本里,一点点拼出他在边城的四年。她藏起孕检单追问到项目部,真相浮出——安安与贺临、许曼关系不简单。她不再哭闹,面对以孩子为由的挽留和长辈劝说,她会如何选择?",      "url": "https://www.iesdouyin.com/share/playlet/detail/7709817571482011689/?schema_type=43&object_id=7709817571482011689&from_ssr=1",      "cover_image_url": "https://p3-sign.douyinpic.com/tos-cn-i-dy/b78f360b14c95f2af5ee2ac6868adb59~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1795417200&x-signature=GMqnVuqf2dF9fu4Dqn67sGSaVLc%3D&from=4080365293&s=PackSourceEnum_SERIES_PUBLISH&se=false&sc=series_cover&biz_tag=aw…",      "genres": [        "其他"      ],      "episode_count": 67,      "updated_to_episode": 0,      "play_count": 0,      "collect_count": 0,      "is_paid": true,      "paid_episode_count": 66,      "icp_number": "(抖音)微短剧备字(2026)第116470号",      "author_id": "MS4wLjABAAAAxKtExlVPfMALHjIWbFLJ1HhhJUebELJXNU6UQw42-kY",      "author_uid": "•••",      "author_name": "月•••场",      "author_douyin_id": "•••",      "author_avatar_url": "https://p3-pc.douyinpic.com/•••",      "author_is_verified": true,      "author_follower_count": 0,      "created_at": "2026-11-19T09:49:47+00:00",      "updated_at": "2026-11-20T10:08:46+00:00",      "last_episode_at": "2026-11-19T10:30:33+00:00",      "platform": "douyin"    },    {      "series_id": "7709794114602010678",      "name": "短剧 · 我大专毕业当柜姐,亮出实力后他们慌了",      "description": "大专毕业的苏念隐去家世,在珠宝店做柜姐,实则是雕刻泰斗苏万钧的孙女,承袭一手月牙雕刻绝技。她凭实力拿下大客户,却因戳破前男友未婚妻高价买下注油祖母绿的真相,遭投诉刁难。结识方家后,她受邀做订婚宴珠宝顾问,却在鉴定藏品时发现有人调包变卖。停职危机压来,她不肯低头——而鉴赏会上,那个姓氏背后的秘密,才刚刚浮出水面。",      "url": "https://www.iesdouyin.com/share/playlet/detail/7709794114602010678/?schema_type=43&object_id=7709794114602010678&from_ssr=1",      "cover_image_url": "https://p3-sign.douyinpic.com/tos-cn-i-dy/56aefa2df51ff3eed392f5c4730b17ef~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1795417200&x-signature=hLrAC3m%2BXRdN%2BSDVWSL9yEUBCpM%3D&from=4080365293&s=PackSourceEnum_SERIES_PUBLISH&se=false&sc=series_cover&biz_ta…",      "genres": [        "其他"      ],      "episode_count": 96,      "updated_to_episode": 0,      "play_count": 0,      "collect_count": 0,      "is_paid": true,      "paid_episode_count": 95,      "icp_number": "(抖音)微短剧备字(2026)第115873号",      "author_id": "MS4wLjABAAAAxKtExlVPfMALHjIWbFLJ1HhhJUebELJXNU6UQw42-kY",      "author_uid": "•••",      "author_name": "月•••场",      "author_douyin_id": "•••",      "author_avatar_url": "https://p3-pc.douyinpic.com/•••",      "author_is_verified": true,      "author_follower_count": 0,      "created_at": "2026-11-19T08:18:46+00:00",      "updated_at": "2026-11-20T11:03:07+00:00",      "last_episode_at": "2026-11-19T08:32:27+00:00",      "platform": "douyin"    }  ],  "next_page_token": …,  "pagination": { … },  "count": 20,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Response fields

#

Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.

FieldMeaning
series_idKeeps the platform's own meaning
nameName of the collection (user_mixes).
descriptionDescription of the collection (user_mixes).
urlLink to the record on the platform.
cover_image_urlCover image URL: the cover of a video or image post on search, user_posts, posts_batch, related_posts, mix_posts, music_posts and media_links rows; the music cover on music_search and music_detail; the topic image on billboard_topic_hot; the collection cover on user_mixes; the room cover on live_room. Signed links expire.
genresKeeps the platform's own meaning
sub_genresKeeps the platform's own meaning
status_textKeeps the platform's own meaning
episode_countHow many episodes the collection has (user_mixes).
updated_to_episodeKeeps the platform's own meaning
play_countReal only on Hot Spot Treasure and mixes. On the boards billboard_video_hot, billboard_low_fan_explosion and billboard_high_completion it is Douyin's own play figure. On mix_posts it is the plays of that episode, and on user_mixes the plays of the whole collection. Elsewhere Douyin does not publish play counts, so the value is usually 0 and does not reflect real plays; judge reach by likes, comments and shares.
collect_countSaves or favorites. null means not disclosed, not 0.
is_paidKeeps the platform's own meaning
paid_episode_countKeeps the platform's own meaning
episode_price_cnyKeeps the platform's own meaning
full_price_cnyKeeps the platform's own meaning
icp_numberKeeps the platform's own meaning
author_idAuthor's unique ID on the platform.
author_uidNumeric user ID of the author (on comments, of the commenter). author_id is the secUid; both identify the same person.
author_nameAuthor's display name.
author_douyin_idThe author's Douyin ID.
author_avatar_urlAuthor avatar image URL: the creator on search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows, the host on live_room, the commenter on comments rows.
author_is_verifiedWhether the author is verified (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows; on live_room, whether the host is; on comments rows, whether the commenter is).
author_follower_countAuthor's follower count. null means not disclosed.
created_atCreation time, same format as posted_at.
updated_atWhen the collection was last updated (user_mixes, ISO 8601, UTC).
last_episode_atKeeps the platform's own meaning
platformSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).

Errors and billing

#
401
Missing or invalid key.
402
Insufficient balance. Top up first.
422
Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
429
Per-minute request limit reached. Wait for Retry-After, then try again.
503
Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
200 empty
No data. No charge.

Errors

FAQ

What does the Douyin author short dramas API return?

One row per drama: series_id, name, description, url, genres, status_text, episode_count, updated_to_episode, play_count, collect_count, is_paid, created_at, updated_at and last_episode_at, price fields for paid dramas, and author fields.

How do I read the episodes of one drama?

Pass the series_id of a row to series_posts. It returns one row per episode.

How much does one page of dramas cost?

It costs $0.000792 per call, or $0.79 per 1,000 calls, billed per call and not per row. Failed calls and empty results are not charged.

You can call the other Douyin endpoints with the same EveryInfra API key.

Google Analytics needs consent. Privacy