douyin/
user-videos

Raccogli fino a 20 video pubblici da un URL di profilo Douyin o da un ID utente noto, con contenuto normalizzato, autore, media, durata, timestamp e campi di engagement visibili.

Douyin User Videos API

URL del profilo o ID utente
Fino a 20 video
Record di video normalizzati
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 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

ParametriObbligatorioDescrizione
urlObbligatorio (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_idObbligatorio (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_limitFacoltativoIl 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.

  1. Prepara un URL di profilo Douyin su douyin.com o iesdouyin.com con un percorso /user/{identifier}, oppure uno user_id noto.
  2. Invia con POST l’identità e un results_limit facoltativo da 1 a 20 a /v1/douyin/user-videos, poi salva il task_id.
  3. Interroga /v1/tasks/{task_id} finché l’attività riesce o fallisce.
  4. 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 results

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

Oltre alla Douyin User Videos 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 User Videos API — FAQ

Douyin User Videos API restituisce record di video pubblici normalizzati di un creator, con identità, didascalia, contesto dell’autore, URL di origine, timestamp, media, durata e campi di engagement visibili, quando disponibili.

Uno qualsiasi dei due campi soddisfa il requisito di input. Un URL deve usare un host Douyin supportato e contenere /user/{identifier}; uno user_id noto può essere fornito direttamente e prevale se sono presenti entrambi i campi.

Controlla il numero di record richiesti per la singola pagina del provider. Il valore deve essere un intero da 1 a 20 e ha 20 come valore predefinito.

Un risultato può includere riproduzioni, Mi piace, commenti, condivisioni e visualizzazioni. Ogni campo è facoltativo, quindi i valori non disponibili alla fonte restano null e non vengono dedotti.

No. La richiesta al provider usa solo la prima pagina. next_cursor sul lettore dei risultati dell’attività di SocQ pagina i record già salvati per quell’attività.

Ogni attività Douyin User Videos riuscita costa 0,10 crediti SocQ fissi, indipendentemente dal numero di record restituiti entro il limite di 20 record.