Douyin Short-drama channel API

POST

API 상태

24시간 상태
정상
  • 양호 / 정상
  • 사용 가능
  • 제한적
  • 대부분 작동 중단
정상

최근 24시간

최근 30일

List the short dramas on Douyin's short-drama channel, 16 per page. genre narrows the list to hot, sweet_romance, comedy, uplifting, growth, suspense, family, urban, fantasy, xuanhuan, workplace, youth, costume, action, comeback or other; leave it out for the channel's default picks. Each row has series_id, name, description, url, cover_image_url, genres, sub_genres, status_text, episode_count, updated_to_episode, play_count, collect_count, is_paid (with paid_episode_count, episode_price_cny and full_price_cny on paid dramas), icp_number, episode_video_id, the author and last_episode_at. Pages can repeat a drama, so de-duplicate by series_id.

POST https://api.everyinfra.com/api/v1/social을 보내고 platform은 douyin, action은 series_feed로 설정합니다. 요금은 요청 1,000개당 $0.56(호출당 $0.000556)입니다. 실패한 호출과 빈 결과에는 과금하지 않습니다. 동기 방식입니다. 오래 걸리는 작업은 요청 본문에 "mode": "async"를 추가하고 job_id를 받아 폴링하세요.

AI 프롬프트

#
EveryInfra Douyin Short-drama channel 엔드포인트(douyin/series_feed)를 사용하는 데이터 수집 스크립트 작성을 도와주세요.

엔드포인트 사용 방법:
- 요청: Authorization: Bearer <API 키> 헤더와 함께 POST https://api.everyinfra.com/api/v1/social로 보냅니다. 키는 EVERYINFRA_API_KEY 환경 변수에서 읽고, 절대 하드코딩하지 마세요.
- 요청 본문에서 platform은 douyin, action은 series_feed로 설정하고, 파라미터는 params 안에 넣습니다.
- 필수 파라미터가 없습니다.
- 선택 파라미터:
  - genre: Short-drama genre: hot, sweet_romance, comedy, uplifting, growth, suspense, family, urban, fantasy, xuanhuan, workplace, youth, costume, action, comeback or other. Leave it out for the channel's default picks. (허용 값: action / comeback / comedy / costume / family / fantasy / growth / hot)
  - page_token: Page token for series_feed. 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.
- 레코드 목록을 반환합니다. 각 레코드의 주요 필드: series_id, name (컬렉션 이름입니다(user_mixes)), description (컬렉션 설명입니다(user_mixes)), url, cover_image_url (커버 이미지 URL입니다), genres, sub_genres, status_text, episode_count (컬렉션의 회차 수입니다(user_mixes)), updated_to_episode, play_count (실제 재생수는 Hot Spot Treasure와 컬렉션에만 있습니다), collect_count; 전체 필드 28개, 전체 목록은 https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- 요청 본문 예시:
{
  "platform": "douyin",
  "action": "series_feed",
  "params": {}
}
- 요금: 요청 1,000개당 $0.56. 실패하거나 빈 결과에는 과금하지 않습니다.
- 대상이 수십~수백 개라면 요청 본문에 "mode": "async"를 추가하세요. job_id를 즉시 받은 뒤 GET https://api.everyinfra.com/api/v1/jobs/{job_id}를 폴링해 결과를 가져옵니다.
- 422가 반환되면 오류에 제시된 파라미터 이름과 허용 값을 참고해 요청을 수정하고, 429 또는 503이 반환되면 Retry-After만큼 기다린 뒤 다시 시도합니다.

코드를 작성하기 전에 필요한 대상과 수량, 필드, 원하는 출력 형식을 먼저 물어봐 주세요. 그런 다음 계획과 대략적인 비용을 저와 확인해 주세요.

요청 파라미터

#
이름위치타입필수기본값설명
Authorizationheaderstring예-Bearer 뒤에 API 키를 붙여 입력합니다. API 키는 콘솔에서 생성하며, URL이나 코드 저장소에 절대 넣지 마세요.
platformbodystring예douyin플랫폼 식별자이며 고정값입니다.
actionbodystring예series_feed기능 식별자이며 고정값입니다.
genrebody.paramsstring (enum)아니요-Short-drama genre: hot, sweet_romance, comedy, uplifting, growth, suspense, family, urban, fantasy, xuanhuan, workplace, youth, costume, action, comeback or other. Leave it out for the channel's default picks.허용 값actioncomebackcomedycostumefamilyfantasygrowthhotothersuspensesweet_romanceupliftingurbanworkplacexuanhuanyouth
page_tokenbody.paramsstring아니요-Page token for series_feed. 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 16 dramas; pages can repeat a drama, so de-duplicate by series_id.

