API di Douyin

Cosa significano i parametri search di API di Douyin?

Trova video Douyin per un termine di ricerca. Ottieni didascalia, hashtag, like, commenti, condivisioni, salvataggi, dati dell'autore e un link di riproduzione firmato. Douyin non pubblica il numero di riproduzioni, quindi view_count di solito è assente o pari a 0 e non mostra mai le riproduzioni reali. Valuta la copertura da like, commenti e condivisioni.

keywordObbligatorio

Termine di ricerca per l'azione di ricerca video, passato come stringa, ad esempio latte art. Trova video; non è il nickname di un account né un ID video.

page_tokenFacoltativo

Token di pagina. Per avviare la paginazione, invia una stringa vuota page_token=""; poi, per ottenere la pagina successiva, ripassa il next_page_token della risposta precedente esattamente come ricevuto, lasciando invariati keyword, sort e publish_time. Ogni pagina corrisponde a una chiamata e contiene pagine di risultati di Douyin intere, non troncate: almeno limit video (predefinito 10, fino a 50; meno nell'ultima pagina), spesso qualcuno in più. I video che Douyin ripete dalla pagina precedente vengono esclusi. I token durano 24 ore e funzionano solo per lo stesso account e con gli stessi parametri; un token scaduto o non corrispondente restituisce 422, quindi ricomincia dalla prima pagina. Nell'ultima pagina la risposta non contiene next_page_token. Senza page_token la chiamata esegue un singolo recupero di massimo limit video, senza next_page_token.

publish_timeFacoltativo

Filtra i risultati della ricerca video per finestra temporale di pubblicazione. I valori consentiti sono unlimited (predefinito), one_day (ultime 24 ore), one_week (ultimi 7 giorni) e half_year (ultimi 6 mesi).

Valori ammessi:half_yearone_dayone_weekunlimited

sortFacoltativo

Ordina i risultati della ricerca video. I valori consentiti sono relevance (predefinito), newest per la data di pubblicazione più recente e most_liked per il maggior numero di like. Supporta gli alias legacy di compatibilità general (mappato su relevance) e latest (mappato su newest).

Valori ammessi:most_likednewestrelevance

Cosa significano i parametri profile di API di Douyin?

Cerca un account Douyin tramite secUid. Ottieni nickname, handle, bio, numero di follower, like e video, località IP, verifica e stato del negozio. Passa in user_id il secUid (spesso inizia con MS4w), non un nickname o un ID breve. I video si ottengono con user_posts.

user_idObbligatorio

La stringa secUid dell'utente Douyin (di solito inizia con MS4w), non un nickname né il breve ID numerico di Douyin. Serve a identificare gli account per le azioni profile e user_posts; puoi ottenerla dal campo author_id dei risultati di ricerca o dall'URL del profilo di un utente.

Douyin Open Platform: Open ID e Union ID — Douyin Open Platform definisce l'Open ID come l'identificatore dell'utente all'interno di una singola app, mentre lo Union ID vale per l'intero account sviluppatore. In questa pagina, user_id richiede un secUid secondo le istruzioni riportate sopra; non passare direttamente identificatori dell'Open Platform come input equivalenti. · Verificato 2026-09-04

Cosa significano i parametri user_posts di API di Douyin?

Monitora i video pubblicati da un account Douyin, dal più recente. Ogni video include didascalia, hashtag, durata, metriche di engagement e data di pubblicazione. Inizia la paginazione con un page_token vuoto. Ripassa ogni next_page_token entro 24 ore. since imposta la data di pubblicazione minima.

user_idObbligatorio

La stringa secUid dell'utente Douyin (di solito inizia con MS4w), non un nickname né il breve ID numerico di Douyin. Serve a identificare gli account per le azioni profile e user_posts; puoi ottenerla dal campo author_id dei risultati di ricerca o dall'URL del profilo di un utente.

Douyin Open Platform: Open ID e Union ID — Douyin Open Platform definisce l'Open ID come l'identificatore dell'utente all'interno di una singola app, mentre lo Union ID vale per l'intero account sviluppatore. In questa pagina, user_id richiede un secUid secondo le istruzioni riportate sopra; non passare direttamente identificatori dell'Open Platform come input equivalenti. · Verificato 2026-09-04

page_tokenFacoltativo

Token di pagina per user_posts: invia una stringa vuota page_token="" per iniziare dalla pagina più recente, poi ripassa il next_page_token di ogni risposta esattamente come ricevuto, lasciando invariati gli altri parametri. I token durano 24 ore e funzionano solo per lo stesso account e con gli stessi parametri; l'ultima pagina non ha next_page_token. Le pagine contengono fino a 100 righe, a partire dalle più recenti, e ignorano il limite inferiore since; se ti serve un intervallo di date, filtra per posted_at lato tuo. Ogni pagina corrisponde a una chiamata.

sinceFacoltativo

Imposta un limite inferiore per la data di pubblicazione dei video nelle azioni profile e user_posts, nel formato YYYY-MM-DD. Filtra i video recuperati per la richiesta, non la data di creazione dell'account. Se lo ometti, il filtro per data viene rimosso.

Cosa significano i parametri video di API di Douyin?

Recupera didascalia, hashtag, durata, metriche di engagement, profilo dell'autore, musica di sottofondo e data di pubblicazione di un video Douyin dal suo link. Il link di riproduzione in video_url è firmato e scade, quindi scarica il video subito se devi conservarlo.

urlObbligatorio

URL completo del video Douyin di destinazione, nel formato https://www.douyin.com/video/<video_id>. Recupera i dettagli del video in video, i commenti in comments, le risposte a un commento in comment_replies (il video su cui si trova il commento) o la trascrizione audio in transcript. Non passare URL di profili utente o di pagine di ricerca.

Cosa significano i parametri comments di API di Douyin?

Estrai i commenti degli spettatori su un video Douyin, con like, numero di risposte, regione IP, flag di commento popolare e di like dell'autore, menzioni ed eventuali immagini. Ripassa next_page_token come page_token per scorrere i commenti di primo livello.

urlObbligatorio

URL completo del video Douyin di destinazione, nel formato https://www.douyin.com/video/<video_id>. Recupera i dettagli del video in video, i commenti in comments, le risposte a un commento in comment_replies (il video su cui si trova il commento) o la trascrizione audio in transcript. Non passare URL di profili utente o di pagine di ricerca.

page_tokenFacoltativo

Token di pagina per user_posts e comments. Per avviare la paginazione, invia una stringa vuota page_token=""; poi reinvia il next_page_token della risposta precedente esattamente come ricevuto per ottenere la pagina successiva, senza modificare gli altri parametri. I token durano 24 ore e funzionano solo per lo stesso account e gli stessi parametri; un token scaduto o non corrispondente restituisce 422, quindi riparti dalla prima pagina. Nell'ultima pagina la risposta non contiene next_page_token (pagination.has_more è false). Ogni pagina di user_posts equivale a una chiamata, contiene fino a 100 righe ordinate dalla più recente alla meno recente e non è filtrata da since (se ti serve una finestra di date, filtra per posted_at dal tuo lato). Le pagine di comments contengono fino a 50 commenti di primo livello e vengono addebitate per blocchi di righe: ogni 20 righe equivalgono a una chiamata, quindi una pagina con 50 righe equivale a 3 chiamate (un limit inferiore conteggia il numero di righe specificato); i blocchi restituiti senza righe non vengono addebitati. Senza page_token, la chiamata esegue un singolo recupero: user_posts restituisce il batch più recente (since si applica), mentre comments restituisce solo l'inizio dell'elenco, risposte incluse, sempre con l'addebito di una chiamata ogni 20 righe: 20 righe per impostazione predefinita e al massimo circa 50–60, indipendentemente da quanto sia alto limit, di solito senza next_page_token.

Cosa significano i parametri comment_replies di API di Douyin?

Elenca le risposte sotto un commento di primo livello su un video Douyin, fino a 100 per chiamata, lette 20 alla volta. Ogni risposta include testo, like, autore, regione IP e flag di like dell'autore del video, oltre a reply_to_reply_id e reply_to_author_name quando risponde a un'altra risposta. Passa il link del video con un comment_id ottenuto da comments e pagina con next_page_token.

urlObbligatorio

URL completo del video Douyin di destinazione, nel formato https://www.douyin.com/video/<video_id>. Recupera i dettagli del video in video, i commenti in comments, le risposte a un commento in comment_replies (il video su cui si trova il commento) o la trascrizione audio in transcript. Non passare URL di profili utente o di pagine di ricerca.

comment_idObbligatorio

L'ID del commento di primo livello di cui vuoi le risposte, solo cifre, preso dall'id di una riga di comments; hanno risposte solo i commenti con reply_count maggiore di zero. Viene usato da comment_replies insieme all'url dello stesso video; non è un ID video né un ID di risposta.

page_tokenFacoltativo

Token di pagina per comment_replies: invia una stringa vuota page_token="" per iniziare dalla prima risposta al commento, poi ripassa il next_page_token di ogni risposta dell'API esattamente come ricevuto, lasciando invariati gli altri parametri. I token durano 24 ore e funzionano solo per lo stesso account e con gli stessi parametri; nell'ultima pagina la risposta non contiene next_page_token. Le pagine contengono fino a 20 risposte ai commenti e vengono addebitate per blocchi di righe: ogni 20 righe contano come una chiamata e un blocco restituito senza righe non viene addebitato.

Cosa significano i parametri trending di API di Douyin?

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.

boardsFacoltativo

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 ammessi:challengeentertainmenthotspotseedingsocial

Cosa significano i parametri transcript di API di Douyin?

Trascrivi il parlato di un video Douyin con timestamp a livello di frase. Ottieni anche titolo, data di pubblicazione, metriche di engagement, autore e un link alla traccia audio. Non tutti i video contengono parlato riconoscibile, e il testo non viene tradotto.

urlObbligatorio

URL completo del video Douyin di destinazione, nel formato https://www.douyin.com/video/<video_id>. Recupera i dettagli del video in video, i commenti in comments, le risposte a un commento in comment_replies (il video su cui si trova il commento) o la trascrizione audio in transcript. Non passare URL di profili utente o di pagine di ricerca.

Cosa significano i parametri creator_search di API di Douyin?

Cerca account di creator Douyin per nickname, handle o frase. Ottieni numero di follower, genere, verifica e stato live, oltre al secUid per le chiamate successive. Restringi con follower_range e user_type. Le corrispondenze sono candidati, non un'identità confermata.

keywordObbligatorio

Un nickname del creator, un ID Douyin o una frase di ricerca correlata, usati per trovare account. Non esegue l'azione search dei video e non garantisce una corrispondenza esatta dell'identità.

follower_rangeFacoltativo

Filtra creator_search per fascia di numero di follower dell'account. Usa under_1k, 1k_to_10k, 10k_to_100k, 100k_to_1m o over_1m; omettilo per non limitare la fascia.

Valori ammessi:100k_to_1m10k_to_100k1k_to_10kover_1munder_1k

user_typeFacoltativo

Filtra creator_search per categoria di account: general, business o verified_individual. Non è una categoria di acquirenti né una prova di identità legale.

Valori ammessi:businessgeneralverified_individual

Cosa significano i parametri creator_audience di API di Douyin?

Analizza i follower di un creator Douyin per fascia di prezzo del dispositivo, genere, età o provincia, con la quota di ogni fascia e il suo indice TGI. Le quote sono decimali tra 0 e 1, non percentuali, e le fasce non sono registri di acquirenti né singole persone.

user_idObbligatorio

Il secUid del creator Douyin, che di solito inizia con MS4w, usato per leggere la distribuzione del pubblico e gli indicatori TGI disponibili. Usa lo user_id ottenuto dalla ricerca dei creator, non un nickname, un ID Douyin breve o un identificatore di acquirente.

dimensionFacoltativo

Seleziona la vista per segmento di follower di creator_audience: device_price_band (predefinito), gender, age o province. I valori della distribuzione sono quote decimali grezze da 0 a 1, non percentuali; il TGI resta un indice separato. Questo parametro non richiede record di singoli follower né dati sugli acquirenti.

Valori ammessi:agedevice_price_bandgenderprovince

Cosa significano i parametri creator_trend di API di Douyin?

Monitora nel tempo il numero di follower di un creator Douyin come serie datata, con il numero medio di follower nella finestra. Passa il secUid del creator in user_id. La serie da sola non mostra cosa abbia causato la crescita.

user_idObbligatorio

Il secUid del creator Douyin, che di solito inizia con MS4w, usato per leggere le serie disponibili dell'andamento dei follower. Non è un nickname né un ID Douyin numerico breve.

Cosa significano i parametri creator_benchmark di API di Douyin?

Confronta un creator Douyin con account simili per media di post, like, commenti, condivisioni e crescita dei follower, ciascuno con un rango percentile. Sono indicatori relativi dell'account, non vendite, conversioni né prove di causalità.

user_idObbligatorio

Il secUid del creator Douyin, che di solito inizia con MS4w, usato per leggere le medie e i percentili disponibili dell'account. Non è un nickname né un ID Douyin numerico breve.

Cosa significano i parametri xingtu_creator_search di API di Douyin?

Cerca nei record dei creator Xingtu di Douyin per parola chiave. Ottieni tasso di engagement, riproduzioni attese, crescita dei follower, punteggio commerciale, intervalli di GMV (non il GMV esatto), indici di valore e preventivi in CNY per durata del video. creator_id serve solo a confrontare queste righe. Per analytics e listini serve il douyin_id ottenuto da creator_search.

keywordObbligatorio

Una frase di ricerca dei creator per xingtu_creator_search. Il creator_id restituito identifica e confronta i record all'interno di questo risultato di ricerca Xingtu; non è accettato da xingtu_creator_analytics o xingtu_rate_card, che richiedono il douyin_id restituito dalla normale creator_search. Non è una keyword di prodotto né una ricerca di video.

Cosa significano i parametri xingtu_creator_analytics di API di Douyin?

Ottieni il profilo commerciale Xingtu di un creator su Douyin. Include tipo e livello, follower, riproduzioni medie, temi dei contenuti, flag e-commerce e preventivo minimo in CNY. Passa il douyin_id visibile ottenuto da creator_search, non un secUid o un ID Xingtu. Il preventivo minimo è un prezzo richiesto, non un accordo concluso.

douyin_idObbligatorio

L'ID visibile dell'account Douyin (unique_id) restituito dall'azione standard creator_search e richiesto da xingtu_creator_analytics e xingtu_rate_card; xingtu_creator_search non lo restituisce. È distinto dallo user_id (secUid), dal creator_id di Xingtu e dal nickname.

Cosa significano i parametri xingtu_rate_card di API di Douyin?

Consulta le fasce di tariffa che un creator Douyin pubblica su Xingtu. Ogni fascia include formato, preventivo attuale e originale, nota sulla liquidazione, tipo di video e disponibilità. Usa il douyin_id ottenuto da creator_search. Sono tariffe pubblicate, non un accordo concluso né una liquidazione finale.

douyin_idObbligatorio

L'ID visibile dell'account Douyin (unique_id) restituito dall'azione standard creator_search e richiesto da xingtu_creator_analytics e xingtu_rate_card; xingtu_creator_search non lo restituisce. È distinto dallo user_id (secUid), dal creator_id di Xingtu e dal nickname.

Cosa significano i parametri xingtu_creator_rankings di API di Douyin?

Estrai fino a cinque creator da una classifica Xingtu di Douyin. Scegli la classifica per settore, tipo e finestra temporale. Ottieni posizione, posizione precedente, punteggio, CPM e intervalli di ordini. Posizioni e punteggi sono confrontabili solo all'interno della classifica e della finestra restituite. Gli intervalli di ordini e riacquisti non sono totali esatti.

industryObbligatorio

Seleziona il settore della classifica dei creator di Xingtu: apparel_accessories, automotive, beauty, electronics, food_beverage, household_goods o mother_baby_pets. È un filtro della classifica, non un tag scelto dal creator.

Valori ammessi:apparel_accessoriesautomotivebeautyelectronicsfood_beveragehousehold_goodsmother_baby_pets

ranking_typeObbligatorio

Seleziona la classifica di Xingtu: all_top, head_tier, paid_ad_performers, rising_stars, sales_champions, top_creators o viral_drivers. I nomi delle classifiche non trasformano la posizione in una previsione o in un risultato garantito.

Valori ammessi:all_tophead_tierpaid_ad_performersrising_starssales_championstop_creatorsviral_drivers

time_windowObbligatorio

Seleziona lo snapshot della classifica di Xingtu: latest_weekly, latest_monthly, all_history_weekly o all_history_monthly. Definisce la classifica restituita e non accetta un intervallo di date arbitrario.

Valori ammessi:all_history_monthlyall_history_weeklylatest_monthlylatest_weekly

Cosa significano i parametri product_search di API di Douyin?

Trova fino a cinque prodotti di Douyin Mall per una parola chiave. Ottieni prezzo in CNY, vendite a 30 giorni, tasso di recensioni positive, negozio, tasso di commissione e numero di creator partner. Il numero di creator partner non indica che un determinato creator abbia venduto l'articolo. Quando la fonte principale non è disponibile, una fonte di riserva restituisce solo ID prodotto, titolo, link, immagine, prezzo in CNY e ID negozio. In quel caso mancano vendite, tasso di recensioni, nome del negozio, categoria, commissione e campi sui creator. I prezzi d'ingresso pari o inferiori a un decimo di yuan vengono esclusi.

keywordObbligatorio

Una frase di ricerca di prodotti su Douyin. I risultati formano un pool di prodotti indipendente e non dimostrano che un determinato creator abbia promosso o venduto quegli articoli.

Cosa significano i parametri product_detail di API di Douyin?

Leggi un prodotto di Douyin Mall tramite ID numerico. Ottieni prezzo visualizzato e scontato in CNY, dato di vendita, negozio, immagini, garanzie, note di spedizione, varianti e stato di vendita. Prendi product_id da product_search o live_product_search, non uno SKU o un ID promozione.

product_idObbligatorio

ID numerico di un prodotto Douyin restituito da product_search o live_product_search. Non è un ID SKU, un ID promozione, un titolo o un URL.

Cosa significano i parametri live_product_search di API di Douyin?

Trova fino a tre prodotti Douyin venduti ora nelle live per una parola chiave. Ottieni SKU, titolo, prezzo in CNY, negozio e ID della live room. L'ID della live room vale solo per questa ricerca. Non attribuisce vendite live passate.

keywordObbligatorio

Una frase di ricerca di prodotti su Douyin Mall. Vengono restituiti solo i prodotti che al momento della richiesta hanno un tag live e un ID di live room; i risultati non sono un registro di ciò che un determinato creator ha venduto nelle dirette.

Cosa significano i parametri hashtag_search di API di Douyin?

Trova hashtag Douyin il cui nome contiene una keyword, ordinati per popolarità. Ogni hashtag ha ID numerico, un indice di popolarità e i video, i like e le visualizzazioni raccolti negli ultimi 7 giorni completi secondo l'ora cinese, con le date del periodo in ogni riga. Fino a 200 hashtag per chiamata, 20 di default; passa hashtag_id a hashtag_detail per i totali complessivi.

keywordObbligatorio

La parola da cercare nei nomi degli hashtag di Douyin, ad esempio food; i termini in cinese di solito corrispondono a più hashtag. Trova hashtag, non video.

Cosa significano i parametri hashtag_detail di API di Douyin?

Leggi un hashtag Douyin tramite il suo hashtag_id numerico ottenuto da hashtag_search. Ottieni nome, visualizzazioni totali dalla creazione, numero di utenti che vi hanno partecipato, data di creazione e link di condivisione. I totali sono conteggi della piattaforma sull'intero hashtag, non su un periodo.

hashtag_idObbligatorio

L'ID numerico di un hashtag Douyin per hashtag_detail, ad esempio 1767586897793101, preso dall'hashtag_id di una riga di hashtag_search. Un nome di hashtag o #name viene rifiutato prima di qualsiasi addebito.

Cosa significano i parametri billboard_video_hot di API di Douyin?

Leggi la classifica dei video di Hot Spot Treasure, lo strumento di tendenze di Douyin: la classifica generale o quelle per maggiore crescita di follower o maggiore tasso di like, nell'ultima ora, nell'ultimo giorno, negli ultimi 3 o 7 giorni. Ogni contenuto include riproduzioni, like, tasso di like, follower guadagnati, tasso di crescita dei follower, punteggio di popolarità e follower dell'autore, in ordine di popolarità decrescente. Fino a 50 per pagina; Douyin esclude alcuni contenuti, quindi le pagine sono spesso più corte e una pagina corta non indica la fine. Le righe non riportano la posizione.

boardFacoltativo

Classifica per billboard_video_hot: all (predefinito) è la classifica generale, follower_growth quella dei contenuti che hanno guadagnato più follower in rapporto alle riproduzioni e like_rate quella con il tasso di like più alto.

Valori ammessi:allfollower_growthlike_rate

keywordFacoltativo

Facoltativo: mantieni solo i contenuti correlati a questa parola, ad esempio food; omettilo per l'intera classifica.

page_tokenFacoltativo

Token di pagina. Omettilo per la prima pagina, poi ripassa il next_page_token della risposta precedente esattamente come ricevuto, lasciando invariati gli altri parametri. Ogni pagina contiene fino a 50 contenuti e corrisponde a una chiamata; Douyin esclude alcuni contenuti, quindi spesso una pagina ne contiene meno di 50 e una pagina incompleta non indica la fine. I token durano 24 ore; l'ultima pagina non ha next_page_token (al massimo circa 1.000 contenuti per classifica).

time_windowFacoltativo

Finestra temporale: 1h (ultima ora), 1d (ultime 24 ore, predefinita), 3d o 7d.

Valori ammessi:1d1h3d7d

Cosa significano i parametri billboard_low_fan_explosion di API di Douyin?

Individua i contenuti Douyin di piccoli account che sono esplosi, dalla classifica dei successi con pochi follower di Hot Spot Treasure. Ogni riga affianca il numero di follower dell'autore a riproduzioni, like, tasso di like e nuovi follower del contenuto, così vedi fin dove è arrivato un piccolo account. Restringi con una keyword facoltativa e una finestra da un'ora a sette giorni. Fino a 50 per pagina e le dimensioni delle pagine variano, quindi continua a paginare finché next_page_token non scompare.

keywordFacoltativo

Facoltativo: mantieni solo i contenuti correlati a questa parola, ad esempio food; omettilo per l'intera classifica.

page_tokenFacoltativo

Token di pagina. Omettilo per la prima pagina, poi ripassa il next_page_token della risposta precedente esattamente come ricevuto, lasciando invariati gli altri parametri. Ogni pagina contiene fino a 50 contenuti e corrisponde a una chiamata; Douyin esclude alcuni contenuti, quindi spesso una pagina ne contiene meno di 50 e una pagina incompleta non indica la fine. I token durano 24 ore; l'ultima pagina non ha next_page_token (al massimo circa 1.000 contenuti per classifica).

time_windowFacoltativo

Finestra temporale: 1h (ultima ora), 1d (ultime 24 ore, predefinita), 3d o 7d.

Valori ammessi:1d1h3d7d

Cosa significano i parametri billboard_high_completion di API di Douyin?

Scopri quali contenuti Douyin gli spettatori guardano fino alla fine, dalla classifica ad alto tasso di completamento di Hot Spot Treasure. Per ogni contenuto ricevi durata, riproduzioni, like, tasso di like, punteggio di popolarità, copertina e un link di riproduzione firmato; il tasso di completamento in sé non viene restituito. Scegli una finestra da un'ora a sette giorni e una keyword facoltativa. Fino a 50 per pagina, spesso meno, con paginazione tramite next_page_token.

keywordFacoltativo

Facoltativo: mantieni solo i contenuti correlati a questa parola, ad esempio food; omettilo per l'intera classifica.

page_tokenFacoltativo

Token di pagina. Omettilo per la prima pagina, poi ripassa il next_page_token della risposta precedente esattamente come ricevuto, lasciando invariati gli altri parametri. Ogni pagina contiene fino a 50 contenuti e corrisponde a una chiamata; Douyin esclude alcuni contenuti, quindi spesso una pagina ne contiene meno di 50 e una pagina incompleta non indica la fine. I token durano 24 ore; l'ultima pagina non ha next_page_token (al massimo circa 1.000 contenuti per classifica).

time_windowFacoltativo

Finestra temporale: 1h (ultima ora), 1d (ultime 24 ore, predefinita), 3d o 7d.

Valori ammessi:1d1h3d7d

Cosa significano i parametri billboard_search_hot di API di Douyin?

Trova i termini di ricerca in crescita su Douyin, dalla classifica delle ricerche di Hot Spot Treasure. Ogni termine ha posizione, popolarità di ricerca nella finestra scelta e una serie giornaliera di popolarità fino a 14 giorni. Se vuoi, filtra i termini che contengono una keyword. 50 termini per pagina; vai avanti con next_page_token. La popolarità è un punteggio proprio di Douyin, non un conteggio delle ricerche.

keywordFacoltativo

Facoltativo: mantieni solo i termini di ricerca che contengono questa parola, ad esempio food; omettilo per l'intera classifica delle ricerche.

page_tokenFacoltativo

Token di pagina. Omettilo per la prima pagina (i primi 50 termini), poi ripassa il next_page_token della risposta precedente esattamente come ricevuto, lasciando invariati gli altri parametri. Ogni pagina contiene fino a 50 termini e corrisponde a una chiamata; i token durano 24 ore e l'ultima pagina non ha next_page_token.

time_windowFacoltativo

Finestra temporale per la popolarità delle ricerche: 1h, 1d (predefinita), 3d o 7d.

Valori ammessi:1d1h3d7d

Cosa significano i parametri billboard_account_search di API di Douyin?

Cerca account Douyin collegati a una keyword tramite Hot Spot Treasure, con numero di follower, like e video per ciascuno. Lo user_id restituito è il secUid accettato da profile e user_posts. Circa 30 account per pagina, a volte qualcuno in meno; vai avanti con next_page_token. I risultati sono account correlati, non una classifica.

keywordObbligatorio

La parola per cui trovare account Douyin correlati, ad esempio food. Ogni account viene restituito con il numero di follower, Mi piace e video.

page_tokenFacoltativo

Token di pagina. Omettilo per la prima pagina, poi ripassa il next_page_token della risposta precedente esattamente come ricevuto. Ogni pagina contiene fino a 30 account (a volte uno o due in meno senza che sia la fine) e corrisponde a una chiamata; i token durano 24 ore e l'ultima pagina non ha next_page_token.

Cosa significano i parametri music_search di API di Douyin?

Cerca nella libreria musicale di Douyin per titolo, artista o nome del suono. Ogni brano include titolo, artista, durata, quanti contenuti lo usano, copertina, un link di riproduzione, un link al testo quando disponibile e tag. 10 brani per pagina; vai avanti con next_page_token. La presenza di un brano su Douyin non ne autorizza l'uso commerciale.

keywordObbligatorio

Il titolo di un brano, un artista o il nome di un suono, ad esempio Jay Chou; cerca nella libreria musicale di Douyin, non nei video.

page_tokenFacoltativo

Token di pagina. Omettilo per la prima pagina, poi ripassa il next_page_token della risposta precedente esattamente come ricevuto. Ogni pagina contiene fino a 10 brani e corrisponde a una chiamata; i token durano 24 ore e l'ultima pagina non ha next_page_token.

Cosa significano i parametri search_suggest di API di Douyin?

Ottieni i suggerimenti di completamento automatico che la casella di ricerca di Douyin mostra per una keyword, nell'ordine di Douyin, con rank a partire da 1. Fino a 10 per chiamata; Douyin di solito ne propone circa cinque, e non c'è paginazione. I suggerimenti non riportano il volume di ricerca.

keywordObbligatorio

Il testo digitato nella casella di ricerca di Douyin, ad esempio artificial intelligence; i suggerimenti vengono restituiti nell'ordine di Douyin.

Cosa significano i parametri billboard_rise_list di API di Douyin?

Individua le tendenze in più rapida crescita su Douyin, dalla classifica in ascesa di Hot Spot Treasure. Ogni tendenza ha posizione e posizioni guadagnate, titolo, ID, popolarità, numero di video correlati, categoria, data di creazione e una curva di popolarità oraria. Se vuoi, tieni solo le tendenze che contengono una keyword. 50 per pagina; vai avanti con next_page_token.

keywordFacoltativo

Facoltativo: mantieni solo i trend che contengono questa parola, ad esempio game; omettilo per l'intera classifica dei trend in crescita.

page_tokenFacoltativo

Token di pagina. Omettilo per la prima pagina (i primi 50 trend), poi ripassa il next_page_token della risposta precedente esattamente come ricevuto, lasciando invariati gli altri parametri. Ogni pagina contiene fino a 50 trend e corrisponde a una chiamata; i token durano 24 ore e l'ultima pagina non ha next_page_token.

Cosa significano i parametri billboard_challenge_hot di API di Douyin?

Leggi la classifica delle sfide di Hot Spot Treasure, lo strumento di tendenze di Douyin: l'intera classifica di 50 tendenze in una sola chiamata. Ogni tendenza ha posizione, titolo, ID, popolarità, numero di video correlati, data di creazione e una curva di popolarità campionata circa ogni dieci minuti. limit può solo ridurre il numero, e non c'è paginazione.

Questa azione non ha parametri di business. Invia solo gli identificativi della piattaforma e dell'azione.

Cosa significano i parametri billboard_topic_hot di API di Douyin?

Scopri quali hashtag di Douyin stanno guadagnando popolarità, dalla classifica degli hashtag di Hot Spot Treasure, nell'ultima ora, nell'ultimo giorno, negli ultimi 3 o 7 giorni. Ogni hashtag ha posizione, ID numerico per hashtag_detail, nome, popolarità, visualizzazioni e contenuti totali, media di visualizzazioni per contenuto, copertina e fino a 14 giorni di popolarità giornaliera. 50 per pagina; vai avanti con next_page_token.

keywordFacoltativo

Facoltativo: mantieni solo gli hashtag il cui nome contiene questa parola, ad esempio food; omettilo per l'intera classifica degli hashtag.

page_tokenFacoltativo

Token di pagina. Omettilo per la prima pagina (i primi 50 hashtag), poi ripassa il next_page_token della risposta precedente esattamente come ricevuto, lasciando invariati gli altri parametri. Ogni pagina contiene fino a 50 hashtag e corrisponde a una chiamata; i token durano 24 ore e l'ultima pagina non ha next_page_token (al massimo circa 1.000 hashtag per classifica).

time_windowFacoltativo

Finestra temporale per la popolarità degli hashtag: 1h, 1d (predefinita), 3d o 7d.

Valori ammessi:1d1h3d7d

Cosa significano i parametri music_detail di API di Douyin?

Leggi un brano Douyin tramite il music_id numerico ottenuto da music_search, o un link douyin.com/music. Ottieni titolo, artista, durata, quanti contenuti lo usano, copertina, un link di riproduzione e un link al testo quando disponibile. Le ricerche per titolo del brano si fanno con music_search.

music_idObbligatorio

ID numerico di un brano musicale Douyin, ad esempio 7699717253151558410, preso dall'id di una riga di music_search; è accettato anche un link douyin.com/music/<ID>.

Cosa significano i parametri xingtu_conversion_ability di API di Douyin?

Leggi i dati di conversione che Xingtu mostra per i video su commissione Xingtu di un creator Douyin negli ultimi 7, 30 o 90 giorni: video correlati, riproduzioni mediane, clic sui componenti e tasso di clic, CPC, GPM, vendite medie, prodotti promossi e relative categorie. La maggior parte dei valori sono intervalli espressi con le diciture di Xingtu, come 500-1000, mentre quelli aperti, come "10% o più", sono in cinese. Solo i creator con ordini Xingtu nella finestra hanno dati; gli altri restituiscono un risultato vuoto, che non viene addebitato.

douyin_idObbligatorio

L'ID Douyin visibile del creator (unique_id, da creator_search) o il creator_id Xingtu di 19 cifre restituito da xingtu_creator_search. Un creator non presente su Xingtu produce un risultato vuoto, che non viene addebitato.

time_windowFacoltativo

Periodo dei dati Xingtu: 7d, 30d (predefinito) o 90d, contato a ritroso da oggi. Non è il periodo della classifica di xingtu_creator_rankings.

Valori ammessi:30d7d90d

Cosa significano i parametri xingtu_link_structure di API di Douyin?

Scopri quanti utenti Xingtu considera collegati a un creator Douyin, suddivisi nei quattro livelli di Xingtu, ciascuno con il suo numero, la sua quota sul totale e la mediana dei creator dello stesso settore. Ottieni anche il totale, la sua posizione tra i creator Xingtu (total_rank_top_percent, da 0 a 1, più basso è meglio) e l'etichetta del tipo di collegamento di Xingtu, in cinese, che indica seeding o diffusione.

douyin_idObbligatorio

L'ID Douyin visibile del creator (unique_id, da creator_search) o il creator_id Xingtu di 19 cifre restituito da xingtu_creator_search. Un creator non presente su Xingtu produce un risultato vuoto, che non viene addebitato.

Cosa significano i parametri xingtu_recommended_videos di API di Douyin?

Elenca i quattro gruppi di video della pagina Xingtu di un creator Douyin: video rappresentativi, video più recenti, migliori video su commissione Xingtu e migliori video personali. Ogni video include solo ID, link, numero di riproduzioni e data di pubblicazione. Un gruppo senza video viene omesso.

douyin_idObbligatorio

L'ID Douyin visibile del creator (unique_id, da creator_search) o il creator_id Xingtu di 19 cifre restituito da xingtu_creator_search. Un creator non presente su Xingtu produce un risultato vuoto, che non viene addebitato.

Cosa significano i parametri xingtu_touch_distribution di API di Douyin?

Scopri da quali categorie di contenuti provengono gli utenti collegati a un creator Douyin, secondo i conteggi di Xingtu: un albero fino a tre livelli, di solito contenuti personali contro contenuti Xingtu, poi categoria e sottocategoria, ciascuno con un conteggio.

douyin_idObbligatorio

L'ID Douyin visibile del creator (unique_id, da creator_search) o il creator_id Xingtu di 19 cifre restituito da xingtu_creator_search. Un creator non presente su Xingtu produce un risultato vuoto, che non viene addebitato.

Cosa significano i parametri xingtu_video_performance di API di Douyin?

Confronta i video personali e i video su commissione Xingtu di un creator Douyin per tasso di engagement, riproduzioni mediane e tasso di completamento. Ogni metrica ha il valore del creator, la media della piattaforma e il percentile (la quota di creator che supera, da 0 a 1). Ottieni anche gli ultimi video personali e su commissione Xingtu, fino a circa 15 per tipo, con titolo, riproduzioni, like, commenti, condivisioni e durata.

douyin_idObbligatorio

L'ID Douyin visibile del creator (unique_id, da creator_search) o il creator_id Xingtu di 19 cifre restituito da xingtu_creator_search. Un creator non presente su Xingtu produce un risultato vuoto, che non viene addebitato.