Douyin Short-drama episodes API

Read the episodes of a Douyin short drama by series_id, one row per episode: episode, is_paid, duration_seconds, like_count and comment_count, for $0.79 per 1,000 calls.

  • is_paid shows whether an episode is paid.
  • The video link of a paid episode is encrypted and will not play after download.
  • 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_posts",
      "params": {
        "series_id": "7703828515069626394"
      }
    }
  2. 2JSON response

    {
      "results": [
        {
          "author_name": "月•••场",
          "text": "《温柔以待,终有回甘》 【现代温情】中秋夜继子浑身湿透怯生生敲门,挺着孕肚的她一把拉住:这是你爸的家,想住就住!面黄肌瘦、衣服不合身,每周只给五十块生活费——这孩子从没吃饱过!短剧《温柔以待,终有回甘》#因为一个片段看了整部剧 #抖音短剧新番计划 #短剧 #家庭 #温柔以待终有回甘",
          "media_type": "video",
          "video_url": "https://v3-dy-o.zjcdn.com/3da3ae87fce4e8ff5906f075906cf14d/6b0297c1/video/tos/cn/tos-cn-ve-15/ow29BfeGEIfI7sVBaSUUP0PvtCwA9I5iLQWxEA/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1226&bt=1226&cs=0&ds=4&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…"
        },
        …
      ],
      "count": 20
    }
  3. 3Rows

    author_nametextmedia_typevideo_url
    月•••场《温柔以待,终有回甘》 【现代温情】中秋夜继子浑身湿透怯生生敲门,挺着孕肚的她一把拉住:这是你爸的家,想住就住!面黄肌瘦、衣服不合身,每周只给五十块生活费——这孩子从没吃饱过!短剧《温柔以待,终有回甘》#因为一个片段看了整部剧 #抖音短剧新番计划 #短剧 #家庭 #温柔以待终有回甘videohttps://v3-dy-o.zjcdn.com/3da3ae87fce4e8ff5906f075906cf14d/6b0297c1/video/tos/cn/tos-cn-ve-15/ow29BfeGEIfI7sVBaSUUP0PvtCwA9I5iLQWxEA/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1226&bt=1226&cs=0&ds=4&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…
    月•••场《温柔以待,终有回甘》 【现代温情】中秋夜继子浑身湿透怯生生敲门,挺着孕肚的她一把拉住:这是你爸的家,想住就住!面黄肌瘦、衣服不合身,每周只给五十块生活费——这孩子从没吃饱过!短剧《温柔以待,终有回甘》#因为一个片段看了整部剧 #抖音短剧新番计划 #短剧 #家庭 #温柔以待终有回甘videohttps://v3-dy-o.zjcdn.com/c0b2281c06c2d8fd0cb479c4a5cecc16/6b029765/video/tos/cn/tos-cn-ve-15/oQvCJf7eXt7VLBArI5697WsGAIWBaoQB5f0OEF/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1274&bt=1274&cs=0&ds=4&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…
  4. 4CSV

    douyin-series_posts-sample.csv id,url,text,media_type,video_url,like_count,comment_count,share_count,collect_count,author_name,author_id,author_douyin_id,author_bio,author_avatar_url,author_follower_count,author_following_count,author_like_count,author_video_count,author_is_verified,cover_image_url,video_width,video_height,video_bitrates,has_watermark,duration_sec,duration_seconds,hashtags,posted_at,title,music,location,image_urls,is_deleted,is_private,platform,episode,series_id,is_paid

A request with series_id goes in, and one page of episodes of that drama comes back; each row in results is one episode, 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 20 rows; gray bars mark removed personal information (••• in the CSV). Your own calls return these fields as listed in the field reference.

