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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio | URL 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.
- 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.
- Invia con POST la stringa url a /v1/douyin/video-detail e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività riesce o fallisce; i campi del risultato non sono disponibili finché è incompleta.
- 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.itemsCasi 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.
API correlate
Oltre alla Douyin Video Detail 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 User Videos API
- Douyin Video Comments API
- Douyin Video Search API