The Google ad details your agent needs.
Google Ad Details returns one ad with its variations, regions, impression ranges and targeting. Look it up by link or by ad id.
terminal
Google Ad Details APIfor AI agents
One API call to read a Google ad. Get its versions, regions and reach as JSON.
What people use it for.
See where an ad runs
Read regions on an ad to see each country where it ran and the dates it ran there.
Review the versions of an ad
Read variations and open each previewUrl. You see every version of the ad that the advertiser tested.
Check who paid for an ad
Read paidBy and advertiserIsVerified. They tell you who paid for the ad and whether Google verified the advertiser.
More Google endpoints.
- SearchSearch Google and get results, the AI Overview, the knowledge panel and related questions
- NewsSearch Google News by keyword, date, site and country, or read headlines by topic
- ImagesSearch Google Images and get each full-size image with the page it comes from
- AI ModeAsk Google AI Mode a question and get its answer with the sources it cites
- ShoppingCompare product prices and sellers on Google Shopping by country
- SuggestionsGet Google search suggestions for a keyword
- Search adsSearch ads in the Google ads library
- AdvertisersFind advertisers in the Google ads library
- ScholarSearch Google Scholar for papers, books and case law, with citations
- VideosSearch Google's Videos tab for videos from every site, with duration and channel
- JobsSearch Google Jobs: openings from many job sites, with apply links and highlights
- PatentsSearch Google Patents by words, inventor, assignee, office, dates and status
- Maps searchSearch places on Google Maps by keyword and location
- Maps placeGet a place's address, hours, rating and contact details
- Maps reviewsGet a place's reviews
- Related searchesGet related searches for a keyword
- Trending nowGet what is trending on Google now
- FlightsSearch flights with prices and times
- HotelsSearch Google Hotels with prices, ratings and Google's own filters
- Play appGet an app's details from Google Play
- Play searchSearch Google Play apps
- Play reviewsGet an app's Google Play reviews
- Trends interest over timeGet Google Trends search interest over time, newest first, with one value per query
- Trends by regionGet Google Trends search interest by region
- All Google endpointsOne API for Google data. Get search results, Maps places, Trends, flights, Play apps 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 Google Ads account.
One ad. It has the fields of a search result, plus advertiserCountry, advertiserIsVerified, paidBy, impressionsMin, impressionsMax, variations, regions, targetingIncluded and targetingExcluded.
Send adUrl, which is the link to the ad in the Ads Transparency Center. Or send adId together with advertiserId. A google.ads.search result has all three values.
A list with one item for each country. Each item has country, firstShownAt, lastShownAt, impressionsMin and impressionsMax.
Each variation is one version of the ad. It has a previewUrl, an imageUrl and a videoUrl. A field that does not apply to the version is null.
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 googleAdsAd.
Get started
Give your agent the web today.
Sign up for 1,000 free credits. No card needed.