Douyin User Videos
Questo endpoint trasforma l’identità di un creator di Douyin in un insieme di record di video pubblici su una sola pagina. Ogni record può includere didascalia, contesto dell’autore, URL di origine, orari di pubblicazione e di raccolta, media, durata e conteggi visibili di riproduzioni, Mi piace, commenti, condivisioni o visualizzazioni, quando la fonte li fornisce.
Funzionalità della Douyin User Videos API
- Due modi per identificare un creatorInvia un URL di profilo Douyin supportato oppure uno user_id noto. Se sono presenti entrambi i campi, viene usato direttamente user_id.
- Ambito esplicito di una sola paginaScegli da 1 a 20 risultati richiesti, con 20 come valore predefinito e massimo; la richiesta al provider parte sempre dalla sua prima pagina.
- Contesto del video e del creator insiemeMantieni in ogni record di reel-video didascalie normalizzate, campi pubblici dell’autore, URL di origine, timestamp, riferimenti ai media e durata.
- Campi di engagement pronti per l’osservazioneConserva riproduzioni, Mi piace, commenti, condivisioni e visualizzazioni disponibili con collected_at, così ogni conteggio visibile resta legato al suo orario di raccolta.
Parametri della Douyin User Videos API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio (almeno uno) | Un riferimento a un profilo Douyin il cui hostname è douyin.com, iesdouyin.com o un sottodominio e il cui percorso contiene /user/{identifier}. Fornisci url o user_id; user_id ha la precedenza quando sono presenti entrambi. |
user_id | Obbligatorio (almeno uno) | Un identificatore utente noto, composto da 1–256 lettere ASCII, numeri, due punti, trattini bassi o trattini. Fornisci user_id o url. |
results_limit | Facoltativo | Il numero di record richiesti dalla singola pagina del provider. Accetta interi da 1 a 20 e ha 20 come valore predefinito. |
Come usare la Douyin User Videos API
Invia l’identità di un creator pubblico, segui l’attività asincrona e leggi i record di video normalizzati salvati.
- Prepara un URL di profilo Douyin su douyin.com o iesdouyin.com con un percorso /user/{identifier}, oppure uno user_id noto.
- Invia con POST l’identità e un results_limit facoltativo da 1 a 20 a /v1/douyin/user-videos, poi salva il task_id.
- Interroga /v1/tasks/{task_id} finché l’attività riesce o fallisce.
- Leggi data.results.items; segui next_cursor solo per altri record già salvati da SocQ, non per un’altra pagina del provider.
curl -X POST "https://api.socq.ai/v1/douyin/user-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"'"$DOUYIN_PROFILE_URL"'","results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and use next_cursor only for stored resultsCasi d’uso della Douyin User Videos API
- Istantanee del feed di un creator: Salva un insieme limitato di video pubblici e i timestamp di raccolta di un creator in un momento di osservazione scelto.
- Arricchimento del catalogo di video: Aggiungi didascalie normalizzate, identità dell’autore, URL di origine, orario di pubblicazione, durata e media disponibili a un record di creator esistente.
- Analisi di creatività e formati: Esamina didascalie, durata e campi media restituiti per organizzare i video disponibili in base al tipo di contenuto o al formato.
- Confronto dell’engagement all’interno di un’istantanea: Confronta riproduzioni, Mi piace, commenti, condivisioni e visualizzazioni disponibili tra i video restituiti, conservando collected_at.
Consigli degli esperti per la Douyin User Videos API
- Preferisci un solo campo di identità per richiesta. Se url e user_id sono entrambi presenti, il backend sceglie user_id.
- Valida l’host dell’URL e il percorso /user/{identifier} prima dell’invio; l’URL generico di un video Douyin non soddisfa questo endpoint.
- Imposta results_limit solo quando ti bastano meno dei 20 record predefiniti; deve essere un intero da 1 a 20.
- Non considerare il cursore dei risultati dell’attività come un cursore di origine di Douyin. La richiesta alla fonte è di una sola pagina, con il cursore del provider fissato sulla prima pagina.
- Lascia che autore, media, durata, orario di pubblicazione e singole metriche facoltativi restino null o vuoti e usa id insieme a collected_at quando salvi le osservazioni.
API correlate
Oltre alla Douyin User Videos 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 Video Comments API
- Douyin Video Detail API
- Douyin Video Search API