Cross-platform · Поиск публикаций
Бета
Публичные данные соцсетей с оплатой за вызов — тот же ключ API и тот же баланс, что и для вызовов моделей.
Только для аккаунтов после первого пополнения, бесплатного пробного периода нет · Вызов оплачивается, только если он вернул HTTP 200 и непустое поле data; пустые результаты, отклонённые параметры и сбои источника не оплачиваются.
Параметры запроса
Параметры передаются в строке запроса под собственными именами платформы. Примеры взяты из каталога; замените идентификаторы на те, что относятся к нужному вам контенту.
| Название | Тип | Обязательный | Пример | Описание |
|---|---|---|---|---|
query | string | Да | "人工智能" | Search terms; separate terms with spaces to require all of them. Put excluded words in exclude_words. |
platforms | array | Нет | ["weibo","douyin","toutiao","xiaohongshu","short_video","wechat","news","forum","long_video","app"] | Only these platforms, all by default: weibo, douyin, toutiao, xiaohongshu, short_video (Kuaishou and other short-video apps), wechat (official accounts), news (news sites and newspapers), forum (forum Pass a JSON array in this query parameter. |
since | string | Нет | — | First day, YYYY-MM-DD (Beijing time, included); defaults to 6 days before until |
until | string | Нет | — | Last day, YYYY-MM-DD (Beijing time, included); defaults to today and cannot be later. since to until spans at most 90 days |
types | array | Нет | ["original","repost","comment"] | Content types, all by default: original, repost, comment Pass a JSON array in this query parameter. |
sentiment | array | Нет | ["negative","neutral","positive"] | Sentiment, all by default: negative, neutral, positive Pass a JSON array in this query parameter. |
match | array | Нет | ["title","content","author"] | Where the search terms must match, title, content and author by default: title, content, author (author name), media_text (images and video frames), audio Pass a JSON array in this query parameter. |
exclude_words | string | Нет | — | Filter words; results that contain them are left out |
author | string | Нет | — | Only content published by this author (account name) |
page | integer | Нет | 1 | Page number, from 1, at most 50 |
limit | integer | Нет | 20 | Results per page: 10 or 20 |
Пример запроса
curl --get "https://api.chinaapi.ai/v1/social/cross-platform/search" \
-H "Authorization: Bearer $CHINAAPI_KEY" \
--data-urlencode 'query=人工智能'Структура ответа
Успешный ответ оборачивает данные платформы в небольшой конверт. Всё внутри data — имена полей, курсоры пагинации, идентификаторы — принадлежит самой платформе; передавайте курсоры обратно ровно в том виде, в каком их получили.
{
"object": "social.result",
"platform": "cross-platform",
"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 для составления профилей людей. Вход в аккаунты, извлечение контактных данных, накрутка вовлечённости и доступ к закрытому или платному контенту в эту бету не входят.
Лимиты скорости API данных
Лимиты скорости API данных
Платные аккаунты начинают с 10 запросов/с. Лимит автоматически растёт с суммарными чистыми расходами до 100 запросов/с.
| Суммарные чистые расходы | Запросов в секунду |
|---|---|
| Начальный платный лимит | 10/s |
| Более 50 USD | 20/s |
| Более 500 USD | 50/s |
| Более 1500 USD | 100/s |
Основа расчёта: оплаченные вызовы API данных за вычетом возвратов за вызовы. Пополнения и расходы на API моделей не учитываются.
Все API-ключи аккаунта используют общий лимит. Это число запросов в секунду, а не одновременных запросов.
У интерфейсов поставщиков есть отдельные ограничения мощности, которые также влияют на доступную пропускную способность.
Нужна более высокая скорость? Напишите нам на [email protected].