idurltextmedia_typevideo_urllike_countcomment_countshare_countcollect_countauthor_nameauthor_idauthor_douyin_idauthor_bioauthor_avatar_urlauthor_follower_countauthor_following_countauthor_like_countauthor_video_countauthor_is_verifiedcover_image_urlvideo_widthvideo_heightvideo_bitrateshas_watermarkduration_secduration_secondshashtagsposted_attitlemusiclocationimage_urlsis_deletedis_privateplatformepisodeseries_idis_paid
https://www.douyin.com/video/7703828500301565211《温柔以待,终有回甘》 【现代温情】中秋夜继子浑身湿透怯生生敲门,挺着孕肚的她一把拉住:这是你爸的家,想住就住!面黄肌瘦、衣服不合身,每周只给五十块生活费——这孩子从没吃饱过!短剧《温柔以待,终有回甘》#因为一个片段看了整部剧 #抖音短剧新番计划 #短剧 #家庭 #温柔以待终有回甘videohttps://v3-dy-o.zjcdn.com/3da3ae87fce4e8ff5906f075906cf14d/6b0297c1/video/tos/cn/tos-cn-ve-15/ow29BfeGEIfI7sVBaSUUP0PvtCwA9I5iLQWxEA/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1226&bt=1226&cs=0&ds=4&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…879891574725845233月•••场0000truehttps://p3-pc-sign.douyinpic.com/image-cut-tos-priv/a5d7f7e3643ab1b2597d9413fa3cd08d~tplv-dy-resize-origshort-autoq-75:330.jpeg?lk3s=138a59ce&x-expires=2110604400&x-signature=H4X6sOZA0gfnw2QNCSNxSyOG03o%3D&from=327834062&s=PackSourceEnum_SERIES_AWEME&se=false&sc=cover&biz_tag=pcw…10801920[{"bitrate":1255744,"width":1080,"height":1920,"url":"https://v3-dy-o.zjcdn.com/3da3ae87fce4e8ff5906f075906cf14d/6b0297c1/video/tos/cn/tos-cn-ve-15/ow29BfeGEIfI7sVBaSUUP0PvtCwA9I5iLQWxEA/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1226&bt=1226&cs=0&ds=4&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…"},{"bitrate":1013582,"width":576,"height":1024,"url":"https://v3-dy-o.zjcdn.com/20e5ebf4086fb947fa3914d3500a1951/6b0297c1/video/tos/cn/tos-cn-ve-15/o0L5WSpV0A0sBPxQIf9vH7NCE4teEAfMBaUAIG/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=989&bt=989&cs=0&ds=6&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs=0…"},{"bitrate":951491,"width":720,"height":1280,"url":"https://v3-dy-o.zjcdn.com/46718b45735e8a4044eed46901db081a/6b0297c1/video/tos/cn/tos-cn-ve-15/o0rw9gMxQXA5I1C0ogQEJfBiB9v887eSV33nAe/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=929&bt=929&cs=0&ds=3&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs=0…"}]false151151["因为一个片段看了整部剧","抖音短剧新番计划","短剧"]2026-11-06T02:00:07+00:00《温柔以待,终有回甘》 【现代温情】中秋夜继子浑身湿透怯生生敲门,挺着孕肚的她一把拉住:这是你爸的家,想住就住!面黄肌瘦、衣服不合身,每周只给五十块生活费——这孩子从没吃饱过!短剧《温柔以待,终有回甘》#因为一个片段看了整部剧 #抖音短剧新番计划 #短剧 #家庭 #温柔以待终有回甘{"id":"•••","title":"@•••","author":"月•••场","is_original":true,"duration_sec":150,"cover_url":"https://p3-pc.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-i-ke512zj2cu_88d4450285154a308fd4e0afa6a580a9.jpeg?from=327834062","play_url":"https://sf6-cdn-tos.douyinstatic.com/obj/ies-music/7703828583453674281.mp3"}nullnullfalsefalsedouyin17703828515069626394false
https://www.douyin.com/video/7703828517959552290《温柔以待,终有回甘》 【现代温情】中秋夜继子浑身湿透怯生生敲门,挺着孕肚的她一把拉住:这是你爸的家,想住就住!面黄肌瘦、衣服不合身,每周只给五十块生活费——这孩子从没吃饱过!短剧《温柔以待,终有回甘》#因为一个片段看了整部剧 #抖音短剧新番计划 #短剧 #家庭 #温柔以待终有回甘videohttps://v3-dy-o.zjcdn.com/c0b2281c06c2d8fd0cb479c4a5cecc16/6b029765/video/tos/cn/tos-cn-ve-15/oQvCJf7eXt7VLBArI5697WsGAIWBaoQB5f0OEF/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1274&bt=1274&cs=0&ds=4&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…33380458164013467月•••场0000truehttps://p3-pc-sign.douyinpic.com/image-cut-tos-priv/ca39cf70869db9f0da75aef5f30e6b76~tplv-dy-resize-origshort-autoq-75:330.jpeg?lk3s=138a59ce&x-expires=2110604400&x-signature=yI88VOEPXUc0DWyDLWEDN1NZyNE%3D&from=327834062&s=PackSourceEnum_SERIES_AWEME&se=false&sc=cover&biz_tag=pcw…10801920[{"bitrate":1305274,"width":1080,"height":1920,"url":"https://v3-dy-o.zjcdn.com/c0b2281c06c2d8fd0cb479c4a5cecc16/6b029765/video/tos/cn/tos-cn-ve-15/oQvCJf7eXt7VLBArI5697WsGAIWBaoQB5f0OEF/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1274&bt=1274&cs=0&ds=4&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…"},{"bitrate":1036153,"width":576,"height":1024,"url":"https://v3-dy-o.zjcdn.com/f9e3ce47cb765892d8a5569819de4a12/6b029765/video/tos/cn/tos-cn-ve-15/oEZt7v6HVQaOBaBXNC0Xdf5QIfMgyjAf7A8hgD/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1011&bt=1011&cs=0&ds=6&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…"},{"bitrate":993216,"width":720,"height":1280,"url":"https://v3-dy-o.zjcdn.com/fea21356fc0e4e4e33eef91c93efffc8/6b029765/video/tos/cn/tos-cn-ve-15/o0eAHStpguAkfSAAit7Yo3f9fnf3zvXl6EH4Jq/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=969&bt=969&cs=0&ds=3&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs=0…"}]false5858["因为一个片段看了整部剧","抖音短剧新番计划","短剧"]2026-11-06T02:00:09+00:00《温柔以待,终有回甘》 【现代温情】中秋夜继子浑身湿透怯生生敲门,挺着孕肚的她一把拉住:这是你爸的家,想住就住!面黄肌瘦、衣服不合身,每周只给五十块生活费——这孩子从没吃饱过!短剧《温柔以待,终有回甘》#因为一个片段看了整部剧 #抖音短剧新番计划 #短剧 #家庭 #温柔以待终有回甘{"id":"•••","title":"@•••","author":"月•••场","is_original":true,"duration_sec":58,"cover_url":"https://p3-pc.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-i-ke512zj2cu_88d4450285154a308fd4e0afa6a580a9.jpeg?from=327834062","play_url":"https://sf6-cdn-tos.douyinstatic.com/obj/ies-music/7703828581427759891.mp3"}nullnullfalsefalsedouyin27703828515069626394false

