API Douyin Account short dramas

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 a Douyin account has published, from its secUid in user_id (a MS4w string) or a https://www.douyin.com/user/<secUid> link, up to 20 per page. Rows have the same fields as series_detail; sub_genres is often missing here, so read series_detail for it.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su douyin e action impostato su user_series. Prezzo $0.79 per 1.000 richieste ($0.000792 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 Account short dramas di EveryInfra (douyin/user_series).

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 user_series, e inserisci i parametri in params.
- Parametri obbligatori:
  - user_id: The account whose short dramas you want: its secUid (starting MS4w) or a profile link https://www.douyin.com/user/<secUid>. Nicknames, Douyin IDs and short links are not accepted.
- Parametri facoltativi:
  - page_token: Page token for user_series. 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; 27 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Esempio di corpo della richiesta:
{
  "platform": "douyin",
  "action": "user_series",
  "params": {
    "user_id": "https://www.douyin.com/user/MS4wLjABAAAAxKtExlVPfMALHjIWbFLJ1HhhJUebELJXNU6UQw42-kY"
  }
}
- Prezzo: $0.79 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ìuser_seriesIdentificativo della funzionalità, valore fisso.
user_idbody.paramsstringSì-The account whose short dramas you want: its secUid (starting MS4w) or a profile link https://www.douyin.com/user/<secUid>. Nicknames, Douyin IDs and short links are not accepted.
page_tokenbody.paramsstringNo-Page token for user_series. 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 dramas.

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": "user_series",
  "params": {
    "user_id": "https://www.douyin.com/user/MS4wLjABAAAAxKtExlVPfMALHjIWbFLJ1HhhJUebELJXNU6UQw42-kY"
  }
}'

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": "user_series",  "results": [    {      "series_id": "7709817571482011689",      "name": "短剧 · 远赴边城相见,才知他另有牵挂",      "description": "结婚五年、求子多年的林茵终于等来怀孕。她揣着孕检单坐了二十多个小时车,去西北边城给驻守项目的丈夫贺临惊喜,却在挂满红灯笼的小院里听见另一个孩子喊他爸爸。贺临解释是报答救命恩人、照顾工友遗孀。林茵从画册、照片和招待所登记本里,一点点拼出他在边城的四年。她藏起孕检单追问到项目部,真相浮出——安安与贺临、许曼关系不简单。她不再哭闹,面对以孩子为由的挽留和长辈劝说,她会如何选择?",      "url": "https://www.iesdouyin.com/share/playlet/detail/7709817571482011689/?schema_type=43&object_id=7709817571482011689&from_ssr=1",      "cover_image_url": "https://p3-sign.douyinpic.com/tos-cn-i-dy/b78f360b14c95f2af5ee2ac6868adb59~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1795417200&x-signature=GMqnVuqf2dF9fu4Dqn67sGSaVLc%3D&from=4080365293&s=PackSourceEnum_SERIES_PUBLISH&se=false&sc=series_cover&biz_tag=aw…",      "genres": [        "其他"      ],      "episode_count": 67,      "updated_to_episode": 0,      "play_count": 0,      "collect_count": 0,      "is_paid": true,      "paid_episode_count": 66,      "icp_number": "(抖音)微短剧备字(2026)第116470号",      "author_id": "MS4wLjABAAAAxKtExlVPfMALHjIWbFLJ1HhhJUebELJXNU6UQw42-kY",      "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-19T09:49:47+00:00",      "updated_at": "2026-11-20T10:08:46+00:00",      "last_episode_at": "2026-11-19T10:30:33+00:00",      "platform": "douyin"    },    {      "series_id": "7709794114602010678",      "name": "短剧 · 我大专毕业当柜姐,亮出实力后他们慌了",      "description": "大专毕业的苏念隐去家世,在珠宝店做柜姐,实则是雕刻泰斗苏万钧的孙女,承袭一手月牙雕刻绝技。她凭实力拿下大客户,却因戳破前男友未婚妻高价买下注油祖母绿的真相,遭投诉刁难。结识方家后,她受邀做订婚宴珠宝顾问,却在鉴定藏品时发现有人调包变卖。停职危机压来,她不肯低头——而鉴赏会上,那个姓氏背后的秘密,才刚刚浮出水面。",      "url": "https://www.iesdouyin.com/share/playlet/detail/7709794114602010678/?schema_type=43&object_id=7709794114602010678&from_ssr=1",      "cover_image_url": "https://p3-sign.douyinpic.com/tos-cn-i-dy/56aefa2df51ff3eed392f5c4730b17ef~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1795417200&x-signature=hLrAC3m%2BXRdN%2BSDVWSL9yEUBCpM%3D&from=4080365293&s=PackSourceEnum_SERIES_PUBLISH&se=false&sc=series_cover&biz_ta…",      "genres": [        "其他"      ],      "episode_count": 96,      "updated_to_episode": 0,      "play_count": 0,      "collect_count": 0,      "is_paid": true,      "paid_episode_count": 95,      "icp_number": "(抖音)微短剧备字(2026)第115873号",      "author_id": "MS4wLjABAAAAxKtExlVPfMALHjIWbFLJ1HhhJUebELJXNU6UQw42-kY",      "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-19T08:18:46+00:00",      "updated_at": "2026-11-20T11:03:07+00:00",      "last_episode_at": "2026-11-19T08:32:27+00:00",      "platform": "douyin"    }  ],  "next_page_token": …,  "pagination": { … },  "count": 20,  "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
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