코드 샘플

#
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_feed",
  "params": {}
}'

OpenAPI 정의(JSON)샘플 코드는 EVERYINFRA_API_KEY 환경 변수에서 키를 읽으므로, 복사한 코드에는 API 키가 포함되지 않습니다.

응답 예시

#
November 21, 2026 at 07:17(UTC)에 위 코드 샘플의 파라미터로 이 API를 호출해 수집한 응답입니다. results와 count는 해당 호출의 실제 응답이며, 개인정보(이름, 핸들, 아바타, 프로필 링크, 연락처)는 제거했습니다(목록은 처음 2개만 표시). id, billing, quota는 호출할 때마다 달라지므로 형태만 표시합니다.
json
{  "id": "req_…",  "platform": "douyin",  "action": "series_feed",  "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://p11-sign.douyinpic.com/tos-cn-i-dy/63264312790795d05be78f3f6237f7dd~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1795417200&x-signature=VQmYMQdWs7VFCQno64V3OHbKvKI%3D&from=4080365293&s=PackSourceEnum_SERIES_FEED&se=false&sc=series_cover&biz_tag=awem…",      "genres": [        "其他"      ],      "sub_genres": [        "恩怨斗争"      ],      "status_text": "84集全",      "episode_count": 84,      "updated_to_episode": 84,      "play_count": 894113165,      "collect_count": 1162052,      "is_paid": true,      "paid_episode_count": 82,      "episode_price_cny": 1.2,      "full_price_cny": 98.4,      "icp_number": "(抖音)微短剧备字(2026)第061503号",      "episode_video_id": "7703828500301565211",      "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"    },    {      "series_id": "7698661515057956902",      "name": "权倾江湖,丛林之王横扫无敌",      "description": "周正被骗至越缅金矿沦为黑工,为筹措妹妹治病钱受尽矿主桑帛手下克扣欺凌,忍无可忍后奋起反抗,挟持金矿大小姐林月出逃。逃亡途中,他与同伴六子一边躲避桑帛的追杀,一边见证当地诸多黑暗乱象。林月选择和周正联手夺回五矿集团。周正历经凶险对抗桑帛势力,解救大批受害矿工,桑帛势力覆灭后,又卷入当地帮派纷争。三年后周正回到家乡,恰逢妹妹周妍遭富家子弟欺凌,他挺身而出。危急时刻,已是五矿集团掌权人的林月赶来撑腰。",      "url": "https://www.iesdouyin.com/share/playlet/detail/7698661515057956902/?schema_type=43&object_id=7698661515057956902&from_ssr=1",      "cover_image_url": "https://p5-ex-gddgtc-sign.douyinpic.com/tos-cn-i-dy/ef830e43b4e69eb2add8eda2a233f60b~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1795417200&x-signature=d8ecMug1eUEDB6Tv8oc2K0kRLgk%3D&from=4080365293&s=PackSourceEnum_SERIES_FEED&se=false&sc=series_cover&biz…",      "genres": [        "其他"      ],      "sub_genres": [        "恩怨斗争"      ],      "status_text": "107集全",      "episode_count": 107,      "updated_to_episode": 107,      "play_count": 621329177,      "collect_count": 777807,      "is_paid": true,      "paid_episode_count": 95,      "episode_price_cny": 0.8,      "full_price_cny": 76,      "icp_number": "(抖音)微短剧备字(2026)第027258号",      "episode_video_id": "7698667342640942399",      "author_id": "•••",      "author_uid": "•••",      "author_name": "若•••场",      "author_douyin_id": "•••",      "author_avatar_url": "https://p3-pc.douyinpic.com/•••",      "author_is_verified": false,      "author_follower_count": 0,      "created_at": "2026-10-20T08:18:35+00:00",      "updated_at": "2026-11-05T16:05:07+00:00",      "last_episode_at": "2026-10-26T05:22:14+00:00",      "platform": "douyin"    }  ],  "next_page_token": …,  "pagination": { … },  "count": 16,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

