API Bilibili Ricerca
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- 100%
- Tempo medio nelle ultime 24 ore
- 6.27 s
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Ultime 24 ore
Ultimi 30 giorni
Cerca su Bilibili video su un argomento, con durata, visualizzazioni, like, monete, preferiti, danmaku e numero di commenti, uploader e data di pubblicazione. Nota che most_liked ordina per preferiti e non per like, e i conteggi sono un'istantanea, non uno storico.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su bilibili e action impostato su search. 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.
La funzionalità Bilibili Search trova video in base a keyword e restituisce per ogni video titolo, descrizione, durata, numero di visualizzazioni, like, commenti, danmaku, preferiti, coin e condivisioni, oltre a categoria, tag, uploader e data di pubblicazione. Usala per vedere quali video esistono su un argomento e quali hanno più successo, per ricerche sugli argomenti, monitoraggio delle menzioni di un brand o ricerca di uploader con cui collaborare.
Ordina i risultati con sort (pertinenza, più recenti, più visualizzati o più commentati); tieni presente che most_liked in realtà ordina per preferiti, non per like. Per valutare la popolarità, dai peso a coin_count: i coin sono una forma di apprezzamento a pagamento su Bilibili e contano più dei like, mentre danmaku_count affianca i commenti come misura di quanto gli spettatori partecipano attivamente.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Bilibili Ricerca di EveryInfra (bilibili/search).
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 search, e inserisci i parametri in params.
- Parametri obbligatori:
- keyword: Specifica i termini di ricerca dei video su Bilibili in base a titoli o argomenti, non una ricerca esatta per nickname dell'uploader. Usa user_id per interrogare i profili degli uploader o i loro contenuti caricati.
- Parametri facoltativi:
- sort: Specifica l'ordinamento dei video: relevance, newest per i più recenti, most_viewed per numero di visualizzazioni, most_commented per rilevanza dei commenti e most_liked per i preferiti anziché i like. (valori consentiti: most_commented / most_liked / most_viewed / newest / relevance)
- limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 50. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 20)
- Restituisce un elenco di record. Campi principali di ogni record: 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); 21 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=bilibili.
- Esempio di corpo della richiesta:
{
"platform": "bilibili",
"action": "search",
"params": {
"keyword": "摄影入门"
}
}
- 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ì | search | Identificativo della funzionalità, valore fisso. |
keyword | body.params | string | Sì | - | Specifica i termini di ricerca dei video su Bilibili in base a titoli o argomenti, non una ricerca esatta per nickname dell'uploader. Usa user_id per interrogare i profili degli uploader o i loro contenuti caricati. |
sort | body.params | string (enum) | No | - | Specifica l'ordinamento dei video: relevance, newest per i più recenti, most_viewed per numero di visualizzazioni, most_commented per rilevanza dei commenti e most_liked per i preferiti anziché i like. Si applica solo alla ricerca dei video e non determina l'ordine dei commenti.Valori consentitimost_commentedmost_likedmost_viewednewestrelevance |
limit | body.params | integer (1–50) | No | 20 | Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 50. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. I valori più alti restituiscono 422 prima di qualsiasi addebito. |
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": "search",
"params": {
"keyword": "摄影入门"
}
}'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": "search", "results": [ { "id": "BV1pv411H78e", "url": "https://www.bilibili.com/video/BV1pv411H78e", "title": "从零开始手把手教你学摄影，20节课带你从小白到大师 | 摄影前期拍摄入门教程", "text": "此课程是一套面向零基础小白的零基础摄影前期拍摄系统教程，分为4大部分，一共20节，由浅入深。课程从器材讲解到参数技巧，最后带领大家实战拍摄，可以快速带大家入门摄影，录制于2020年，因故未能发布，现在作为福利分享给大家~\r\n\r\nPS： 如果大家觉得有帮助的话，求个一键三连~\r\n\r\nPART1 知己知彼——认识你的器材\r\nPART2 基础入门——学懂枯燥的参数\r\nPART3 技能提升——拍摄技巧全解\r\nPART4 综合运用——带你复盘拍摄现场", "duration_seconds": 28849, "duration_text": "480:49", "view_count": 8307391, "like_count": 301661, "comment_count": 3799, "danmaku_count": 38430, "favorite_count": 752984, "thumbnail_url": "https://i1.hdslb.com/bfs/archive/d293a1682ffac131d109bd6180c4df644f632388.png", "posted_at": "2021-07-02T03:56:53+00:00", "category": "数码", "author_name": "•••", "author_id": "•••", "author_url": "https://space.bilibili.com/•••", "platform": "bilibili", "tags": [ "教程", "摄影", "相机" ] }, { "id": "BV1MceuzVEz7", "url": "https://www.bilibili.com/video/BV1MceuzVEz7", "title": "【吊打付费】目前B站最完整的摄影教程，包含了所有干货内容！这还没人看，我不更了！！！", "text": "一个冷知识：点赞是免费的！但是可以让辛苦做视频的UP主开心快乐一整天！！！\n 我给大家准备了摄影礼包，评论“666”即可得", "duration_seconds": 71221, "duration_text": "1187:1", "view_count": 2186277, "like_count": 50942, "comment_count": 12382, "danmaku_count": 6525, "favorite_count": 124107, "thumbnail_url": "https://i2.hdslb.com/bfs/archive/5fffaef73d60995cf40a9336b58fe68b15ca5033.jpg", "posted_at": "2025-08-20T09:20:00+00:00", "category": "数码", "author_name": "•••", "author_id": "•••", "author_url": "https://space.bilibili.com/•••", "platform": "bilibili", "tags": [ "摄影入门", "新手摄影", "零基础学摄影" ] } ], "count": 17, "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. |
FAQ
#Perché most_liked non ordina per like?
#Nella mappatura attuale most_liked ordina i video per preferiti, non per like. Per ottenere i video con più like, recupera i risultati e ordinali tu stesso per like_count.
Come valuto la reale popolarità di un video?
#Non fermarti a view_count: considera anche coin_count, favorite_count e danmaku_count. I coin sono una forma di apprezzamento a pagamento, mentre i preferiti e i numerosi commenti a schermo mostrano quanto siano coinvolti gli spettatori; letti insieme, dicono più delle sole visualizzazioni.
Posso cercare per uploader?
#keyword corrisponde a titoli e argomenti dei video, non esattamente ai nickname degli uploader. author_id in un risultato è l'ID numerico dell'uploader; passalo alla funzionalità Bilibili Details per il profilo o a Posts by user per i suoi caricamenti.
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.