TikTok Ads Request Parameters
Parameters for requests to the TikTok Ads API define what data is retrieved and in what format.
Data Level (data_level)
| Value | Description |
|---|---|
AUCTION_CAMPAIGN | Campaign level |
AUCTION_ADGROUP | Ad group level |
AUCTION_AD | Ad level |
Time Period
The start_date / end_date Parameter
Date format: YYYY-MM-DD.
start_date=2026-07-01
end_date=2026-07-25Preset Periods
| Period | Range |
|---|---|
| TODAY | Current day |
| YESTERDAY | Yesterday |
| LAST_7_DAYS | Last 7 days |
| LAST_30_DAYS | Last 30 days |
Fields (fields)
The list of fields to request. LightLead automatically builds the set of fields based on the report settings.
Pagination
The TikTok API uses page-based pagination:
page=1
page_size=100Maximum page_size: from 100 to 1000, depending on the endpoint.
Normalization Parameters
API responses pass through normalizeTikTokApiPayload:
- Conversion to a unified format
- Handling of missing fields
- Data type conversion