Torna alle API
Dati pubblici di Douyin

Douyin Public Data APIs

Recupera profili e video pubblici, cerca video, raccogli una pagina di commenti o di video di un creator e ispeziona una diretta nota.

API di Douyin disponibili

Scegli tra sei API per i flussi di lavoro su profili, video, commenti, ricerca e dirette.

Quali dati di Douyin puoi recuperare?

Il catalogo di Douyin restituisce record normalizzati di account, reel-video, commenti e dirette a partire da dati pubblici della fonte.

Profili e video dei creator

Risolvi un profilo pubblico o raccogli una pagina della fonte con i video di un URL di profilo supportato o di uno user_id.

Dettagli dei video, ricerca e commenti

Ispeziona un riferimento video supportato, cerca per query nella prima pagina fissa della fonte o raccogli una pagina di commenti.

Dettagli delle dirette

Recupera una diretta nota tramite room_id composto solo da cifre, con host, stato, media e campi visibili sul pubblico, quando disponibili.

Le specifiche delle API di Douyin in sintesi

Ogni endpoint ha una richiesta alla fonte limitata e rifiuta i parametri non dichiarati.

Gruppo di APIInput inizialeLimite della fonte
Profilo e video dei creatorurl o user_idUn profilo o una pagina della fonte; i video dei creator supportano results_limit da 1 a 20
Dettagli dei video e commentiURL supportatoUn record di dettaglio o una pagina di commenti; i commenti supportano results_limit da 1 a 20
Ricerca di videoQuery non vuotaPrima pagina fissa della fonte, senza results_limit
Direttaroom_id composto solo da cifreAl massimo un record di diretta

Come funzionano le API di Douyin

Tutti e sei gli endpoint usano lo stesso flusso asincrono di invio, interrogazione e lettura dei risultati salvati.

  1. 1. Scegli l’endpoint

    Seleziona l’endpoint per profili, video, commenti, ricerca o dirette che corrisponde al riferimento pubblico che hai già.

  2. 2. Invia un input valido

    Invia con POST solo i campi dichiarati e salva il task_id restituito.

  3. 3. Leggi i risultati normalizzati

    Interroga l’attività fino a uno stato finale, poi leggi data.results.items e usa next_cursor solo per la paginazione dei risultati salvati.

Cerca i video pubblici di Douyin

Autenticati con una chiave API di SocQ e invia una query non vuota. Ogni attività Douyin riuscita costa un importo fisso di 0,10 crediti.

curl -X POST "https://api.socq.ai/v1/douyin/video-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"artificial intelligence"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after success

Casi d’uso comuni delle API di Douyin

Ricerca sui creator

Combina l’identità pubblica del profilo con una pagina limitata di video del creator e l’engagement visibile.

Analisi di contenuti e conversazioni

Arricchisci video noti, cerca un’istantanea su un argomento e ispeziona una pagina di commenti pubblici.

Monitoraggio delle dirette

Registra un’istantanea di una diretta pubblica nota usando un identificatore numerico esplicito della stanza.

Limiti e policy sui dati pubblici

Questi endpoint leggono dati pubblici con richieste limitate alla fonte e non offrono azioni sugli account né monitoraggio continuo.

  • user_id accetta da 1 a 256 caratteri ASCII tra lettere, numeri, due punti, trattini bassi o trattini; gli URL dei profili devono contenere /user/{identifier} su un host Douyin supportato.
  • room_id è una stringa composta solo da cifre; evita di trattare gli identificatori lunghi come numeri JavaScript.
  • results_limit è disponibile solo per User Videos e Video Comments, con un intervallo da 1 a 20 e un valore predefinito di 20.
  • Video Search è fissato alla prima pagina della fonte; i cursori dei risultati delle attività paginano solo i record già salvati per quell’attività.
  • Ogni attività Douyin riuscita costa un importo fisso di 0,10 crediti.

Domande frequenti sulle API di Douyin

Che cosa sono le API di Douyin?

Le API di Douyin recuperano come record normalizzati profili, video, commenti, risultati di ricerca di video e dettagli delle dirette pubblici.

Quali endpoint accettano results_limit?

User Videos e Video Comments accettano un intero da 1 a 20. Gli altri endpoint di Douyin rifiutano results_limit.

Posso paginare la fonte?

Non è disponibile alcun cursore della fonte controllabile da chi chiama. Un next_cursor restituito pagina solo i risultati già salvati per l’attività completata.

Quanto costano le richieste a Douyin?

Ogni attività riuscita costa un importo fisso di 0,10 crediti SocQ.

Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.