API Douyin Link di download dei media

POST

Stato di salute dell'API

Operatività nelle ultime 24 ore
Normale
  • Buono / normale
  • Disponibile
  • Limitato
  • Quasi del tutto inattivo
Normale

Ultime 24 ore

Ultimi 30 giorni

Ottieni i link di download per un massimo di 20 video Douyin in una sola volta da urls, indicando ciascuno come ID numerico del video o link https://www.douyin.com/video/<video_id>; short link e testi di condivisione non sono accettati. Ogni video trovato è una riga con video_url, best_stream (lo stream con il bitrate più alto), stream_count, video_width, video_height, video_size_bytes, has_watermark, cover_image_url, covers, image_urls, audio_url e input. I link sono firmati e scadono; expires_at è la scadenza più vicina della riga. Invia i request_headers della riga con ogni download, altrimenti Douyin potrebbe rifiutarlo. Imposta fresh a true per ignorare i link in cache (default false). Addebitato per video; i video non trovati non vengono addebitati e tornano in missed. Ogni voce può comparire una sola volta e un array che viola le regole restituisce 422 prima di qualsiasi addebito.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su douyin e action impostato su media_links. Prezzo $0.56 per 1.000 richieste ($0.000556 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Ogni elemento di urls conta come una chiamata: il numero di elementi che invii determina l'addebito. Solo sincrona: tutti i dati restituiti (ogni target di un batch o ogni SKU di un prodotto) vengono recuperati nell'ambito di questa chiamata; "mode": "async" restituisce un errore 422 prima di qualsiasi addebito.

Prompt per l'AI

#
Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Douyin Link di download dei media di EveryInfra (douyin/media_links).

Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su douyin e action su media_links, e inserisci i parametri in params.
- Parametri obbligatori:
  - urls: I video di cui ottenere i link di download, come array di massimo 20 voci; ogni voce può comparire una sola volta. Ogni voce è un ID numerico del video o un link https://www.douyin.com/video/<video_id>.
- Parametri facoltativi:
  - fresh: Per media_links: true ignora i link in cache e li recupera di nuovo; default false. I link sono firmati e scadono, e expires_at indica quando.
  - limit: Numero massimo di righe da restituire in questa chiamata: un intero pari o superiore a 1. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe.
