API Bilibili Dettagli del video
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- Normale
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Ultime 24 ore
Ultimi 30 giorni
Recupera un video Bilibili dal suo link BV per ottenere descrizione, durata, data di pubblicazione, uploader, categoria, tag e numero di visualizzazioni, like, monete, preferiti e condivisioni. Commenti e danmaku si ottengono con le azioni separate comments e danmaku.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su bilibili e action impostato su video. Prezzo $0.56 per 1.000 richieste ($0.000556 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Bilibili Dettagli del video di EveryInfra (bilibili/video).
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 bilibili e action su video, e inserisci i parametri in params.
- Parametri obbligatori:
- url: Specifica l'URL completo di un video Bilibili, nel formato https://www.bilibili.com/video/<BVID>.
- Restituisce un oggetto. Campi principali: id, url, title, text, duration_seconds, duration_sec, duration_text (Durata come testo visualizzato (ad esem…), view_count, like_count, comment_count, danmaku_count (Numero di danmaku (commenti a schermo)), favorite_count (Preferiti); 25 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=bilibili.
- Esempio di corpo della richiesta:
{
"platform": "bilibili",
"action": "video",
"params": {
"url": "https://www.bilibili.com/video/BV1DYjA6KEJ7"
}
}
- Prezzo: $0.56 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- 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
#| Nome | Posizione | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|---|
Authorization | header | string | Sì | - | Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice. |
platform | body | string | Sì | bilibili | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | video | Identificativo della funzionalità, valore fisso. |
url | body.params | string | Sì | - | Specifica l'URL completo di un video Bilibili, nel formato https://www.bilibili.com/video/<BVID>. Il parametro url recupera i commenti del video con comments, i commenti temporizzati della prima parte con danmaku e la trascrizione audio con subtitles, trattandoli come fonti di testo distinte. L'azione danmaku deve poter estrarre un BV ID valido dal percorso fornito. |
Esempi di codice
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "bilibili",
"action": "video",
"params": {
"url": "https://www.bilibili.com/video/BV1DYjA6KEJ7"
}
}'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
#{ "id": "req_…", "platform": "bilibili", "action": "video", "results": { "id": "BV1DYjA6KEJ7", "url": "https://www.bilibili.com/video/BV1DYjA6KEJ7", "title": "《原神》「『空月之歌·谐谑』映夏!归乡?千灵节!」前瞻特别节目", "text": "《原神》「『空月之歌·谐谑』映夏!归乡?千灵节!」将于2026年7月1日上线。\n感谢各位旅行者的支持与陪伴,我们将为大家带来更多「『空月之歌·谐谑』映夏!归乡?千灵节!」版本的最新消息~\n \n本次兑换码将于2026年6月22日12:00:00失效,记得尽快兑换哦~\n\n《原神》bilibili服下载地址: https://www.biligame.com/detail/?id=103496", "duration_seconds": 2583, "duration_text": "43:03", "view_count": 1722394, "like_count": 121499, "comment_count": 8653, "danmaku_count": 25368, "favorite_count": 24496, "coin_count": 38171, "share_count": 6639, "thumbnail_url": "http://i0.hdslb.com/bfs/archive/9839aee8582b365528c3e9f364748e4acb4c2401.jpg", "posted_at": "2026-06-18T13:00:00+00:00", "category": "", "author_name": "•••", "author_id": "•••", "author_url": "https://space.bilibili.com/•••", "platform": "bilibili", "tags": [ "月之八", "映夏归乡千灵节", "米哈游" ] }, "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.
| Campo | Significato |
|---|---|
id | ID univoco del record sulla piattaforma. È univoco solo all'interno di una piattaforma; gli ID possono ripetersi tra piattaforme diverse. |
url | Link al record sulla piattaforma. |
title | Titolo. null quando la piattaforma non prevede titoli (ad esempio post di solo testo). |
text | Testo del contenuto senza HTML, restituito per intero e mai troncato (su alcune piattaforme i risultati degli elenchi contengono solo un estratto; lo indicano le note sui campi della piattaforma). |
duration_seconds | Durata in secondi. null per i contenuti che non sono video o audio. |
duration_sec | Mantiene il significato attribuito dalla piattaforma |
duration_text | Durata come testo visualizzato (ad esempio 12:34). |
view_count | Visualizzazioni o riproduzioni. null significa non rese note, non 0. |
like_count | Like. null significa che la piattaforma o questa funzionalità non li rende noti; non equivale a 0. |
comment_count | Commenti. null significa non resi noti, non 0. |
danmaku_count | Numero di danmaku (commenti a schermo). Un segnale di engagement specifico di Bilibili; leggilo insieme a comment_count. |
favorite_count | Preferiti. |
coin_count | Monete donate. Le monete sono una forma di apprezzamento a pagamento su Bilibili e pesano più dei Mi piace. |
share_count | Condivisioni. null significa non rese note, non 0. |
thumbnail_url | Link alla miniatura, a risoluzione inferiore rispetto a image_url. |
posted_at | Data e ora di pubblicazione in formato ISO 8601, UTC (ad esempio 2026-08-07T12:34:56+00:00). Le stringhe non standard della piattaforma vengono passate così come sono, quindi esegui il parsing in modo difensivo. null significa che la piattaforma non le rende note. |
category | Nome della categoria secondo la tassonomia della piattaforma, non normalizzato tra piattaforme. |
author_name | Nome visualizzato dell'autore. |
author_id | ID univoco dell'autore sulla piattaforma. |
author_url | Link al profilo dell'autore sulla piattaforma. |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
tags | Array di tag. Se non ce ne sono, è un array vuoto, non null. |
video_streams | Mantiene il significato attribuito dalla piattaforma |
audio_streams | Mantiene il significato attribuito dalla piattaforma |
streams_expire_at | Mantiene il significato attribuito dalla piattaforma |
streams_referer | Mantiene il significato attribuito dalla piattaforma |
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.
Riferimenti ufficiali
#Usati solo per verificare oggetti e terminologia. Non implicano alcuna autorizzazione o approvazione di EveryInfra da parte della piattaforma.
- Bilibili: l'annuncio ufficiale sul passaggio dai numeri AV agli identificatori BV ↗
L'annuncio di Bilibili del 2020 definisce gli identificatori BV come ID dei video caricati, composti da numeri e lettere con distinzione tra maiuscole e minuscole, e li distingue dai numeri AV solo numerici. Questo riferimento spiega solo i tipi di identificatori video; questa API accetta link nel formato indicato sopra e non garantisce il parsing di tutti i link legacy o dei video divisi in più parti.
Verificato il 2026-09-04