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

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

Уровень данных (data_level)

Значение	Описание
`AUCTION_CAMPAIGN`	Уровень кампании
`AUCTION_ADGROUP`	Уровень группы объявлений
`AUCTION_AD`	Уровень объявления

Временной период

Параметр start_date / end_date

Формат дат: YYYY-MM-DD.

start_date=2026-07-01
end_date=2026-07-25

Предустановленные периоды

Период	Диапазон
TODAY	Текущий день
YESTERDAY	Вчера
LAST_7_DAYS	Последние 7 дней
LAST_30_DAYS	Последние 30 дней

Поля (fields)

Список запрашиваемых полей. LightLead автоматически формирует набор полей в зависимости от настроек отчёта.

Пагинация

TikTok API использует page-based пагинацию:

page=1
page_size=100

Максимальный page_size: от 100 до 1000 в зависимости от endpoint.

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

Ответы API проходят через normalizeTikTokApiPayload:

Приведение к единому формату
Обработка отсутствующих полей
Конвертация типов данных

Связанные страницы

Maintained by the LightLead Documentation Team · Last verified: 2026-07-25