Douyin Short-drama details API

Read one Douyin short drama by series_id: name, description, episode_count, updated_to_episode and collect_count, plus the paid episode count and prices for paid dramas, for $0.79 per 1,000 calls.

  • icp_number is the filing number of the drama.
  • last_episode_at is the publish time of the latest episode.
  • 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": "series_detail",
      "params": {
        "series_id": "7703828515069626394"
      }
    }
  2. 2JSON response

    {
      "results": {
        "author_id": "",
        "series_id": "7703828515069626394",
        "name": "短剧 · 温柔以待,终有回甘",
        "description": "中秋夜,林哲与前妻的儿子林屿浑身湿透找上门,怯生生问能不能借住两天。苏晚挺着孕肚拉住他,说这是你爸的家,想住就住。她发现孩子面黄肌瘦,得知前妻宋丽纵容现任丈夫苛待亲生儿子,便要求林哲降低抚养费,把钱直接花在林屿身上。国庆期间,林屿又遭张浩驱赶出门。苏晚挺着孕肚带他回公司讨说法,宋丽大闹,自称身份不凡。苏晚亮明身份,张浩——她父亲曾经的司机——当场愣住。混乱中,苏晚摔倒了。",
        …
      }
    }
  3. 3Fields

    author_idseries_idnamedescription
    7703828515069626394短剧 · 温柔以待,终有回甘中秋夜,林哲与前妻的儿子林屿浑身湿透找上门,怯生生问能不能借住两天。苏晚挺着孕肚拉住他,说这是你爸的家,想住就住。她发现孩子面黄肌瘦,得知前妻宋丽纵容现任丈夫苛待亲生儿子,便要求林哲降低抚养费,把钱直接花在林屿身上。国庆期间,林屿又遭张浩驱赶出门。苏晚挺着孕肚带他回公司讨说法,宋丽大闹,自称身份不凡。苏晚亮明身份,张浩——她父亲曾经的司机——当场愣住。混乱中,苏晚摔倒了。
  4. 4CSV

    douyin-series_detail-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 series_id goes in, and one JSON object comes back with fields such as name and episode_count, listed as a field table and a CSV file.

What data you get

The table shows a real call for 7703828515069626394, captured November 21, 2026 at 07:17 (UTC), that returned one object; 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
7703828515069626394短剧 · 温柔以待,终有回甘中秋夜,林哲与前妻的儿子林屿浑身湿透找上门,怯生生问能不能借住两天。苏晚挺着孕肚拉住他,说这是你爸的家,想住就住。她发现孩子面黄肌瘦,得知前妻宋丽纵容现任丈夫苛待亲生儿子,便要求林哲降低抚养费,把钱直接花在林屿身上。国庆期间,林屿又遭张浩驱赶出门。苏晚挺着孕肚带他回公司讨说法,宋丽大闹,自称身份不凡。苏晚亮明身份,张浩——她父亲曾经的司机——当场愣住。混乱中,苏晚摔倒了。https://www.iesdouyin.com/share/playlet/detail/7703828515069626394/?schema_type=43&object_id=7703828515069626394&from_ssr=1https://p3-sign.douyinpic.com/tos-cn-i-dy/63264312790795d05be78f3f6237f7dd~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1795417200&x-signature=LTQ11M24SRFxEsSP3vO2ltpC81Y%3D&from=4080365293&s=PackSourceEnum_SERIES_DETAIL&se=false&sc=series_cover&biz_tag=awe…["其他"]["家长里短","都市日常"]84集全84848940936301162009true821.298.4(抖音)微短剧备字(2026)第061503号月•••场true02026-11-03T06:29:11+00:002026-11-17T06:15:00+00:002026-11-03T06:53:04+00:00douyin

Use cases

  • Check the size of a drama

    Read episode_count and collect_count to see how many episodes a drama has and how often it was saved. play_count is not a real play count, so do not use it to compare size.

  • Tell whether a drama is finished

    Compare episode_count with updated_to_episode, then read the update status in status_text.

  • Work out what it costs to finish

    For a paid drama, read paid_episode_count and episode_price_cny, or read full_price_cny, the price of all paid episodes together.

  • Get the genre right

    The rows of user_series often lack sub_genres. Read genres and sub_genres here instead.

