The Microsoft ad details your agent needs.
Microsoft Ad Details returns one ad with its text, payer, run dates, impression range, countries and targeting.
terminal
Microsoft Ad Details APIfor AI agents
One API call to read a Microsoft ad. Get its dates, impressions and targeting as JSON.
What people use it for.
Check who paid
Read paidBy on an ad before you report on it. It names who paid for the ad.
See where an ad ran
Read countries to see the share of the ad's impressions in each market.
Date a brand's campaigns
Read firstShownAt and lastShownAt for each ad of a brand. The dates show when the brand ran its campaigns.
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 id. You need no Microsoft Advertising account.
One ad. It has adId, advertiserId, advertiserName, headline, text, linkUrl, linkCaption, imageUrls, paidBy, firstShownAt, lastShownAt, impressionsMin, impressionsMax, countries and targeting.
Call microsoft.ads.search. Each result has an adId. This endpoint takes the id only, not a link.
countries is a list with a country and its share for each item. impressionsMin and impressionsMax give the range for the whole ad.
targeting is a list. Each item has a type and isExcluded, which is true when the advertiser excluded that group.
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 microsoftAdsAd.
Get started
Give your agent the web today.
Sign up for 1,000 free credits. No card needed.