DouyinShort-drama channelAPI
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(1回あたり$0.000556)です。失敗した呼び出しと空の結果には課金されません。 同期処理です。時間のかかるジョブでは、ボディに"mode": "async"を追加し、job_idを取得してポーリングしてください。
AIプロンプト
#EveryInfraのDouyin Short-drama channelエンドポイント(douyin/series_feed)を使ったデータ収集スクリプトの作成を手伝ってください。
エンドポイントの仕組み:
- リクエスト:ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数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の指定に従って待ってから再試行します。
コードを書く前に、必要な対象とその件数、必要なフィールド、希望する出力形式を私に質問してください。そのうえで、計画と概算費用を私に確認してください。リクエストパラメータ
#| 名前 | 場所 | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|---|
Authorization | header | string | はい | - | Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。 |
platform | body | string | はい | douyin | プラットフォームの識別子です。値は固定です。 |
action | body | string | はい | series_feed | 機能の識別子です。値は固定です。 |
genre | body.params | string (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_token | body.params | string | いいえ | - | 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. |
コードサンプル
#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キーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。
レスポンス例
#{ "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 | 投稿者の数値ユーザーIDです(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
- 1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
- 503
- 処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
- 200(空)
- データがありません。課金はされません。