Weibo · Поиск публикаций
Бета
Публичные данные соцсетей с оплатой за вызов — тот же ключ API и тот же баланс, что и для вызовов моделей.
Только для аккаунтов после первого пополнения, бесплатного пробного периода нет · Вызов оплачивается, только если он вернул HTTP 200 и непустое поле data; пустые результаты, отклонённые параметры и сбои источника не оплачиваются.
Параметры запроса
Параметры передаются в строке запроса под собственными именами платформы. Примеры взяты из каталога; замените идентификаторы на те, что относятся к нужному вам контенту.
| Название | Тип | Обязательный | Пример | Описание |
|---|---|---|---|---|
query | string | Да | "NVIDIA" | Search keyword |
page | integer | Нет | 1 | Page number |
search_type | integer | Нет | 1 | Search type: 1=general, 61=real-time, 3=users, 64=videos, 63=images, 62=following, 60=popular, 21=web-wide, 38=topics, 98=super topics, 92=places, 97=products. |
Пример запроса
curl --get "https://api.chinaapi.ai/v1/social/weibo/search" \
-H "Authorization: Bearer $CHINAAPI_KEY" \
--data-urlencode 'query=NVIDIA'Структура ответа
Успешный ответ оборачивает данные платформы в небольшой конверт. Всё внутри data — имена полей, курсоры пагинации, идентификаторы — принадлежит самой платформе; передавайте курсоры обратно ровно в том виде, в каком их получили.
{
"object": "social.result",
"platform": "weibo",
"capability": "search",
"data": { … }
}Пагинация
Параметры пагинации: page. Каждая страница — отдельный оплачиваемый вызов; значения курсора передавайте в точности так, как они пришли в предыдущем ответе.
Ошибки и что не оплачивается
| Код состояния | Код ошибки | Значение |
|---|---|---|
| 400 | — | Параметр неизвестен, повторяется, слишком длинный, неверного типа или отсутствует, в том числе если не передан ни один член группы «хотя бы один из». Какой именно случай, показывает code ошибки, например unknown_parameter или missing_parameter. |
| 403 | model_requires_topup | Аккаунт ещё ни разу не пополнял баланс. |
| 404 | social_data_no_result | Такой пары платформы и возможности нет, или платформа ничего не нашла по этим параметрам (social_data_no_result). |
| 429 | social_data_capacity_reached | Дневной лимит беты исчерпан и сбросится в 00:00 UTC, либо платформа перегружена и достаточно повторить через несколько секунд. Не повторяйте запросы в плотном цикле. |
| 502 | social_data_no_result | Источник данных не ответил или ответил без данных. |
| 503 | social_data_unavailable | Этот эндпоинт сейчас приостановлен; в живом каталоге он помечен как paused. |
Ни один из этих ответов не оплачивается.
Каждый ответ содержит заголовок X-Oneapi-Request-Id; укажите его, обращаясь в поддержку, и мы найдём именно этот вызов.
Условия беты
Перед вызовом впервые пополните баланс. Пробный кредит на эти эндпоинты не тратится; аккаунт, который ни разу не пополнялся, получает HTTP 403 model_requires_topup. У беты нет SLA, а её платформы, эндпоинты и цены могут меняться.
Соблюдайте условия каждой платформы и применимые к вам правила защиты данных. Не используйте этот API для составления профилей людей. Вход в аккаунты, извлечение контактных данных, накрутка вовлечённости и доступ к закрытому или платному контенту в эту бету не входят.