API Douyin Tendenze
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- 100%
- Tempo medio nelle ultime 24 ore
- 1.17 s
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Ultime 24 ore
Ultimi 30 giorni
Consulta le classifiche di tendenza di Douyin per le parole chiave popolari. Ogni parola chiave ha posizione, punteggio di popolarità, numero di video, articoli e live room correlati, etichetta e posizione massima raggiunta. Scegli le classifiche con boards (default hotspot). hot_value è un punteggio proprio di Douyin ed è confrontabile solo all'interno di una stessa classifica.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su douyin e action impostato su trending. 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.
Douyin Trending legge le voci attuali di una o più classifiche di tendenza di Douyin: posizione, frase di tendenza, valore di popolarità, numero di video correlati, classifica e immagine di copertina, oltre, quando Douyin li mostra, all'orario dell'evento, alla posizione migliore raggiunta finora e al numero di post e dirette correlati. Ti dice cosa guardano in questo momento le persone su Douyin ed è utile per la pianificazione dei contenuti, il newsjacking, l'allerta precoce sui temi che riguardano un brand e la programmazione.
Scegli una o più classifiche con boards: hotspot, seeding, entertainment, social o challenge; se lo ometti, ottieni la classifica hotspot. Non serve alcuna keyword. hot_value è la misura di popolarità di Douyin, confrontabile solo all'interno di una classifica e spesso vuota nella classifica hotspot, e rank è la posizione al momento della chiamata, quindi esegui chiamate a intervalli regolari e salva ogni snapshot per vedere come si muovono le voci.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Douyin Tendenze di EveryInfra (douyin/trending).
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 trending, e inserisci i parametri in params.
- Nessun parametro obbligatorio.
- Parametri facoltativi:
- boards: Specifica i tipi di classifica dei contenuti di tendenza da interrogare nell'azione trending, passati come singola stringa o array di stringhe: hotspot, seeding, entertainment, social e challenge. (valori consentiti: challenge / entertainment / hotspot / seeding / social)
- limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 60. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 20)
- Restituisce un elenco di record. Campi principali di ogni record: rank (Posizione a partire da 1: la posizione…), keyword (Parola chiave: la frase di tendenza in…), hot_value (Valore di popolarità, una misura propri…), video_count (Numero di video: i video dell'account i…), board (Classifica a cui appartiene la voce), image_url, event_time (Data e ora dell'evento di tendenza), sentence_id (ID della frase di tendenza (trending)), group_id (ID dell'evento di tendenza (trending)), label (Codice numerico del badge sulla voce de…), word_type (Codice numerico del tipo di frase di te…), article_count (Numero di post di immagini correlati al…); 19 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Esempio di corpo della richiesta:
{
"platform": "douyin",
"action": "trending",
"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
#| Nome | Posizione | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|---|
Authorization | header | string | Sì | - | Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice. |
platform | body | string | Sì | douyin | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | trending | Identificativo della funzionalità, valore fisso. |
boards | body.params | array | No | - | Specifica i tipi di classifica dei contenuti di tendenza da interrogare nell'azione trending, passati come singola stringa o array di stringhe: hotspot, seeding, entertainment, social e challenge. Se omesso o passato come array vuoto, il valore predefinito è hotspot.Valori consentitichallengeentertainmenthotspotseedingsocial |
limit | body.params | integer (1–60) | No | 20 | Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 60. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. I valori più alti restituiscono 422 prima di qualsiasi addebito. |
Esempi di codice
#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": "trending",
"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
#{ "id": "req_…", "platform": "douyin", "action": "trending", "results": [ { "rank": 1, "keyword": "渡船之上 信仰如磐", "video_count": 1, "board": "hotspot", "event_time": "2026-10-25 02:34:26", "sentence_id": "2711825", "label": 0, "word_type": 14, "is_pinned": true, "platform": "douyin" }, { "rank": 2, "keyword": "中超成都蓉城0:1大连英博", "hot_value": 11367047, "video_count": 12, "board": "hotspot", "image_url": "https://p5-ex-gddgtc-sign.douyinpic.com/tos-cn-i-dy/782a03e57ee24eb7b51eac3c0ee20e5e~noop.jpeg?lk3s=bfd515bb&x-expires=1792886400&x-signature=TFoV42oMHa89HkqBwV3AKbDx6sI%3D&from=3218412987", "event_time": "2026-10-24T07:01:06.000Z", "sentence_id": "2711309", "group_id": "7699487992537503010", "label": 3, "word_type": 1, "article_count": 0, "is_pinned": false, "max_rank": 1, "live_room_count": 0, "topic_view_count": 59034929, "sentence_tag": 5000, "label_icon_url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/vjl_avo_upfbvk/ljhwZthlaukjlkulzlp/hotspot_detail_page/3.png", "platform": "douyin" } ], "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.
| Campo | Significato |
|---|---|
rank | Posizione a partire da 1: la posizione nella classifica di tendenza in trending, la posizione nella classifica Xingtu in xingtu_creator_rankings, la posizione nella classifica delle ricerche in billboard_search_hot e la posizione del suggerimento nella casella di ricerca di Douyin in search_suggest. |
keyword | Parola chiave: la frase di tendenza in trending, il termine di ricerca in billboard_search_hot, la ricerca suggerita in search_suggest. |
hot_value | Valore di popolarità, una misura propria di Douyin, confrontabile solo all'interno della stessa classifica e finestra temporale: in trending, la popolarità della voce (spesso vuota nella classifica hotspot); nelle classifiche video di Hot Spot Treasure, il punteggio di popolarità della classifica, con le righe ordinate dal valore più alto; in billboard_search_hot, la popolarità di ricerca del termine nella finestra. |
video_count | Numero di video: i video dell'account in profile e billboard_account_search, i video correlati alla voce in trending. |
board | Classifica a cui appartiene la voce. |
image_url | Link all'immagine. Le funzionalità con più immagini possono restituire un array image_urls. |
event_time | Data e ora dell'evento di tendenza. |
sentence_id | ID della frase di tendenza (trending). |
group_id | ID dell'evento di tendenza (trending); vuoto per alcune voci. |
label | Codice numerico del badge sulla voce della classifica (trending), ad esempio popolare, nuovo o in forte crescita; 0 significa nessun badge. |
word_type | Codice numerico del tipo di frase di tendenza (trending). |
article_count | Numero di post di immagini correlati alla tendenza (trending). |
is_pinned | Indica se l'elemento è fissato in alto (righe dei post: fissato sul profilo dell'autore; trending: fissato nella classifica). |
max_rank | Posizione più alta raggiunta dalla tendenza in classifica (trending). |
live_room_count | Numero di dirette correlate alla tendenza (trending). |
topic_view_count | Mantiene il significato attribuito dalla piattaforma |
sentence_tag | Mantiene il significato attribuito dalla piattaforma |
label_icon_url | Mantiene il significato attribuito dalla piattaforma |
related_music_id | Mantiene il significato attribuito dalla piattaforma |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
FAQ
#Posso interrogare più classifiche contemporaneamente?
#Sì. boards accetta una singola stringa o un array, e il campo board di ogni riga indica da quale classifica proviene, quindi raggruppa per quel campo prima di unire i risultati. Se ometti boards o invii un array vuoto, ottieni solo la classifica hotspot.
Posso confrontare hot_value tra classifiche diverse?
#No. È la misura di popolarità di Douyin e ha senso solo all'interno di una classifica; nelle righe hotspot è spesso vuota. Per confrontare classifiche diverse usa rank o i conteggi dei contenuti correlati, come video_count e article_count.
Come seguo un trend nel tempo?
#Esegui chiamate a intervalli regolari e salva ogni risultato con l'orario della chiamata. sentence_id collega tra snapshot diversi le righe della stessa frase di tendenza, max_rank è la posizione migliore che ha raggiunto e is_pinned indica una frase fissata in cima alla classifica, che potresti voler escludere dall'analisi delle posizioni.
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.