TikTok · Рейтинг популярных видео

Бета

Публичные данные соцсетей с оплатой за вызов — тот же ключ API и тот же баланс, что и для вызовов моделей.

Неоплаченные аккаунты: до 50 вызовов в день. Платные аккаунты: без дневного лимита вызовов. Сброс в 00:00 UTC. · Вызов оплачивается, только если он вернул HTTP 200 и непустое поле data; пустые результаты, отклонённые параметры и сбои источника не оплачиваются.

Параметры запроса

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

Название	Тип	Обязательный	Пример	Описание
`period_end_timestamp`	integer	Да	`1794182400`	Ranking period end
`period_dimension`	integer	Нет	`3`	Ranking period: 1 weekly, 3 daily (default), 5 long-period; selects the ranking type for period_end_timestamp, not the last 1/3/5 По умолчанию `3`
`country_code`	string	Нет	`"US"`	Country code По умолчанию `"US"`
`content_label_ids`	string	Нет	`""`	Content label IDs, comma separated По умолчанию `""`
`order_by_metric`	integer	Нет	`1`	Order by metric По умолчанию `1`
`organic_only`	boolean	Нет	`false`	Organic content only По умолчанию `false`
`page`	integer	Нет	`1`	Page number По умолчанию `1`
`limit`	integer	Нет	`20`	Items per page, max 100 По умолчанию `20`

Пример запроса

curl --get "https://api.chinaapi.ai/v1/social/tiktok/video-trends" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'period_end_timestamp=1794182400'

Структура ответа

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

{
  "object": "social.result",
  "platform": "tiktok",
  "capability": "video-trends",
  "data": { … }
}

Пагинация

Параметры пагинации: page. Каждая страница — отдельный оплачиваемый вызов; значения курсора передавайте в точности так, как они пришли в предыдущем ответе.

Ошибки и что не оплачивается

Код состояния	Код ошибки	Значение
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 данных

Платные аккаунты начинают с 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].