Docs menu
Get started
What is Opus GrowthQuickstartAdd to your AIHow it worksSafety and approvalCreditsPlansFAQAI apps
All AI appsChatGPTClaudeGrokPerplexityClaude CodeCodexGemini CLIOpenClawCursorVS CodeWindsurfOther MCPConnect ad platforms
Google AdsMeta AdsLinkedIn AdsMicrosoft AdvertisingTikTok AdsChatGPT AdsAgencies and MCCConnect data sources
Search ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWebsites and SEO
AI ServerWordPressSEO IntelligenceClick fraudTool reference
All toolsGoogle AdsMeta AdsTikTok AdsLinkedIn AdsMicrosoft AdvertisingChatGPT AdsSearch ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWordPressAI ServerSEO IntelligenceClick fraudCross-channelAccount and billingLanguage
Download TikTok Leads
Downloads every lead collected by TikTok lead-gen or messaging ads, with each lead's answered fields.
- Type
- Reads only
- Credits
- 2
- Platform
- TikTok Ads
- Approval
- Not needed, nothing changes
What it does
Downloads every lead collected by TikTok lead-gen or messaging ads, with each lead's answered fields. lead_source: INSTANT_FORM (form ads — page_id REQUIRED, from list_tiktok_lead_forms) or DIRECT_MESSAGE (messaging ads). Optional ad_id narrows to one ad; start_date/end_date are YYYY-MM-DD. limit is the number of leads in this response (0 = as many as fit, about 370 KB); when has_more is true, call again with page_token=next_page_token to retrieve the remaining leads without a new TikTok request or another credit.
MCP: download_tiktok_leads
How to use it
You don't call tools by name. Write what you want in ChatGPT, Claude or another assistant connected to Opus Growth, in your own words; it picks this tool when it fits.
Parameters
| Name | Type | Required | Default | |
|---|---|---|---|---|
| advertiser_id | string | Optional | · | TikTok advertiser account ID to query or change. Use the exact ID returned by list_tiktok_advertisers or list_tiktok_bc_advertisers. |
| lead_source | string | Optional | INSTANT_FORM | INSTANT_FORM · DIRECT_MESSAGE · Exact lead source value for download tiktok leads. Supply text in the provider's required format; when it selects an existing resource, use the exact identifier returned by the relevant list or search operation; matching the schema pattern. |
| page_id | string | Optional | · | Exact page identifier to target. Use the ID returned by an Opus Growth list or create operation, not a display name. |
| ad_id | string | Optional | · | Exact ad identifier to target. Use the ID returned by an Opus Growth list or create operation, not a display name. |
| start_date | string | Optional | · | Inclusive start date for the requested period, in the format required by this tool. |
| end_date | string | Optional | · | Inclusive end date for the requested period, in the format required by this tool. |
| limit | integer | Optional | 0 | Maximum number of rows returned in this response. When the result has_more flag is true, continue with next_page_token rather than assuming the list is complete. |
| page_token | string | Optional | · | Continuation token returned as next_page_token by a previous call. Leave empty for the first page; pass it unchanged to retrieve the cached next page. |
Related tools
connect_tiktok_adsCreate TikTok Adcreate_tiktok_adCreate TikTok Ad Groupcreate_tiktok_adgroupCreate TikTok Welcome-Chat Templatecreate_tiktok_auto_messageCreate TikTok Campaigncreate_tiktok_campaignCreate TikTok Customer-List Audiencecreate_tiktok_customer_file_audienceCreate TikTok Ad Identitycreate_tiktok_identityCreate TikTok Lookalike Audiencecreate_tiktok_lookalike_audienceCreate TikTok Pixelcreate_tiktok_pixel