API Douyin Short-drama channel

POST

Stato di salute dell'API

Operatività nelle ultime 24 ore
Normale
  • Buono / normale
  • Disponibile
  • Limitato
  • Quasi del tutto inattivo
Normale

Ultime 24 ore

Ultimi 30 giorni

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.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su douyin e action impostato su series_feed. Prezzo $0.56 per 1.000 richieste ($0.000556 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.

Prompt per l'AI

#
Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Douyin Short-drama channel di EveryInfra (douyin/series_feed).

Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su douyin e action su series_feed, e inserisci i parametri in params.
- Nessun parametro obbligatorio.
- Parametri facoltativi:
  - 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. (valori consentiti: 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.
- Restituisce un elenco di record. Campi principali di ogni record: series_id, name (Nome della raccolta (user_mixes)), description (Descrizione della raccolta (user_mixes)), url, cover_image_url (URL dell'immagine di copertina: la cope…), genres, sub_genres, status_text, episode_count (Numero di episodi della raccolta (user_…), updated_to_episode, play_count (Reale su Hot Spot Treasure e raccolte), collect_count; 28 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Esempio di corpo della richiesta:
{
  "platform": "douyin",
  "action": "series_feed",
  "params": {}
}
- Prezzo: $0.56 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.

Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.

Parametri della richiesta

#
NomePosizioneTipoObbligatorioPredefinitoDescrizione
AuthorizationheaderstringSì-Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice.
platformbodystringSìdouyinIdentificativo della piattaforma, valore fisso.
actionbodystringSìseries_feedIdentificativo della funzionalità, valore fisso.
genrebody.paramsstring (enum)No-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.Valori consentitiactioncomebackcomedycostumefamilyfantasygrowthhotothersuspensesweet_romanceupliftingurbanworkplacexuanhuanyouth
page_tokenbody.paramsstringNo-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.

Esempi di codice

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

Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.

Esempio di risposta

#
Acquisita il November 21, 2026 at 07:17 (UTC) chiamando questa API con i parametri dell'esempio di codice qui sopra. results e count sono la risposta reale di quella chiamata, da cui sono state rimosse le informazioni personali (nomi, handle, avatar, link ai profili, recapiti); l'elenco conserva i primi 2. id, billing e quota cambiano a ogni chiamata, quindi ne viene mostrata solo la struttura.
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": { … }}

Campi della risposta

#

I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.

CampoSignificato
series_idMantiene il significato attribuito dalla piattaforma
nameNome della raccolta (user_mixes).
descriptionDescrizione della raccolta (user_mixes).
urlLink al record sulla piattaforma.
cover_image_urlURL dell'immagine di copertina: la copertina di un video o di un post di immagini nelle righe search, user_posts, posts_batch, related_posts, mix_posts, music_posts e media_links; la copertina del brano in music_search e music_detail; l'immagine del topic in billboard_topic_hot; la copertina della raccolta in user_mixes; la copertina della room in live_room. I link firmati scadono.
genresMantiene il significato attribuito dalla piattaforma
sub_genresMantiene il significato attribuito dalla piattaforma
status_textMantiene il significato attribuito dalla piattaforma
episode_countNumero di episodi della raccolta (user_mixes).
updated_to_episodeMantiene il significato attribuito dalla piattaforma
play_countReale su Hot Spot Treasure e raccolte. Nelle classifiche billboard_video_hot, billboard_low_fan_explosion e billboard_high_completion è il dato di riproduzione fornito da Douyin. In mix_posts sono le riproduzioni di quell'episodio e in user_mixes le riproduzioni dell'intera raccolta. Altrove Douyin non pubblica il numero di riproduzioni, quindi il valore di solito è 0 e non riflette riproduzioni reali; valuta la diffusione in base a Mi piace, commenti e condivisioni.
collect_countSalvataggi o preferiti. null significa non resi noti, non 0.
is_paidMantiene il significato attribuito dalla piattaforma
paid_episode_countMantiene il significato attribuito dalla piattaforma
episode_price_cnyMantiene il significato attribuito dalla piattaforma
full_price_cnyMantiene il significato attribuito dalla piattaforma
icp_numberMantiene il significato attribuito dalla piattaforma
episode_video_idMantiene il significato attribuito dalla piattaforma
author_idID univoco dell'autore sulla piattaforma.
author_uidID utente numerico dell'autore (nelle righe comments, di chi ha commentato). author_id è il secUid; entrambi identificano la stessa persona.
author_nameNome visualizzato dell'autore.
author_douyin_idL'ID Douyin dell'autore.
author_avatar_urlURL dell'avatar dell'autore: il creator nelle righe search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts, chi conduce la diretta in live_room, chi ha commentato nelle righe comments.
author_is_verifiedIndica se l'autore è verificato (righe search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts; in live_room, se lo è chi conduce la diretta; nelle righe comments, se lo è chi ha commentato).
author_follower_countNumero di follower dell'autore. null significa non reso noto.
created_atData e ora di creazione, nello stesso formato di posted_at.
updated_atQuando la raccolta è stata aggiornata l'ultima volta (user_mixes, ISO 8601, UTC).
last_episode_atMantiene il significato attribuito dalla piattaforma
platformIdentificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).

Errori e addebiti

#
401
Chiave mancante o non valida.
402
Saldo insufficiente. Effettua prima una ricarica.
422
Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
429
Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
503
Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
Risposta 200 vuota
Nessun dato. Nessun addebito.

Errori

Google Analytics: serve il consenso Privacy