How to Use TikTok Ad Library search in Perplexity
Search TikTok’s public Ad Library for advertiser names, ad links, available media, first and last shown dates, and estimated audience ranges. Use it to find campaign examples or compare a brand’s advertising activity over time.
Prompts to try with TikTok Ad Library search in Perplexity
Copy an example into Perplexity, or ask in your own words.
Use TikTok Ad Library search to find Gymshark ads delivered in the UK during October 2026. Give me a table of advertiser names, first and last shown dates, audience ranges, and ad links.
Use TikTok Ad Library search to find IKEA ads delivered in Germany during October 2026. Arrange the returned ads by first shown date and include their public links.
Use TikTok Ad Library search to find Nike ads delivered in France during October 2026. Make a shortlist of available video and cover links for a creative review.
Use TikTok Ad Library search to compare Adidas ads delivered in Germany during September and October 2026. Count unique returned ad IDs for each month and show the supporting links.
Use TikTok Ad Library search to find Duolingo ads delivered in the UK during October 2026. Group the results by the audience ranges reported by TikTok.
How to set up TikTok Ad Library search in Perplexity
Pick the way that suits you. Each takes about two minutes.
Use the Perplexity connector
- Add a remote connector
In Perplexity, open Plugins in the sidebar (or Customize › Connectors if you don't see Plugins yet). Choose Add custom › Add MCP connector, then Remote. Name it Spiral and paste this MCP server URL:
https://api.spiral.ai/mcp
- Sign in to Spiral and approve
Select the Spiral card on the Plugins page to start sign-in. Spiral opens: sign in, pick the organization and click Authorize. No API key.
Use the Spiral skill
- Send Perplexity this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run TikTok Ad Library search
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "scrapecreators", "model": "scrapecreators/tiktok-ad-library-search", "input": { "query": "The Creator Loop" } }'
Then paste one of the prompts above: Perplexity finds TikTok Ad Library search on Spiral, shows the price and runs it.
TikTok Ad Library search providers and prices
Spiral runs TikTok Ad Library search through ScrapeCreators. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Perplexity for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Region | all, AT, BE, BG, BR, CH, CY, CZ and 27 more | all | Filter by the ad's targeting/delivery country, not the advertiser's registration country. Omitted region defaults to all supported countries, not every country worldwide. Values are case-insensitive; choose all or one of the listed country codes. US is not supported. Empty values, unsupported countries and multiple countries return 400 bad_request. |
| End time | a whole number | Inclusive upper bound for the ad's last shown date; start_time is the inclusive lower bound. Supply start_time and end_time together as positive base-10 safe integers, no greater than 9007199254740991, in Unix seconds (preferred) or milliseconds. Values greater than 9999999999 are interpreted as milliseconds, divided by 1000 and rounded down to seconds. start_time must be less than or equal to end_time after normalization; equal bounds are accepted. If both are omitted, the last-shown date window defaults to the rolling 30 days ending at the time of each request. A missing companion, empty value, sign, fraction, scientific notation, whitespace, date string, unsafe integer or reversed interval returns 400 bad_request. | |
| Start time | a whole number | Inclusive lower bound for the ad's last shown date; end_time is the inclusive upper bound. Supply start_time and end_time together as positive base-10 safe integers, no greater than 9007199254740991, in Unix seconds (preferred) or milliseconds. Values greater than 9999999999 are interpreted as milliseconds, divided by 1000 and rounded down to seconds. start_time must be less than or equal to end_time after normalization; equal bounds are accepted. If both are omitted, the last-shown date window defaults to the rolling 30 days ending at the time of each request. A missing companion, empty value, sign, fraction, scientific notation, whitespace, date string, unsafe integer or reversed interval returns 400 bad_request. |
Every API field of TikTok Ad Library · Ad Library Search is on its tool page: open its card above.
What can you do with TikTok Ad Library search in Perplexity?
Prepare a TikTok campaign review with ad links, delivery dates, and audience ranges for a public brand. A chat app can organize the returned ads into a readable comparison for a marketing meeting.
Competitor campaign timelines
Arrange a public brand’s returned ads by first and last shown dates to build a campaign timeline with links to the original records.
Creative review shortlists
Collect ad detail links and available video previews for a creative team’s review before planning a new campaign.
Weekly brand advertising reports
Compare successive searches for a brand and report newly observed ad IDs with their first shown dates.
Seasonal campaign research
Find a retailer’s ads around Black Friday or a summer promotion and compare the returned delivery dates.
Audience range comparisons
Compare the estimated audience bands attached to returned ads and prepare a review list without converting bands into exact counts.
Country-specific campaign reviews
Run separate searches for a brand’s ads delivered in Germany and France, then compare the returned ad IDs and dates.
Agency research handoffs
Prepare a deduplicated table of advertiser names, ad IDs, dates, audience ranges, and public links for an account team.
More on TikTok Ad Library search and Perplexity
TikTok Ad Library search in other agents
Questions about TikTok Ad Library search in Perplexity
Can Perplexity use TikTok Ad Library search?
Yes. Add Spiral to Perplexity as an MCP server, and Perplexity can find and run TikTok Ad Library search like any built-in tool.
How much does TikTok Ad Library search cost in Perplexity?
Up to $0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Perplexity plan is separate.
Do I need a ScrapeCreators account to use TikTok Ad Library search in Perplexity?
No. Spiral runs TikTok Ad Library search on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.
How long does it take to set up TikTok Ad Library search in Perplexity?
About two minutes: add a remote connector, then sign in to Spiral and approve.
Does Perplexity wait while TikTok Ad Library search runs?
TikTok Ad Library search runs in the background. Perplexity starts the run, checks on it and gives you the json when it's ready.
Does TikTok’s Ad Library cover advertising worldwide?
TikTok’s published coverage includes ads targeted to the EEA, Switzerland, and the UK. These results should not be treated as a worldwide inventory.
How quickly do new ads appear?
TikTok says ads generally enter the library within 24 hours of campaign initiation.
How far back does the advertising history go?
TikTok retains advertisement data while an ad runs and until one year after it was last shown.
Are the audience figures exact?
TikTok reports unique users seen as estimated ranges. Keep those ranges intact when comparing ads.
Will a search return every matching ad?
ScrapeCreators explicitly warns that results may be incomplete or duplicated. It recommends narrower date windows to reduce pagination.
Start using TikTok Ad Library search in Perplexity
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Perplexity:
set up https://spiral.ai/SKILL.md


