douyin/
video-search

Cerca la prima pagina fissa di video pubblici di Douyin con una query di testo, con didascalie normalizzate, contesto dell’autore, media, durata, timestamp ed engagement visibile, quando disponibili.

Douyin Video Search API

Query di testo
Prima pagina fissa
Video normalizzati
0,1 crediti per richiesta
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

Douyin Video Search

Douyin Video Search trasforma una query di testo non vuota in un dataset limitato di video pubblici. Ogni attività effettua una richiesta fissa al provider per la pagina 1 con offset 0, poi salva i record restituiti nel formato reel-video di SocQ, per una lettura coerente a valle.

Funzionalità della Douyin Video Search API

  • Contratto di ricerca a campo unicoInvia solo query. L’endpoint rifiuta gli input non dichiarati, come results_limit, e non richiede un token del provider né un identificatore interno.
  • Richiesta limitata alla fonteOgni attività chiede al provider la pagina 1 con offset 0, senza esporre a chi chiama i controlli di paginazione del provider.
  • Record reel-video normalizzatiLeggi testo, autore, media, durata, timestamp e conteggi visibili di riproduzioni, Mi piace, commenti e condivisioni disponibili attraverso uno schema di risultato coerente.
  • Letture asincrone dei risultati salvatiInvia una volta, interroga l’attività e usa il cursore dei risultati di SocQ solo quando l’attività completata ha salvato più record di quanti ne restituisca una pagina di risposta.

Parametri della Douyin Video Search API

ParametriObbligatorioDescrizione
queryObbligatorioUna query di testo obbligatoria e non vuota. Viene mappata sul campo delle parole chiave del provider, mentre pagina e offset restano fissati dal backend.

Come usare la Douyin Video Search API

Fornisci una query non vuota, attendi l’attività asincrona e leggi i record normalizzati salvati per quell’attività.

  1. Scegli una query di testo specifica che descriva i video pubblici che vuoi scoprire.
  2. Invia con POST query a /v1/douyin/video-search e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività riesce o segnala un errore.
  4. Leggi data.results.items. Se has_more è true, passa next_cursor alla richiesta dei risultati dell’attività per proseguire tra i record SocQ salvati.
curl -X POST "https://api.socq.ai/v1/douyin/video-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"street food"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; next_cursor pages stored SocQ results only

Casi d’uso della Douyin Video Search API

  • Scoperta di video per argomento: Crea un’istantanea limitata dei video pubblici restituiti per un prodotto, un tema, un evento o una frase di ricerca.
  • Analisi del contesto dei creator: Collega didascalie e media restituiti ai campi pubblici disponibili dell’autore, per la ricerca qualitativa e l’arricchimento dei dataset.
  • Analisi di formati e media: Esamina i media video disponibili, le miniature, le dimensioni e la durata insieme al record di origine e al contesto della query.
  • Istantanee dell’engagement visibile: Confronta i conteggi disponibili di riproduzioni, Mi piace, commenti e condivisioni, conservando collected_at come orario dell’osservazione.

Consigli degli esperti per la Douyin Video Search API

  • Nella tua interfaccia richiedi un testo di query significativo, non composto solo da spazi, prima di inviare l’attività.
  • Non inviare results_limit, page, offset, search_id né un cursore del provider; non fanno parte dello schema pubblico delle richieste di SocQ.
  • Considera l’insieme restituito come un’unica risposta del provider, non come un indice di ricerca esaustivo né come una finestra di classifica controllata da chi chiama.
  • Usa cursor e limit di GET /v1/tasks/{task_id} solo per leggere i risultati salvati; limit ha 50 come valore predefinito e accetta da 1 a 500.
  • Conserva collected_at e gestisci i campi facoltativi di autore, media, pubblicazione, durata e singole metriche senza sostituire con zero i valori mancanti.

Oltre alla Douyin Video Search API, usa queste API quando ti serve un altro tipo di dati pubblici di Douyin.

Esplora altre piattaforme

Combina i dati di Douyin con i dati pubblici delle altre piattaforme social supportate.

Douyin Video Search API — FAQ

Douyin Video Search API cerca la prima pagina fissa dei video pubblici di Douyin con una query di testo e restituisce record reel-video normalizzati.

È accettato solo query, che deve essere una stringa non vuota. L’endpoint non accetta results_limit, page, offset né un cursore del provider fornito da chi chiama.

No. Il backend invia sempre pagina 1 e offset 0 in un’unica richiesta al provider e non espone controlli di paginazione della fonte.

Un next_cursor restituito da GET /v1/tasks/{task_id} avanza tra i record già salvati da SocQ per l’attività completata. Non recupera un’altra pagina di origine di Douyin.

I risultati usano lo schema reel-video e possono includere ID, URL, testo, contesto pubblico dell’autore, media, durata, orari di pubblicazione e di raccolta, hashtag, menzioni, audio e conteggi visibili di riproduzioni, Mi piace, commenti e condivisioni. I campi facoltativi possono essere null o vuoti.

Ogni attività riuscita costa 0,10 crediti SocQ fissi, indipendentemente dal numero di record restituiti dalla singola richiesta al provider.