- Restituisce un elenco di record. Campi principali di ogni record: id, url, media_type (Tipo di media: video, oppure image per…), video_url (URL di riproduzione del video (firmato,…), video_url_expires_at, video_width (Larghezza del fotogramma del video in p…), video_height (Altezza del fotogramma del video in pix…), video_size_bytes (Dimensione del file video in byte (medi…), has_watermark, best_stream (Lo stream video con il bitrate più alto…), stream_count (Quanti stream video di qualità diversa…), cover_image_url (URL dell'immagine di copertina: la cope…); 19 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Esempio di corpo della richiesta:
{
  "platform": "douyin",
  "action": "media_links",
  "params": {
    "urls": [
      "https://www.douyin.com/video/<VIDEO_ID_A>"
    ]
  }
}
- Prezzo: $0.56 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Questo endpoint funziona solo in modo sincrono; non aggiungere "mode": "async" al corpo.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.

Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.

Parametri della richiesta

#
NomePosizioneTipoObbligatorioPredefinitoDescrizione
AuthorizationheaderstringSì-Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice.
platformbodystringSìdouyinIdentificativo della piattaforma, valore fisso.
actionbodystringSìmedia_linksIdentificativo della funzionalità, valore fisso.
urlsbody.paramsarraySì-I video di cui ottenere i link di download, come array di massimo 20 voci; ogni voce può comparire una sola volta. Ogni voce è un ID numerico del video o un link https://www.douyin.com/video/<video_id>; short link e testi di condivisione non sono accettati. Addebitato per video; i video non trovati non vengono addebitati. Le righe riportano input, la voce che hai passato.
freshbody.paramsbooleanNo-Per media_links: true ignora i link in cache e li recupera di nuovo; default false. I link sono firmati e scadono, e expires_at indica quando.
limitbody.paramsinteger (1–)No-Numero massimo di righe da restituire in questa chiamata: un intero pari o superiore a 1. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe.

Esempi di codice

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "douyin",
  "action": "media_links",
  "params": {
    "urls": [
      "https://www.douyin.com/video/<VIDEO_ID_A>"
    ]
  }
}'

Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.

Esempio di risposta

#
Non è ancora disponibile una risposta di esempio per questi parametri. Questa anteprima mostra la struttura e i campi della risposta secondo la definizione dell'API, con … come segnaposto; non è il risultato di una chiamata reale.
json
{  "id": "req_…",  "platform": "douyin",  "action": "media_links",  "results": [    {      "id": …,      "url": …,      "media_type": …,      "video_url": …,      "video_url_expires_at": …,      "video_width": …,      "video_height": …,      "video_size_bytes": …,      "has_watermark": …,      "best_stream": …,      "stream_count": …,      "cover_image_url": …,      "covers": …,      "image_urls": …,      "audio_url": …,      "request_headers": …,      "expires_at": …,      "fetched_at": …,      "platform": …,      "input": …    }  ],  "count": …,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Campi della risposta

#

I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.

CampoSignificato
idID univoco del record sulla piattaforma. È univoco solo all'interno di una piattaforma; gli ID possono ripetersi tra piattaforme diverse.
urlLink al record sulla piattaforma.
media_typeTipo di media: video, oppure image per i post di immagini.
video_urlURL di riproduzione del video (firmato, con scadenza; scaricalo subito se devi conservarlo). Null per i post di immagini o quando l'origine non lo fornisce.
video_url_expires_atMantiene il significato attribuito dalla piattaforma
video_widthLarghezza del fotogramma del video in pixel.
video_heightAltezza del fotogramma del video in pixel.
video_size_bytesDimensione del file video in byte (media_links).
has_watermarkMantiene il significato attribuito dalla piattaforma
best_streamLo stream video con il bitrate più alto (media_links): {url, bitrate (bps), width, height, size_bytes, expires_at}.
stream_countQuanti stream video di qualità diversa ha il video (media_links).
cover_image_urlURL dell'immagine di copertina: la copertina di un video o di un post di immagini nelle righe search, user_posts, posts_batch, related_posts, mix_posts, music_posts e media_links; la copertina del brano in music_search e music_detail; l'immagine del topic in billboard_topic_hot; la copertina della raccolta in user_mixes; la copertina della room in live_room. I link firmati scadono.
coversImmagini di copertina (media_links): [{url, width, height, expires_at}]; la prima coincide con cover_image_url.
image_urlsArray di link alle immagini nell'ordine di visualizzazione della piattaforma; assente se non ci sono immagini.
audio_urlLink audio: la traccia audio del video in transcript (mp3), il link di riproduzione del brano in music_search e music_detail, la musica di sottofondo del video in media_links; può scadere.
request_headersHeader da inviare quando scarichi i link (media_links), ad esempio {"Referer": "https://www.douyin.com/"}. Senza di essi il download potrebbe essere rifiutato.
expires_atQuando smette di funzionare il link della riga con la scadenza più vicina (media_links, ISO 8601, UTC). Dopo quel momento, recupera di nuovo i link con fresh=true.
fetched_atQuando sono stati recuperati i link (media_links, ISO 8601, UTC); senza fresh possono provenire da una cache.
platformIdentificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).
inputLa voce di urls a cui risponde questa riga, restituita esattamente come l'hai passata (posts_batch, profiles_batch, media_links). Usala per abbinare le righe alle tue voci.

Errori e addebiti

#
401
Chiave mancante o non valida.
402
Saldo insufficiente. Effettua prima una ricarica.
422
Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
429
Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
503
Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
Risposta 200 vuota
Nessun dato. Nessun addebito.

Errori

Google Analytics: serve il consenso Privacy