Reddit · Детали публикации
Бета
Публичные данные соцсетей с оплатой за вызов — тот же ключ API и тот же баланс, что и для вызовов моделей.
Только для аккаунтов после первого пополнения, бесплатного пробного периода нет · Вызов оплачивается, только если он вернул HTTP 200 и непустое поле data; пустые результаты, отклонённые параметры и сбои источника не оплачиваются.
Параметры запроса
Параметры передаются в строке запроса под собственными именами платформы. Примеры взяты из каталога; замените идентификаторы на те, что относятся к нужному вам контенту.
| Название | Тип | Обязательный | Пример | Описание |
|---|---|---|---|---|
language | string | Нет | "en-US" | Preferred response language as an IETF language tag; default: en-US |
post_id | string | Да | "t3_1ojnh50" | Post ID |
include_comment_id | boolean | Нет | false | Include specific comment ID |
comment_id | string | Нет | "" | Comment ID (when include_comment_id is True) |
need_format | boolean | Нет | false | Whether to clean and format the data |
Пример запроса
curl --get "https://api.chinaapi.ai/v1/social/reddit/post" \
-H "Authorization: Bearer $CHINAAPI_KEY" \
--data-urlencode 'post_id=t3_1ojnh50'Структура ответа
Успешный ответ оборачивает данные платформы в небольшой конверт. Всё внутри data — имена полей, курсоры пагинации, идентификаторы — принадлежит самой платформе; передавайте курсоры обратно ровно в том виде, в каком их получили.
{
"object": "social.result",
"platform": "reddit",
"capability": "post",
"data": { … }
}Пагинация
У этого эндпоинта нет параметров пагинации.
Ошибки и что не оплачивается
| Код состояния | Код ошибки | Значение |
|---|---|---|
| 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 для составления профилей людей. Вход в аккаунты, извлечение контактных данных, накрутка вовлечённости и доступ к закрытому или платному контенту в эту бету не входят.