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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | Una 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à.
- Scegli una query di testo specifica che descriva i video pubblici che vuoi scoprire.
- Invia con POST query a /v1/douyin/video-search e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività riesce o segnala un errore.
- 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 onlyCasi 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.
API correlate
Oltre alla Douyin Video Search API, usa queste API quando ti serve un altro tipo di dati pubblici di Douyin.
- Douyin Live Room Detail API — Recupera una diretta Douyin nota tramite l’ID numerico della stanza con contesto normalizzato della stanza, identità dell’host, media e conteggi visibili del pubblico.
- Douyin User Profile API
- Douyin User Videos API
- Douyin Video Comments API
- Douyin Video Detail API