Douyin · Поиск публикаций
Бета
Публичные данные соцсетей с оплатой за вызов — тот же ключ API и тот же баланс, что и для вызовов моделей.
Только для аккаунтов после первого пополнения, бесплатного пробного периода нет · Вызов оплачивается, только если он вернул HTTP 200 и непустое поле data; пустые результаты, отклонённые параметры и сбои источника не оплачиваются.
Параметры запроса
Параметры передаются в строке запроса под собственными именами платформы. Примеры взяты из каталога; замените идентификаторы на те, что относятся к нужному вам контенту.
| Название | Тип | Обязательный | Пример | Описание |
|---|---|---|---|---|
keyword | string | Да | "猫咪" | Keyword |
cursor | integer | Нет | 0 | Offset cursor for pagination, obtained from the last response |
sort_type | string | Нет | "0" | Sort type: 0=Comprehensive, 1=Most Likes, 2=Latest |
publish_time | string | Нет | "0" | Publish time filter: 0=Unlimited, 1=Last day, 7=Last week, 180=Last half year |
filter_duration | string | Нет | "0" | Video duration filter: 0=Unlimited, 0-1=Within 1 minute, 1-5=1 to 5 minutes, 5-10000=More than 5 minutes |
content_type | string | Нет | "0" | Content type: 0=All, 1=Video, 2=Picture, 3=Article |
search_id | string | Нет | "" | Search ID for pagination, obtained from the last response |
backtrace | string | Нет | "" | Backtrace for pagination, obtained from the last response |
Пример запроса
curl --get "https://api.chinaapi.ai/v1/social/douyin/search" \
-H "Authorization: Bearer $CHINAAPI_KEY" \
--data-urlencode 'keyword=猫咪'Структура ответа
Успешный ответ оборачивает данные платформы в небольшой конверт. Всё внутри data — имена полей, курсоры пагинации, идентификаторы — принадлежит самой платформе; передавайте курсоры обратно ровно в том виде, в каком их получили.
{
"object": "social.result",
"platform": "douyin",
"capability": "search",
"data": { … }
}Пагинация
Параметры пагинации: cursor, search_id, backtrace. Каждая страница — отдельный оплачиваемый вызов; значения курсора передавайте в точности так, как они пришли в предыдущем ответе.
Ошибки и что не оплачивается
| Код состояния | Код ошибки | Значение |
|---|---|---|
| 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 для составления профилей людей. Вход в аккаунты, извлечение контактных данных, накрутка вовлечённости и доступ к закрытому или платному контенту в эту бету не входят.