Данные соцсетей (бета)

/

GET /v1/social/{platform}/{capability} возвращает публичные данные Douyin, Xiaohongshu, TikTok, YouTube и других социальных платформ — с тем же API-ключом и балансом, что и вызовы моделей. Цена задаётся для каждой пары платформы и возможности за один успешный вызов, а data — это собственный ответ платформы: поля между платформами не унифицированы.

GET /v1/social/{platform}/{capability} 
curl --get "https://api.chinaapi.ai/v1/social/tiktok/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=TikTok'

# HTTP 200
# {"object": "social.result", "platform": "tiktok", "capability": "search", "data": {...}}
Бета: только для платных аккаунтов Перед вызовом впервые пополните баланс. Пробный кредит на эти эндпоинты не тратится; аккаунт, который ни разу не пополнялся, получает HTTP 403 model_requires_topup. У беты нет SLA, а её платформы, эндпоинты и цены могут меняться.

Аутентификация и оплата

Передавайте ключ ChinaAPI как bearer-токен на https://api.chinaapi.ai, как при любом вызове модели. Вызов оплачивается один раз, по цене, указанной для его эндпоинта, и только если он вернул HTTP 200 с данными; пустой результат, отклонённый параметр или сбой на стороне источника ничего не стоят. Каждая полученная страница — отдельный вызов. В журнале использования каждый вызов записан под именем, указанным у его эндпоинта, например social-douyin-search.

Ответы и ошибки

Успешный ответ оборачивает данные платформы в небольшой конверт. Всё внутри data — имена полей, курсоры пагинации, идентификаторы — принадлежит самой платформе; передавайте курсоры обратно ровно в том виде, в каком их получили.

{
  "object": "social.result",
  "platform": "douyin",
  "capability": "search",
  "data": { "...": "the platform's own fields" }
}
  • 400 — параметр неизвестен, повторяется, слишком длинный, неверного типа или отсутствует, в том числе если не передан ни один член группы «хотя бы один из». Какой именно случай, показывает code ошибки, например unknown_parameter или missing_parameter.
  • 403 model_requires_topup — аккаунт ещё ни разу не пополнял баланс.
  • 404 — такой пары платформы и возможности нет, или платформа ничего не нашла по этим параметрам (social_data_no_result).
  • 429 social_data_capacity_reached — дневной лимит беты исчерпан и сбросится в 00:00 UTC, либо платформа перегружена и достаточно повторить через несколько секунд. Не повторяйте запросы в плотном цикле.
  • 502 — источник данных не ответил или ответил без данных.
  • 503 social_data_unavailable — этот эндпоинт сейчас приостановлен; в живом каталоге он помечен как paused.

Ни один из этих ответов не оплачивается.

Допустимое использование

Соблюдайте условия каждой платформы и применимые к вам правила защиты данных. Не используйте этот API для составления профилей людей. Вход в аккаунты, извлечение контактных данных, накрутка вовлечённости и доступ к закрытому или платному контенту в эту бету не входят.

Платформы и цены

USD за один успешный вызов. Каждая цена ведёт к своему эндпоинту ниже, а прочерк означает, что платформа не предлагает эту возможность. Что продаётся прямо сейчас, включая приостановленные эндпоинты, определяет живой каталог — GET https://dash.chinaapi.ai/api/social/catalog, ключ не нужен.

Эндпоинты

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