TikTok · Поиск рекламы
Бета
Публичные данные соцсетей с оплатой за вызов — тот же ключ API и тот же баланс, что и для вызовов моделей.
Неоплаченные аккаунты: до 50 вызовов в день. Платные аккаунты: без дневного лимита вызовов. Сброс в 00:00 UTC. · Вызов оплачивается, только если он вернул HTTP 200 и непустое поле data; пустые результаты, отклонённые параметры и сбои источника не оплачиваются.
Параметры запроса
Параметры передаются в строке запроса под собственными именами платформы. Примеры взяты из каталога; замените идентификаторы на те, что относятся к нужному вам контенту.
| Название | Тип | Обязательный | Пример | Описание |
|---|---|---|---|---|
objective | integer | Нет | — | Ad objective (optional): 1 traffic, 2 app installs, 3 conversions, 4 video views, 5 reach, 6 leads, 7 product sales |
like | integer | Нет | — | Performance percentile (optional): 1 top 1-20%, 2 top 21-40%, 3 top 41-60%, 4 top 61-80%, 5 top 81-100% |
period | integer | Нет | 180 | Time period (days) По умолчанию 180 |
industry | string | Нет | — | Industry ID |
keyword | string | Нет | "美食" | Search keyword |
page | integer | Нет | 1 | Page number По умолчанию 1 |
limit | integer | Нет | 20 | Items per page По умолчанию 20 |
order_by | string | Нет | "for_you" | Sort by (for_you, likes) По умолчанию "for_you" |
country_code | string | Нет | "US" | Country code По умолчанию "US" |
ad_format | integer | Нет | — | Ad format (optional; 1:Spark Ads 2:Non-Spark Ads) |
ad_language | string | Нет | — | Ad language (optional) |
duration | integer | Нет | — | Video duration filter value (optional) |
pattern_label | string | Нет | — | Creative pattern label (optional) |
search_id | string | Нет | — | Search ID (optional) |
Пример запроса
curl --get "https://api.chinaapi.ai/v1/social/tiktok/ad-search" \
-H "Authorization: Bearer $CHINAAPI_KEY"Структура ответа
Успешный ответ оборачивает данные платформы в небольшой конверт. Всё внутри data — имена полей, курсоры пагинации, идентификаторы — принадлежит самой платформе; передавайте курсоры обратно ровно в том виде, в каком их получили.
{
"object": "social.result",
"platform": "tiktok",
"capability": "ad-search",
"data": { … }
}Пагинация
Параметры пагинации: page, search_id. Каждая страница — отдельный оплачиваемый вызов; значения курсора передавайте в точности так, как они пришли в предыдущем ответе.
Ошибки и что не оплачивается
| Код состояния | Код ошибки | Значение |
|---|---|---|
| 400 | — | Параметр неизвестен, повторяется, слишком длинный, неверного типа или отсутствует, в том числе если не передан ни один член группы «хотя бы один из». Какой именно случай, показывает code ошибки, например unknown_parameter или missing_parameter. |
| 403 | — | У API-ключа нет разрешения на этот запрос. |
| 404 | social_data_no_result | Такой пары платформы и возможности нет, или платформа ничего не нашла по этим параметрам (social_data_no_result). |
| 429 | data_api_daily_limit_exceededsocial_data_capacity_reached | Дневной лимит беты исчерпан и сбросится в 00:00 UTC, либо платформа перегружена и достаточно повторить через несколько секунд. Не повторяйте запросы в плотном цикле. Неоплаченные аккаунты: до 50 вызовов в день. Платные аккаунты: без дневного лимита вызовов. Сброс в 00:00 UTC. |
| 502 | social_data_no_result | Источник данных не ответил или ответил без данных. |
| 503 | social_data_unavailable | Этот эндпоинт сейчас приостановлен; в живом каталоге он помечен как paused. |
Ни один из этих ответов не оплачивается.
Каждый ответ содержит заголовок X-Oneapi-Request-Id; укажите его, обращаясь в поддержку, и мы найдём именно этот вызов.
Условия беты
Неоплаченные аккаунты: до 50 вызовов в день. Платные аккаунты: без дневного лимита вызовов. Сброс в 00:00 UTC. У беты нет SLA, а её платформы, эндпоинты и цены могут меняться.
Соблюдайте условия каждой платформы и применимые к вам правила защиты данных. Не используйте этот API для составления профилей людей. Вход в аккаунты, извлечение контактных данных, накрутка вовлечённости и доступ к закрытому или платному контенту в эту бету не входят.
Лимиты скорости API данных
Лимиты скорости API данных
Платные аккаунты начинают с 10 запросов/с. Лимит автоматически растёт с суммарными чистыми расходами до 100 запросов/с.
Неоплаченные аккаунты: до 50 вызовов в день. Платные аккаунты: без дневного лимита вызовов. Сброс в 00:00 UTC.
| Суммарные чистые расходы | Запросов в секунду |
|---|---|
| Начальный платный лимит | 10/s |
| Более 50 USD | 20/s |
| Более 500 USD | 50/s |
| Более 1500 USD | 100/s |
Основа расчёта: оплаченные вызовы API данных за вычетом возвратов за вызовы. Пополнения и расходы на API моделей не учитываются.
Все API-ключи аккаунта используют общий лимит. Это число запросов в секунду, а не одновременных запросов.
У интерфейсов поставщиков есть отдельные ограничения мощности, которые также влияют на доступную пропускную способность.
Нужна более высокая скорость? Напишите нам на [email protected].