douyin/
video-comments

Raccogli una pagina di commenti pubblici da un URL diretto di un video Douyin, con testo normalizzato, autore, relazioni, orario e campi di engagement visibili.

Douyin Video Comments API

URL diretto del video
Una pagina di origine
CommentItem 1.0
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 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

ParametriObbligatorioDescrizione
urlObbligatorioURL pubblico obbligatorio su douyin.com, iesdouyin.com o un sottodominio. Il percorso deve contenere /video/ seguito da un ID numerico del video.
results_limitFacoltativoIntero 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à.

  1. Imposta DOUYIN_VIDEO_URL su un URL pubblico di douyin.com o iesdouyin.com con un percorso /video/{numeric_id}.
  2. Invia con POST url e il results_limit facoltativo a /v1/douyin/video-comments, poi salva il task_id.
  3. Interroga /v1/tasks/{task_id} finché l’attività riesce o fallisce.
  4. 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 true

Casi 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.

Oltre alla Douyin Video Comments 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 Comments API — FAQ

Douyin Video Comments API raccoglie una pagina di commenti pubblici da un URL di video Douyin con un percorso numerico del video, restituendo testo normalizzato, autore, relazioni, orario e campi visibili di Mi piace o risposte.

L’url deve usare douyin.com, iesdouyin.com o un sottodominio e il suo percorso deve contenere /video/ seguito da un ID numerico. I percorsi di profilo, di ricerca e quelli non relativi a video vengono rifiutati.

results_limit accetta interi da 1 a 20 e ha 20 come valore predefinito. L’attività richiede una sola pagina di origine, quindi non può proseguire in altre pagine di origine.

CommentItem 1.0 include i campi base di identità e di orario, più testo, autore, parent_id, post_id e metrics, che contiene likes_count e replies_count. I campi facoltativi della fonte restano null quando non sono disponibili.

Non effettua una richiesta separata per le pagine di risposte. Una riga restituita può esporre replies_count e un parent_id quando li fornisce la fonte, ma quei campi non implicano che il testo delle risposte sia stato raccolto.

next_cursor appartiene a GET /v1/tasks/{task_id} e pagina i record che SocQ ha già salvato dopo il successo. Non richiede mai la pagina di origine successiva di Douyin.

Ogni attività riuscita costa 0,10 crediti SocQ fissi, indipendentemente da results_limit o dal numero di elementi restituiti; le attività fallite seguono il percorso di rimborso del runtime.