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.

douyin/live-room-detail
Ricerca0,1 crediti per richiesta

douyin/user-profile
Profili0,1 crediti per richiesta

douyin/user-videos
Post0,1 crediti per richiesta

douyin/video-comments
Commenti0,1 crediti per richiesta

douyin/video-detail
Post0,1 crediti per richiesta

douyin/video-search
Ricerca0,1 crediti per richiesta
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 API | Input iniziale | Limite della fonte |
|---|---|---|
| Profilo e video dei creator | url o user_id | Un profilo o una pagina della fonte; i video dei creator supportano results_limit da 1 a 20 |
| Dettagli dei video e commenti | URL supportato | Un record di dettaglio o una pagina di commenti; i commenti supportano results_limit da 1 a 20 |
| Ricerca di video | Query non vuota | Prima pagina fissa della fonte, senza results_limit |
| Diretta | room_id composto solo da cifre | Al 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. Scegli l’endpoint
Seleziona l’endpoint per profili, video, commenti, ricerca o dirette che corrisponde al riferimento pubblico che hai già.
2. Invia un input valido
Invia con POST solo i campi dichiarati e salva il task_id restituito.
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.
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 successCasi 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.
Combina i dati di più piattaforme per analisi di business più complete
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.
YouTube API
Raccogli profili dei canali YouTube pubblici supportati, dettagli dei video, video dei canali, commenti, Shorts, risultati per parola chiave e hashtag e trascrizioni disponibili con un unico flusso di lavoro asincrono normalizzato.
Facebook API
Raccogli profili di pagine Facebook pubbliche, post, post di gruppi, commenti, eventi trovati per parola chiave e trascrizioni disponibili dei video, con campi normalizzati di identità, contenuti, origine, formato, luogo, media, reazioni, partecipazione ed engagement.
X API
Raccogli profili pubblici, relazioni di follower e seguiti, post, risposte, citazioni, repost, risultati di ricerca e tendenze attuali. Usa risultati coerenti per ricerca e monitoraggio.
LinkedIn API
Recupera dati pubblici di profili, aziende, post e offerte di lavoro su LinkedIn a partire da URL noti, con campi normalizzati su identità, carriera, azienda, contenuti, engagement e offerte.
Reddit API
Recupera post e commenti pubblici di Reddit a partire da URL noti, sfoglia i post new, top o hot dei subreddit oppure cerca discussioni per parola chiave e periodo di pubblicazione.
Pinterest API
Recupera dati pubblici dei profili Pinterest, risolvi Pin noti, raccogli i Pin di profili selezionati o cerca per parola chiave per ricerche su creator, contenuti e tendenze visive.