API Bilibili General search

POST

Состояние API

Состояние за 24 ч
Норма
  • Стабильно / норма
  • Доступно
Норма

Последние 24 часа

Последние 30 дней

Search Bilibili the way its All tab does: videos, accounts, anime series, films and live rooms mixed in one list, each row tagged with type. The first page holds about 20 videos plus related accounts, anime series and films; later pages are videos only. Pass next_page_token back as page_token for more.

Отправьте POST https://api.everyinfra.com/api/v1/social, указав в platform значение bilibili, а в action — general_search. Цена: $0.79 за 1 000 запросов ($0.000792 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

#
Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Bilibili General search (bilibili/general_search).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: bilibili и action: general_search, а параметры передайте в params.
- Обязательные параметры:
  - keyword: Search term. Results are mixed like Bilibili's All tab; each row's type is video, user, bangumi, movie or live. Use search for videos only and user_search for accounts only.
- Необязательные параметры:
  - page_token: Page token. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, with the other parameters unchanged.
- Возвращает список записей. Основные поля каждой записи: type, id, url, title, text, duration_seconds, duration_sec, duration_text (Длительность в отображаемом виде (напри…), view_count, like_count, comment_count, danmaku_count (Число данмаку (комментариев поверх виде…); всего полей: 39, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=bilibili.
- Пример тела запроса:
{
  "platform": "bilibili",
  "action": "general_search",
  "params": {
    "keyword": "编程"
  }
}
- Цена: $0.79 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.

Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.

Параметры запроса

#
ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаbilibiliИдентификатор платформы, фиксированное значение.
actionbodystringДаgeneral_searchИдентификатор возможности, фиксированное значение.
keywordbody.paramsstringДа-Search term. Results are mixed like Bilibili's All tab; each row's type is video, user, bangumi, movie or live. Use search for videos only and user_search for accounts only.
page_tokenbody.paramsstringНет-Page token. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, with the other parameters unchanged. The first page holds about 20 videos plus related accounts, anime series and films; later pages hold videos only, up to 20. Each page is one call and limit has no effect. Tokens last 24 hours, and the last page has no next_page_token.

Примеры кода

#
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": "bilibili",
  "action": "general_search",
  "params": {
    "keyword": "编程"
  }
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

Пример ответа

#
Получено November 21, 2026 at 07:17 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты); в списке оставлены первые 2. id, billing и quota меняются при каждом вызове, поэтому показана только их структура.
json
{  "id": "req_…",  "platform": "bilibili",  "action": "general_search",  "results": [    {      "type": "video",      "id": "BV1rpWjevEip",      "url": "https://www.bilibili.com/video/BV1rpWjevEip",      "title": "【全748集】目前B站最全最细的Python零基础全套教程,2026最新版,包含所有干货!七天就能从小白到大神!少走99%的弯路!存下吧!很难找全的!",      "text": "【视频配套籽料、开发环境搭建安装包教程、电子书+问题解答请看 ”置顶平论” 自取哦】\r\n本套教程从零开始讲解,手把手教学,包含基础语法、进阶语法、爬虫、自动化办公、数据分析\r\n无论是新手小白,还是有一定编码经验的选手,皆可学习\r\n如果视频对你有用的话请 一键三连【长按点赞】支持一下UP哦,拜托,这对我真的很重要!",      "duration_seconds": 143894,      "duration_text": "39:58:14",      "view_count": 21931770,      "like_count": 605744,      "comment_count": 373418,      "danmaku_count": 137244,      "favorite_count": 927710,      "thumbnail_url": "https://i2.hdslb.com/bfs/archive/a979056b1a32012cdd00d48fbc3732d253e30620.jpg",      "posted_at": "2024-08-22T14:59:18+00:00",      "category": "计算机技术",      "author_name": "P•••程",      "author_id": "•••",      "author_url": "https://space.bilibili.com/•••",      "platform": "bilibili",      "tags": [        "程序员",        "Python教程",        "Python入门零基础"      ],      "duration_sec": 143894    },    {      "type": "video",      "id": "BV12J411X7tY",      "url": "https://www.bilibili.com/video/BV12J411X7tY",      "title": "少儿编程scratch3.0基础入门(大龙老师)",      "text": "这个教程是简单的基础入门课,想要系统的,完整的学习scratch请选择《新版scratch从入门到精通系统课》,点击评论区置顶链接进入课程,了解详情。",      "duration_seconds": 11349,      "duration_text": "3:09:09",      "view_count": 1373367,      "like_count": 15518,      "comment_count": 2142,      "danmaku_count": 9959,      "favorite_count": 46757,      "thumbnail_url": "https://i2.hdslb.com/bfs/archive/45a0b5a218de8fff3b7f4cf02e130179b1be470c.jpg",      "posted_at": "2019-11-27T10:20:37+00:00",      "category": "校园学习",      "author_name": "大•••程",      "author_id": "•••",      "author_url": "https://space.bilibili.com/•••",      "platform": "bilibili",      "tags": [        "scratch",        "少儿编程",        "原创"      ],      "duration_sec": 11349    }  ],  "next_page_token": …,  "pagination": { … },  "count": 17,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Поля ответа

#

Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.

ПолеЗначение
typeТип записи; значения зависят от возможности (например, video / image / text).
idУникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться.
urlСсылка на запись на платформе.
titleЗаголовок. null, если на платформе нет заголовков (например, у текстовых постов).
textОсновной текст без HTML возвращается полностью и никогда не обрезается (на нескольких платформах результаты списковых запросов содержат только фрагмент; это указано в примечаниях к полям платформы).
duration_secondsДлительность в секундах. null для контента, который не является видео или аудио.
duration_secТрактуется так же, как на самой платформе
duration_textДлительность в отображаемом виде (например, 12:34).
view_countПросмотры или воспроизведения. null означает, что значение не раскрыто, а не 0.
like_countЛайки. null означает, что платформа или эта возможность не раскрывает значение; это не 0.
comment_countКомментарии. null означает, что значение не раскрыто, а не 0.
danmaku_countЧисло данмаку (комментариев поверх видео). Показатель вовлечённости, характерный для Bilibili; оценивайте его вместе с comment_count.
favorite_countДобавления в избранное.
coin_countПолученные монеты. Монеты на Bilibili — платная форма одобрения, и они ценятся выше лайков.
share_countКоличество раз, когда записью поделились. null означает, что значение не раскрыто, а не 0.
thumbnail_urlСсылка на миниатюру с более низким разрешением, чем у image_url.
posted_atВремя публикации в ISO 8601, UTC (например, 2026-08-07T12:34:56+00:00). Нестандартные строки платформы передаются как есть, поэтому учитывайте это при разборе. null означает, что платформа его не раскрывает.
categoryНазвание категории во внутренней классификации платформы. Категории разных платформ не унифицированы.
author_nameОтображаемое имя автора.
author_idУникальный ID автора на платформе.
author_urlСсылка на профиль автора на платформе.
platformИдентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).
tagsМассив тегов. Если тегов нет, это пустой массив, а не null.
user_idУникальный ID пользователя на платформе.
nameНазвание самого объекта для возможностей по аккаунтам, товарам и компаниям.
bioОписание профиля, написанное владельцем аккаунта; может содержать переносы строк и эмодзи.
avatar_urlСсылка на аватар. Некоторые платформы возвращают CDN-ссылки с заданным размером, срок действия которых может истечь.
levelТрактуется так же, как на самой платформе
follower_countПодписчики. null означает, что значение не раскрыто, а не 0.
video_countТрактуется так же, как на самой платформе
is_verifiedПодтверждён ли аккаунт платформой. null означает, что это невозможно определить.
verified_typeТрактуется так же, как на самой платформе
verified_titleТрактуется так же, как на самой платформе
is_liveТрактуется так же, как на самой платформе
live_room_idТрактуется так же, как на самой платформе
is_senior_memberТрактуется так же, как на самой платформе
recent_video_idsТрактуется так же, как на самой платформе
episode_countТрактуется так же, как на самой платформе
ratingРейтинг. Шкала зависит от платформы: rating_scale в той же записи задаёт максимум (обычно 5; у Booking, Douban, iQIYI и NAVER — 10). Перед сравнением между платформами пересчитайте значения с учётом rating_scale, иначе результат сравнения может оказаться обратным.
rating_scaleМаксимальное значение rating в той же записи: 5 для пятизвёздочных шкал, 10 для десятибалльных. Поле присутствует, только если у записи есть рейтинг.

Ошибки и оплата

#
401
Ключ отсутствует или недействителен.
402
Недостаточно средств на балансе. Сначала пополните баланс.
422
Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429
Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503
Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто)
Нет данных. Без списания.

Ошибки

Google Analytics: нужно согласие Приватность