The TikTok ad details your agent needs.
TikTok Ad Details returns one ad with its reach, impressions, audience and targeting by country.
terminal
TikTok Ad Details APIfor AI agents
One API call to read a TikTok ad. Get its reach, audience and targeting as JSON.
What people use it for.
See who an ad targets
Read ages and genders in regions, and read interests. They show which audience a competitor's ad is for.
Find an ad's landing page
Read linkUrl and ctaText. They show where the ad sends people and what it asks them to do.
Compare an ad by country
Compare impressionsMax across the countries in regions. You see where the advertiser spends most.
More TikTok endpoints.
- ProfileGet a profile's bio, stats and a page of its videos
- VideoGet a video's caption, stats and music
- HashtagGet a page of videos for a hashtag
- SoundGet a sound and a page of videos that use it
- CommentsGet a video's comments, or the replies to one comment
- SearchSearch TikTok videos and users
- TranscriptGet what a TikTok video says, from captions or its own audio
- Search adsSearch ads in the TikTok ad library
- Product searchSearch Shop products by keyword, with price and sales
- ProductsA seller's products, name, rating and sales
- ProductA product's price, stock, seller, images and videos
- ReviewsThe first page of a product's reviews
- All TikTok endpointsOne API for TikTok data. Get profiles, videos, comments, transcripts, shop products and ads as JSON.
Ways to call it.
- Use the APISend a POST request with a Bearer key. Every endpoint returns success, data, creditsUsed and requestId.
- Use MCPAdd https://api.stophy.dev/mcp to Claude, Cursor or Codex. The agent finds an endpoint and calls it.
- Use the SDKInstall the TypeScript or Python client. Call an endpoint by its id, such as youtube.transcript.
- Use the CLICall an endpoint from the terminal. The CLI prints JSON, so you can pipe the result into a script.
Start free. Pay per call after.
No plans and no monthly fee. 1,000 free credits to start, then $1.50 per 1,000 credits, $1.20 from $100 and $0.80 from $500. Credits never expire.
Free
Every account starts with free credits. No card needed.
1,000 free credits
$0
- ✓Every source
Pay as you go
Add credits to your balance and spend them one call at a time.
$1.50 per 1,000 credits, $1.20 from $100 and $0.80 from $500
$0.0015/ credit
10,000 credits≈ $13.50
Most calls cost 1 credit.
- ✓Never expires
Custom
For teams that need higher rate limits or a source we do not cover yet.
Volume pricing
Custom
- ✓Custom rate limits
- ✓New sources on request
- ✓Direct support
Questions and answers.
No. You call Stophy with a Stophy API key and an ad link or an ad id. You need no TikTok Ads Manager account.
One ad. It has the fields of a search result, plus advertiserId, advertiserCountry, paidBy, linkUrl, ctaText, objective, category, audienceSizeMin, audienceSizeMax, impressionsMin, impressionsMax, countries, languages, interests and regions.
A list with one item for each country. Each item has country, impressionsMin, impressionsMax, ages and genders. ages and genders list the audience groups for that country.
Call tiktok.ads.search. Each result has an adId and an adUrl. Send either one here.
paidBy names who paid for the ad. advertiserCountry is the advertiser's country.
1 credit for each call that returns data. A call that returns an error uses 0 credits.
Yes. Add the MCP server at https://api.stophy.dev/mcp to Claude, Cursor or Codex. The agent calls the endpoint by the id tiktokAdsAd.
Get started
Give your agent the web today.
Sign up for 1,000 free credits. No card needed.