Douyin Video Comments
I commenti ai video di Douyin sono risposte pubbliche collegate a un video, con testo, identità dell’autore, contesto di pubblicazione e segnali visibili di Mi piace o risposte. Questi record supportano l’analisi delle reazioni del pubblico, la mappatura delle conversazioni e il confronto dell’engagement in un preciso momento.
Funzionalità della Douyin Video Comments API
- Selezione diretta del videoRicava l’ID numerico del video da un URL pubblico di douyin.com o iesdouyin.com il cui percorso contiene /video/{numeric_id}.
- Raccolta limitata a una paginaRichiedi fino a 20 righe di commenti dalla prima pagina di origine, con results_limit che controlla il sottoinsieme salvato da 1 a 20.
- Contesto canonico dei commentiRestituisce record CommentItem 1.0 con testo, identità dell’autore, relazioni con video e commento padre, orari di pubblicazione e di raccolta e conteggi visibili di Mi piace o risposte.
Parametri della Douyin Video Comments API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio | URL pubblico obbligatorio su douyin.com, iesdouyin.com o un sottodominio. Il percorso deve contenere /video/ seguito da un ID numerico del video. |
results_limit | Facoltativo | Intero facoltativo da 1 a 20. Se omesso, il valore predefinito è 20; l’integrazione richiede solo la prima pagina di origine. |
Come usare la Douyin Video Comments API
Imposta l’URL diretto di un video pubblico di Douyin, invia l’attività asincrona e leggi i commenti normalizzati salvati per quell’attività.
- Imposta DOUYIN_VIDEO_URL su un URL pubblico di douyin.com o iesdouyin.com con un percorso /video/{numeric_id}.
- Invia con POST url e il results_limit facoltativo a /v1/douyin/video-comments, poi salva il task_id.
- Interroga /v1/tasks/{task_id} finché l’attività riesce o fallisce.
- Leggi data.results.items e segui next_cursor solo finché has_more è true, per proseguire tra i record già salvati da SocQ.
curl -X POST "https://api.socq.ai/v1/douyin/video-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"url\":\"${DOUYIN_VIDEO_URL}\",\"results_limit\":20}"
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso della Douyin Video Comments API
- Analisi delle reazioni del pubblico: Usa testo dei commenti, identità dell’autore e conteggi visibili di Mi piace o risposte per esaminare le reazioni a un video pubblico noto.
- Mappatura delle relazioni tra commenti: Collega i commenti restituiti al video di origine e a un eventuale riferimento padre fornito, tramite post_id e parent_id.
- Confronto delle istantanee dell’engagement: Confronta i segnali visibili dei commenti tra video selezionati o momenti di raccolta diversi, conservando collected_at come timestamp dell’osservazione.
Consigli degli esperti per la Douyin Video Comments API
- Risolvi un link condiviso o reindirizzato nell’URL finale accettato /video/{numeric_id} prima di inviarlo, così la validazione di host e percorso va a buon fine.
- Ometti results_limit per richiedere 20 righe, oppure scegli un intero più piccolo quando ti serve solo un sottoinsieme dell’unica pagina di origine restituita.
- Riusa il task_id originale e segui next_cursor solo quando has_more è true; quel cursore legge righe già salvate e non recupera un’altra pagina di origine.
- Usa l’id del commento come chiave principale di deduplicazione e lascia che parent_id o post_id restino null quando la riga di origine omette una relazione.
- Tratta dettagli dell’autore, published_at e singole metriche come facoltativi e usa collected_at come timestamp di ogni istantanea dei risultati.
- Applica l’escape al testo dei commenti prima di inserirlo in HTML, perché i commenti pubblici sono contenuti generati dagli utenti.
API correlate
Oltre alla Douyin Video Comments 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 Detail API
- Douyin Video Search API