account | DynamicAccount | Yes | - | TikTok advertiser account that owns the Instant Form. |
page_id | string or SelectItem | Yes | - | Instant Form page_id from tiktok_ads_list_pages with page_type=LEAD_GEN. |
region | enum (ALL, US, EU, OTHER) | No | ALL | Lead storage region: ALL checks every region; US is United States; EU is EEA, Switzerland and UK; OTHER is all remaining countries. Based on where leads were collected, not account currency. Defaults to ALL. |
library_id | string | No | - | Form library ID if leads have been migrated to a Business Center. Replaces advertiser_id in the export request and requires Business Center admin access. |
date_range | LeadDateRange | No | - | Optional inclusive UTC submission date filter. Applied after downloading TikTok’s export; does not reduce export size. Omit for all available dates. |
limit | integer | No | 1000 | Maximum leads returned after the date filter, in TikTok export order. Default 1000; maximum 10000. Export download is still required. Exports above 50 MiB are rejected rather than silently truncated. |