Use cases

  • Compare engagement by episode

    Line the rows up by episode and compare like_count, comment_count and collect_count to see which episodes draw the most attention.

  • Find where payment starts

    Check from which episode is_paid becomes true, and compare it with paid_episode_count from series_detail.

  • Add up the running time

    Read duration_seconds for each episode and add them up to get the total running time of the drama.

  • Get the addresses of free episodes

    For episodes with is_paid set to false, take the address from url and video_url. video_url is signed and expires.

Douyin Open Platform vs EveryInfra

Here is how the Douyin Open Platform documentation and EveryInfra series_posts 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 episodes 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 returns one page in episode order, 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.
  • For an episode with is_paid set to true, the video link is encrypted and will not play after download.
  • episode starts at 1 and is the position of the episode in the drama.
  • video_url is signed and expires, so download it soon if you need to keep it.

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": "series_posts",
  "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_posts, 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 episodes endpoint (douyin/series_posts).

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_posts, 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.
- Optional parameters:
  - page_token: Page token for series_posts. 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: id, url, text, media_type (Media type: video, or image for image p…), video_url (Video playback URL (signed, expires), like_count, comment_count, share_count, collect_count, author_name, author_id, author_douyin_id (The author's Douyin ID); 37 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Example request body:
{
  "platform": "douyin",
  "action": "series_posts",
  "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_postsCapability 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.
page_tokenbody.paramsstringNo-Page token for series_posts. 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 episodes, in episode order.

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": "series_posts",  "results": [    {      "id": "•••",      "url": "https://www.douyin.com/video/7703828500301565211",      "text": "《温柔以待,终有回甘》 【现代温情】中秋夜继子浑身湿透怯生生敲门,挺着孕肚的她一把拉住:这是你爸的家,想住就住!面黄肌瘦、衣服不合身,每周只给五十块生活费——这孩子从没吃饱过!短剧《温柔以待,终有回甘》#因为一个片段看了整部剧 #抖音短剧新番计划 #短剧 #家庭 #温柔以待终有回甘",      "media_type": "video",      "video_url": "https://v3-dy-o.zjcdn.com/3da3ae87fce4e8ff5906f075906cf14d/6b0297c1/video/tos/cn/tos-cn-ve-15/ow29BfeGEIfI7sVBaSUUP0PvtCwA9I5iLQWxEA/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1226&bt=1226&cs=0&ds=4&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…",      "like_count": 87989,      "comment_count": 1574,      "share_count": 7258,      "collect_count": 45233,      "author_name": "月•••场",      "author_id": "•••",      "author_douyin_id": "•••",      "author_bio": "•••",      "author_avatar_url": "https://p3-pc.douyinpic.com/•••",      "author_follower_count": 0,      "author_following_count": 0,      "author_like_count": 0,      "author_video_count": 0,      "author_is_verified": true,      "cover_image_url": "https://p3-pc-sign.douyinpic.com/image-cut-tos-priv/a5d7f7e3643ab1b2597d9413fa3cd08d~tplv-dy-resize-origshort-autoq-75:330.jpeg?lk3s=138a59ce&x-expires=2110604400&x-signature=H4X6sOZA0gfnw2QNCSNxSyOG03o%3D&from=327834062&s=PackSourceEnum_SERIES_AWEME&se=false&sc=cover&biz_tag=pcw…",      "video_width": 1080,      "video_height": 1920,      "video_bitrates": [        {          "bitrate": 1255744,          "width": 1080,          "height": 1920,          "url": "https://v3-dy-o.zjcdn.com/3da3ae87fce4e8ff5906f075906cf14d/6b0297c1/video/tos/cn/tos-cn-ve-15/ow29BfeGEIfI7sVBaSUUP0PvtCwA9I5iLQWxEA/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1226&bt=1226&cs=0&ds=4&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…"        },        {          "bitrate": 1013582,          "width": 576,          "height": 1024,          "url": "https://v3-dy-o.zjcdn.com/20e5ebf4086fb947fa3914d3500a1951/6b0297c1/video/tos/cn/tos-cn-ve-15/o0L5WSpV0A0sBPxQIf9vH7NCE4teEAfMBaUAIG/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=989&bt=989&cs=0&ds=6&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs=0…"        },        {          "bitrate": 951491,          "width": 720,          "height": 1280,          "url": "https://v3-dy-o.zjcdn.com/46718b45735e8a4044eed46901db081a/6b0297c1/video/tos/cn/tos-cn-ve-15/o0rw9gMxQXA5I1C0ogQEJfBiB9v887eSV33nAe/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=929&bt=929&cs=0&ds=3&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs=0…"        }      ],      "has_watermark": false,      "duration_sec": 151,      "hashtags": [        "因为一个片段看了整部剧",        "抖音短剧新番计划",        "短剧"      ],      "posted_at": "2026-11-06T02:00:07+00:00",      "title": "《温柔以待,终有回甘》 【现代温情】中秋夜继子浑身湿透怯生生敲门,挺着孕肚的她一把拉住:这是你爸的家,想住就住!面黄肌瘦、衣服不合身,每周只给五十块生活费——这孩子从没吃饱过!短剧《温柔以待,终有回甘》#因为一个片段看了整部剧 #抖音短剧新番计划 #短剧 #家庭 #温柔以待终有回甘",      "music": {        "id": "•••",        "title": "@•••",        "author": "月•••场",        "is_original": true,        "duration_sec": 150,        "cover_url": "https://p3-pc.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-i-ke512zj2cu_88d4450285154a308fd4e0afa6a580a9.jpeg?from=327834062",        "play_url": "https://sf6-cdn-tos.douyinstatic.com/obj/ies-music/7703828583453674281.mp3"      },      "is_deleted": false,      "is_private": false,      "platform": "douyin",      "episode": 1,      "series_id": "7703828515069626394",      "is_paid": false,      "duration_seconds": 151    },    {      "id": "•••",      "url": "https://www.douyin.com/video/7703828517959552290",      "text": "《温柔以待,终有回甘》 【现代温情】中秋夜继子浑身湿透怯生生敲门,挺着孕肚的她一把拉住:这是你爸的家,想住就住!面黄肌瘦、衣服不合身,每周只给五十块生活费——这孩子从没吃饱过!短剧《温柔以待,终有回甘》#因为一个片段看了整部剧 #抖音短剧新番计划 #短剧 #家庭 #温柔以待终有回甘",      "media_type": "video",      "video_url": "https://v3-dy-o.zjcdn.com/c0b2281c06c2d8fd0cb479c4a5cecc16/6b029765/video/tos/cn/tos-cn-ve-15/oQvCJf7eXt7VLBArI5697WsGAIWBaoQB5f0OEF/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1274&bt=1274&cs=0&ds=4&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…",      "like_count": 33380,      "comment_count": 458,      "share_count": 1640,      "collect_count": 13467,      "author_name": "月•••场",      "author_id": "•••",      "author_douyin_id": "•••",      "author_bio": "•••",      "author_avatar_url": "https://p3-pc.douyinpic.com/•••",      "author_follower_count": 0,      "author_following_count": 0,      "author_like_count": 0,      "author_video_count": 0,      "author_is_verified": true,      "cover_image_url": "https://p3-pc-sign.douyinpic.com/image-cut-tos-priv/ca39cf70869db9f0da75aef5f30e6b76~tplv-dy-resize-origshort-autoq-75:330.jpeg?lk3s=138a59ce&x-expires=2110604400&x-signature=yI88VOEPXUc0DWyDLWEDN1NZyNE%3D&from=327834062&s=PackSourceEnum_SERIES_AWEME&se=false&sc=cover&biz_tag=pcw…",      "video_width": 1080,      "video_height": 1920,      "video_bitrates": [        {          "bitrate": 1305274,          "width": 1080,          "height": 1920,          "url": "https://v3-dy-o.zjcdn.com/c0b2281c06c2d8fd0cb479c4a5cecc16/6b029765/video/tos/cn/tos-cn-ve-15/oQvCJf7eXt7VLBArI5697WsGAIWBaoQB5f0OEF/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1274&bt=1274&cs=0&ds=4&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…"        },        {          "bitrate": 1036153,          "width": 576,          "height": 1024,          "url": "https://v3-dy-o.zjcdn.com/f9e3ce47cb765892d8a5569819de4a12/6b029765/video/tos/cn/tos-cn-ve-15/oEZt7v6HVQaOBaBXNC0Xdf5QIfMgyjAf7A8hgD/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1011&bt=1011&cs=0&ds=6&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…"        },        {          "bitrate": 993216,          "width": 720,          "height": 1280,          "url": "https://v3-dy-o.zjcdn.com/fea21356fc0e4e4e33eef91c93efffc8/6b029765/video/tos/cn/tos-cn-ve-15/o0eAHStpguAkfSAAit7Yo3f9fnf3zvXl6EH4Jq/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=969&bt=969&cs=0&ds=3&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs=0…"        }      ],      "has_watermark": false,      "duration_sec": 58,      "hashtags": [        "因为一个片段看了整部剧",        "抖音短剧新番计划",        "短剧"      ],      "posted_at": "2026-11-06T02:00:09+00:00",      "title": "《温柔以待,终有回甘》 【现代温情】中秋夜继子浑身湿透怯生生敲门,挺着孕肚的她一把拉住:这是你爸的家,想住就住!面黄肌瘦、衣服不合身,每周只给五十块生活费——这孩子从没吃饱过!短剧《温柔以待,终有回甘》#因为一个片段看了整部剧 #抖音短剧新番计划 #短剧 #家庭 #温柔以待终有回甘",      "music": {        "id": "•••",        "title": "@•••",        "author": "月•••场",        "is_original": true,        "duration_sec": 58,        "cover_url": "https://p3-pc.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-i-ke512zj2cu_88d4450285154a308fd4e0afa6a580a9.jpeg?from=327834062",        "play_url": "https://sf6-cdn-tos.douyinstatic.com/obj/ies-music/7703828581427759891.mp3"      },      "is_deleted": false,      "is_private": false,      "platform": "douyin",      "episode": 2,      "series_id": "7703828515069626394",      "is_paid": false,      "duration_seconds": 58    }  ],  "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
idThe record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms.
urlLink to the record on the platform.
textBody text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so).
media_typeMedia type: video, or image for image posts.
video_urlVideo playback URL (signed, expires; download promptly if you need to keep it). Null for image posts or when the source omits it.
like_countLikes. null means the platform or this capability does not disclose it; it is not 0.
comment_countComments. null means not disclosed, not 0.
share_countShares. null means not disclosed, not 0.
collect_countSaves or favorites. null means not disclosed, not 0.
author_nameAuthor's display name.
author_idAuthor's unique ID on the platform.
author_douyin_idThe author's Douyin ID.
author_bioThe author's profile bio (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows).
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_follower_countAuthor's follower count. null means not disclosed.
author_following_countHow many accounts the author follows (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows).
author_like_countTotal likes the author's profile has received (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts / transcript).
author_video_countTotal number of posts on the author's profile (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts 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).
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.
video_widthVideo frame width in pixels.
video_heightVideo frame height in pixels.
video_bitratesKeeps the platform's own meaning
has_watermarkKeeps the platform's own meaning
duration_secVideo length in seconds.
duration_secondsDuration in seconds. null for content that is not video or audio.
hashtagsHashtags in the text, in order of appearance; absent when there are none.
posted_atPublish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it.
titleTitle. null when the platform has no titles (for example text-only posts).
musicBackground track: id, title, author, is_original (original sound or not), duration_sec, cover_url and play_url (audio link, may expire). Absent when there is no music information.
locationLocation description passed through as is; the format varies by platform.
image_urlsArray of image links in the platform's display order; absent when there are no images.
is_deletedTrue when the video has been deleted; present only when Douyin reports it on the row.
is_privateTrue when the video is visible only to its author (private); present only when Douyin reports it on the row.
platformSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).
episodePosition of the video in the collection (mix_posts), counting from 1.
series_idKeeps the platform's own meaning
is_paidKeeps the platform's own meaning

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 episodes API return?

One row per episode: id, url, episode, series_id, is_paid, text, media_type, video_url, like_count, comment_count, share_count, collect_count, duration_seconds and posted_at, plus author fields.

Where does series_id come from?

Take it from the series_id of a series_feed or user_series row, or pass the share link https://www.iesdouyin.com/share/playlet/detail/<ID> directly.

How much does one page of episodes 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