응답 필드

#

비즈니스 데이터는 results에 담깁니다. 아래 표는 레코드에 포함될 수 있는 필드를 나열하며, 플랫폼에 표시되지 않는 값을 임의로 만들어 넣지 않습니다.

필드의미
series_id플랫폼 자체의 의미를 따름
name컬렉션 이름입니다(user_mixes).
description컬렉션 설명입니다(user_mixes).
url플랫폼에서 해당 레코드로 연결되는 링크입니다.
cover_image_url커버 이미지 URL입니다. search, user_posts, posts_batch, related_posts, mix_posts, music_posts, media_links 행에서는 동영상 또는 이미지 게시물의 커버, music_search와 music_detail에서는 음원 커버, billboard_topic_hot에서는 주제 이미지, user_mixes에서는 컬렉션 커버, live_room에서는 방 커버입니다. 서명된 링크는 만료됩니다.
genres플랫폼 자체의 의미를 따름
sub_genres플랫폼 자체의 의미를 따름
status_text플랫폼 자체의 의미를 따름
episode_count컬렉션의 회차 수입니다(user_mixes).
updated_to_episode플랫폼 자체의 의미를 따름
play_count실제 재생수는 Hot Spot Treasure와 컬렉션에만 있습니다. 순위표 billboard_video_hot, billboard_low_fan_explosion, billboard_high_completion에서는 Douyin 자체 재생 수치입니다. mix_posts에서는 해당 회차의 재생수, user_mixes에서는 컬렉션 전체의 재생수입니다. 그 외에는 Douyin이 재생수를 공개하지 않으므로 값은 보통 0이며 실제 재생수가 아닙니다. 도달 범위는 좋아요, 댓글, 공유 수로 판단하세요.
collect_count저장 또는 즐겨찾기 수입니다. null은 비공개라는 뜻이며, 0이 아닙니다.
is_paid플랫폼 자체의 의미를 따름
paid_episode_count플랫폼 자체의 의미를 따름
episode_price_cny플랫폼 자체의 의미를 따름
full_price_cny플랫폼 자체의 의미를 따름
icp_number플랫폼 자체의 의미를 따름
episode_video_id플랫폼 자체의 의미를 따름
author_id플랫폼에서 작성자의 고유 ID입니다.
author_uid작성자(comments에서는 댓글 작성자)의 숫자 사용자 ID입니다. author_id는 secUid이며, 둘 다 같은 사람을 식별합니다.
author_name작성자의 표시 이름입니다.
author_douyin_id작성자의 Douyin ID입니다.
author_avatar_url작성자 아바타 이미지 URL입니다. search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts 행에서는 크리에이터, live_room에서는 호스트, comments 행에서는 댓글 작성자의 아바타입니다.
author_is_verified작성자 인증 여부입니다(search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts 행. live_room에서는 호스트, comments 행에서는 댓글 작성자의 인증 여부).
author_follower_count작성자의 팔로워 수입니다. null은 비공개라는 뜻입니다.
created_at생성 시각으로, posted_at과 같은 형식입니다.
updated_at컬렉션이 마지막으로 업데이트된 시각입니다(user_mixes, ISO 8601, UTC).
last_episode_at플랫폼 자체의 의미를 따름
platform출처 플랫폼 식별자로, 요청의 platform과 같습니다(예: xiaohongshu, tiktok).

오류 및 과금

#
401
키가 없거나 유효하지 않습니다.
402
잔액이 부족합니다. 먼저 충전하세요.
422
파라미터 이름 또는 값이 올바르지 않습니다. 오류에 제시된 제안을 참고해 수정하세요. 과금되지 않습니다.
429
분당 요청 속도 제한에 도달했습니다. Retry-After만큼 기다린 뒤 다시 시도하세요.
503
처리를 완료하지 못했습니다. 보류된 금액은 잔액으로 반환됩니다. 결과가 불확실하면 재시도하기 전에 먼저 확인하세요.
200 빈 결과
데이터가 없습니다. 과금되지 않습니다.

오류

Google Analytics는 동의 필요. 개인정보