Douyin Open Platform vs EveryInfra

Here is how the Douyin Open Platform documentation and EveryInfra series_detail 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 series_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 reads the details of any public drama, so this row compares only what you need to connect. Official sources: User information access solution

Limits and gotchas

  • series_id is required: the numeric ID of a short drama, taken from the series_id of a series_feed or user_series row. A share link https://www.iesdouyin.com/share/playlet/detail/<ID> is also accepted.
  • One call reads one drama and returns one object. Use series_posts to get the episodes.
  • Only paid dramas carry paid_episode_count, episode_price_cny and full_price_cny, in yuan. Free dramas do not have these keys.
  • genres and sub_genres hold the genre names as Douyin gives them, in Chinese. icp_number is the filing number of the drama.
  • created_at, updated_at and last_episode_at are ISO 8601 times in UTC.

Pricing

You pay $0.000792 per call, not per field. One call reads one drama. 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": "series_detail",
  "params": {
    "series_id": "7703828515069626394"
  }
}'

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 series_detail, 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 Short-drama details endpoint (douyin/series_detail).

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 series_detail, and put the parameters inside params.
- Required parameters:
  - series_id: A numeric Douyin short-drama ID, from the series_id of series_feed or user_series rows; a short-drama share link also works.
- Returns one object. Main fields: 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": "series_detail",
  "params": {
    "series_id": "7703828515069626394"
  }
}
- 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.
actionbodystringYesseries_detailCapability identifier, fixed value.
series_idbody.paramsstringYes-A numeric Douyin short-drama ID, from the series_id of series_feed or user_series rows; a short-drama share link also works.

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. id, billing and quota differ on every call, so only their shape is shown.
json
{  "id": "req_…",  "platform": "douyin",  "action": "series_detail",  "results": {    "series_id": "7703828515069626394",    "name": "短剧 · 温柔以待,终有回甘",    "description": "中秋夜,林哲与前妻的儿子林屿浑身湿透找上门,怯生生问能不能借住两天。苏晚挺着孕肚拉住他,说这是你爸的家,想住就住。她发现孩子面黄肌瘦,得知前妻宋丽纵容现任丈夫苛待亲生儿子,便要求林哲降低抚养费,把钱直接花在林屿身上。国庆期间,林屿又遭张浩驱赶出门。苏晚挺着孕肚带他回公司讨说法,宋丽大闹,自称身份不凡。苏晚亮明身份,张浩——她父亲曾经的司机——当场愣住。混乱中,苏晚摔倒了。",    "url": "https://www.iesdouyin.com/share/playlet/detail/7703828515069626394/?schema_type=43&object_id=7703828515069626394&from_ssr=1",    "cover_image_url": "https://p3-sign.douyinpic.com/tos-cn-i-dy/63264312790795d05be78f3f6237f7dd~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1795417200&x-signature=LTQ11M24SRFxEsSP3vO2ltpC81Y%3D&from=4080365293&s=PackSourceEnum_SERIES_DETAIL&se=false&sc=series_cover&biz_tag=awe…",    "genres": [      "其他"    ],    "sub_genres": [      "家长里短",      "都市日常"    ],    "status_text": "84集全",    "episode_count": 84,    "updated_to_episode": 84,    "play_count": 894093630,    "collect_count": 1162009,    "is_paid": true,    "paid_episode_count": 82,    "episode_price_cny": 1.2,    "full_price_cny": 98.4,    "icp_number": "(抖音)微短剧备字(2026)第061503号",    "author_id": "•••",    "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-03T06:29:11+00:00",    "updated_at": "2026-11-17T06:15:00+00:00",    "last_episode_at": "2026-11-03T06:53:04+00:00",    "platform": "douyin"  },  "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 short drama detail API return?

One object: series_id, name, description, url, genres, sub_genres, status_text, episode_count, updated_to_episode, play_count, collect_count, is_paid, icp_number and last_episode_at, price fields for paid dramas, and author fields.

How do I read the episodes of a drama?

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

How much does it cost to read one drama?

It costs $0.000792 per call, or $0.79 per 1,000 calls, billed per call and not per field. 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