TikTok ads library: ad search
Returns ads from TikTok's public ads library, by keyword, advertiser name or ad ID. Each ad includes its text, video, run dates, impressions, regions shown and targeting, which suits competitor ad research and creative inspiration.
What you get
- Ad ID, ad type and ad text
- Ad video link, cover and image links
- First and last shown dates
- Impressions range
- Countries shown and impressions share by country
- Targeting by location, age and gender
- Advertiser name, ID, country and who paid for the ad
- Landing page link
- Ad status, including removed ads
What it can do
- Search ads by keyword, exact phrase or advertiser name
- Fetch details for specific ad IDs
- Filter by country and date range
- Sort by last shown date, publication date or unique users reached
- Use quick search for faster results with fewer fields
Limits
- Up to 5,812 results per run
- Only publicly visible data
- Without a date range, results cover the past year
- Impressions share by country is only available for EU countries
- Removed ads return partial data, and quick search leaves advertiser and targeting fields empty
Input options
| Field | What it does |
|---|---|
| query | Words or an exact phrase that appear in the ads. |
| advertiserName | Advertiser to search for. |
| adIds | Specific ad IDs to fetch; other search settings are ignored. |
| country | Country code to filter ads; set one when no query is given. |
| startDate | Start of the date range (YYYY-MM-DD). |
| endDate | End of the date range (YYYY-MM-DD). |
| sortBy | Order by last shown date, publication date or impressions. |
| maxPages | Maximum result pages; 0 reads all pages. |
Example
Ask your AI for the data in plain words and it picks this source. Developers can also call source procli_tiktok_a directly through the REST API or MCP with an input like this:
{
"query": "pikoya"
}How to use it
- Create an account at prolevelmax.com. New users receive $1 in sign-up credit after verifying their email (one per person). No card required.
- Connect your AI. In the Dashboard, open Get started → Coding tools and API → Generate setup instructions and paste the instructions into your AI (Claude, ChatGPT, Cursor, Codex and others). You can also add the MCP server
https://prolevelmax.com/mcpor call the REST API. - Request data. Your AI selects a source, quotes the price and runs it only after you confirm. Results are returned as structured JSON that the AI can format as a table or report.
FAQ
How is this source billed?
Per result: $0.0015/result + $0.001/run, min $0.0278/run. Your AI quotes the price first, and you are never charged more than the quote.
Do I need a TikTok account or API key?
No. You only need a ProLevelMax account. One balance and one connection cover all 157 platforms.
Is the data real-time?
Yes. Every call fetches public TikTok data at the time of the request. Only publicly visible content is collected.
More TikTok sources
New users receive $1 in sign-up credit after verifying their email (one per person). No card required. Pay per use with no subscription. Top up by card (USD) or Alipay (CNY); Enterprise top-ups from $1,000 by bank transfer.
Start for free