douyin/
video-detail

Trasforma l’URL di un video Douyin noto in un record normalizzato con identità del video, didascalia, contesto del creator, media, durata, timestamp e campi di engagement visibili, quando disponibili.

Douyin Video Detail API

URL Douyin supportato
Un video normalizzato
0,10 crediti per attività
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 Detail

Un record di dettaglio di un video Douyin collega l’URL di un video pubblico noto a contenuto, creator, media, tempistiche e campi di engagement visibili normalizzati. È utile quando un flusso di lavoro ha già il link esatto di un video e ha bisogno di un record coerente per l’arricchimento, la revisione o un confronto successivo.

Funzionalità della Douyin Video Detail API

  • URL Douyin supportatoAccetta un URL su douyin.com, iesdouyin.com o un sottodominio supportato. Quando compare /video/, deve essere seguito da un ID numerico.
  • Risultato limitato a un solo videoEsegue una sola richiesta di dettaglio al provider e salva al massimo un record di video normalizzato, senza paginazione della fonte né results_limit.
  • Contesto di didascalia e creatorRestituisce il testo disponibile del video insieme a ID del creator, nome utente, nome visualizzato, URL del profilo, avatar e flag dell’account normalizzati.
  • Campi di media e durataMantiene i riferimenti disponibili a video o immagini, le anteprime, le dimensioni, la durata dei media e il campo normalizzato duration_seconds.
  • Istantanea dell’engagement con timestampAbbina i conteggi disponibili di Mi piace, commenti, condivisioni, riproduzioni e visualizzazioni a published_at e collected_at, invece di presentarli come contatori in tempo reale.

Parametri della Douyin Video Detail API

ParametriObbligatorioDescrizione
urlObbligatorioURL obbligatorio e non vuoto su douyin.com, iesdouyin.com o un sottodominio supportato. Se è presente /video/, deve essere seguito da un ID numerico; per attività è accettato un solo URL.

Come usare la Douyin Video Detail API

Invia un URL di video Douyin supportato, segui l’attività asincrona e leggi il relativo risultato normalizzato salvato dopo il successo.

  1. Imposta DOUYIN_VIDEO_URL su un URL pubblico il cui host è douyin.com, iesdouyin.com o un sottodominio. Un segmento /video/, quando presente, deve essere seguito da un ID numerico.
  2. Invia con POST la stringa url a /v1/douyin/video-detail e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività riesce o fallisce; i campi del risultato non sono disponibili finché è incompleta.
  4. Dopo il successo leggi data.results.items. Il provider produce al massimo un elemento, mentre limit e next_cursor appartengono al lettore dei risultati salvati di SocQ.
curl -X POST "https://api.socq.ai/v1/douyin/video-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"url\":\"$DOUYIN_VIDEO_URL\"}"

# Poll GET /v1/tasks/{task_id}
# Read the normalized video from data.results.items

Casi d’uso della Douyin Video Detail API

  • Arricchire i cataloghi di video noti: Aggiungi identità, didascalia, creator, orario di pubblicazione, durata, media e campi di origine normalizzati ai link approvati di video Douyin.
  • Collegare la scoperta al dettaglio: Usa l’URL di un video supportato, conservato da un record di video di un utente o di ricerca video di Douyin, come input esatto per una ricerca mirata di dettaglio.
  • Preparare confronti in momenti diversi: Salva i risultati riusciti ripetuti con collected_at per confrontare le istantanee disponibili dell’engagement pubblico secondo una pianificazione definita.

Consigli degli esperti per la Douyin Video Detail API

  • Usa un riferimento pubblico diretto a un video su un hostname supportato per ottenere una risoluzione utile dal provider; se contiene /video/, mantieni intatto l’ID numerico del video.
  • Lascia vuoto il campo del Playground finché non hai un vero URL di video pubblico; questo endpoint non ha un valore predefinito universale affidabile.
  • Invia un URL per attività e ometti results_limit, cursor e ID non pertinenti, perché la richiesta pubblica accetta solo url.
  • Tratta i campi mancanti di creator, media, audio, hashtag, menzioni o engagement come non disponibili, non come stringhe vuote o zero.
  • Usa collected_at per i confronti delle metriche e published_at per la cronologia dei contenuti; descrivono momenti diversi.
  • Se prosegui con i commenti del video, passa a quell’endpoint separato un URL di video supportato e disponibile, senza dare per scontato che l’attività di dettaglio si estenda ai commenti.

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

Douyin Video Detail API recupera un video pubblico di Douyin da un URL supportato, restituendo un record reel-video normalizzato con identità, didascalia, creator, media, durata, timestamp e campi di engagement visibili, quando disponibili.

Usa un URL il cui hostname è douyin.com, iesdouyin.com o un sottodominio. Se l’URL contiene /video/, l’identificatore successivo deve essere numerico.

Quando possibile usa un riferimento pubblico diretto al video. Il validatore dell’input accetta gli host Douyin supportati e controlla un ID numerico ogni volta che compare /video/, ma il provider ha comunque bisogno di un riferimento al video risolvibile per restituire dati.

Lo schema reel-video può contenere campi base di identità e di tempo, testo della didascalia, contesto del creator, media, hashtag, menzioni, shortcode, durata, audio e conteggi disponibili di Mi piace, commenti, condivisioni, riproduzioni e visualizzazioni. I campi facoltativi possono essere null.

No. Il provider esegue una sola richiesta di dettaglio e può salvare al massimo un elemento. limit, has_more e next_cursor fanno parte del lettore condiviso dei risultati delle attività di SocQ, non della paginazione del provider.

La POST restituisce un task_id. Interroga /v1/tasks/{task_id}; data.results compare dopo il successo dell’attività e un cursore viene rifiutato finché l’attività è incompleta.

Ogni attività riuscita ha un addebito fisso di 0,10 crediti SocQ. L’addebito non cresce con il numero di risultati, perché si tratta di un’attività fissa di dettaglio singolo.