# Ads data API for AI agents: from $0.001 per call ($1 per 1,000), no subscription

> Whizbrew's Ads data API costs from $0.001 per call ($1 per 1,000 calls); a typical call is $0.002 ($2 per 1,000). Only a call that returns data is charged: an empty or failed call is free. There is no subscription and no monthly fee. A new account starts with $2 of free credit, with no card.

It reads public Ads data: 8 tools, live at the moment of the call, over one API key or one MCP server (`https://whizbrew.com/mcp`). It is an API, not a scraper you run: no proxies, no browser and no scraping code on your side. The same key reaches 893 tools for other platforms ([all APIs](https://whizbrew.com/api), [all tools](https://whizbrew.com/tools?a=155ddee98864), [pricing](https://whizbrew.com/pricing?a=155ddee98864)).

## Pricing

| Tool | What it returns | Per call that returns data | Per 1,000 calls |
|---|---|---|---|
| `ads.app` | Ads an app is running, read from the public ad libraries. When there are none, the answer is {ads: [], total_by_platform, note} and says which libraries have ads for the app. When the tracker is slow the answer is {ads, partial: true, note, retry_after_s}: the ads that could be read in time, and what is missing (none in time: status no_answer_in_time, free). | $0.006 | $6 |
| `ads.publisher_sellers` | Which large ad exchanges sell a publisher's ad space: looks the publisher's domain up in the sellers.json files of 14 exchanges (Magnite, OpenX, PubMatic, Index Exchange, Xandr, TripleLift, Sovrn, Equativ, Sharethrough, 33Across, Media.net, Yieldmo, Teads, Amazon) and returns its seller accounts in each. | $0.006 | $6 |
| `ads.app_ads_txt` | The ad sellers an app authorizes (its app-ads.txt), found the way ad buyers find it: the developer website named in the app's App Store or Google Play listing. Returns the exchanges, account ids and direct or reseller. | $0.002 | $2 |
| `ads.find_advertiser` | Where does a brand advertise? Looks one brand name or website up in eight ad libraries at once (Google, Meta, Apple App Store, Microsoft Bing, Snapchat, Amazon, Pinterest, TikTok) and returns for each whether it was found, the matching advertisers with their ids, the number of ads where the library gives one, and the tool that lists the ads there. | $0.009 | $9 |
| `ads.new_since` | The ads an advertiser started on or after a date, for a weekly look at a competitor: reads Google's ad library (by website or advertiser id) and Meta's (by Facebook page id), keeps the ads whose own start date is on or after the day, newest first, and says how many each library has. One page per library (Google up to 40 ads, Meta up to 30); has_more tells when there are more. ads.find_advertiser finds the ids for a brand name. Free when no new ad is found. | $0.006 | $6 |
| `ads.metrics` | The ratios of a campaign from its raw numbers: give any two or more of spend, impressions, clicks, conversions and revenue and get every metric they allow: CPM, CTR, CPC, conversion rate, CPA, ROAS, average order value, revenue per click and per 1000 impressions, and revenue minus spend. A metric whose inputs are missing is null and named in not_computed. Computed; nothing is read. | $0.001 | $1 |
| `ads.break_even` | What an ad may cost before it loses money: from the order value and the margin (or the unit cost), the highest cost per acquisition, the lowest ROAS and, with a conversion rate, the highest cost per click, for the first order and for the customer's lifetime (orders_per_customer). With target_profit_pct the same limits at the profit you want to keep. Computed; nothing is read. | $0.001 | $1 |
| `ads.shared_sellers` | The ad-seller accounts that two to five sites all authorize in their own ads.txt files, to see whether sites belong together: the same DIRECT account on several sites means one publisher or one sales house sells the ad space of all of them. Per shared account: exchange, account id and how each site lists it; per pair of sites: shared accounts, shared DIRECT accounts, the share of the smaller file and whether both name the same owner domain; per site: its account counts, owner and manager domains. Shared RESELLER accounts are common between unrelated sites and say little. Reads each site's /ads.txt now (domain.ads_txt lists one file in full). No account in common is free. | $0.002 | $2 |

## Example calls

`ads.app` ($0.006 per call): Ads an app is running, read from the public ad libraries

```
curl -s -X POST https://whizbrew.com/v1/call/ads.app \
  -H "Authorization: Bearer $WHIZBREW_KEY" -H "content-type: application/json" \
  -d '{"app_id":"570060128","limit":3}'
```

`ads.publisher_sellers` ($0.006 per call): Which large ad exchanges sell a publisher's ad space: looks the publisher's domain up in the sellers.json file

```
curl -s -X POST https://whizbrew.com/v1/call/ads.publisher_sellers \
  -H "Authorization: Bearer $WHIZBREW_KEY" -H "content-type: application/json" \
  -d '{"domain":"nytimes.com"}'
```

`ads.app_ads_txt` ($0.002 per call): The ad sellers an app authorizes (its app-ads.txt), found the way ad buyers find it: the developer website nam

```
curl -s -X POST https://whizbrew.com/v1/call/ads.app_ads_txt \
  -H "Authorization: Bearer $WHIZBREW_KEY" -H "content-type: application/json" \
  -d '{"app":"com.duolingo","limit":10}'
```

Over MCP the same call is `call_tool` with `{"tool": "<name>", "arguments": {…}}`. How often each tool works, measured from real calls: [https://whizbrew.com/status](https://whizbrew.com/status).

## Start

- **An agent on its own**: read [https://whizbrew.com/agents.md?a=155ddee98864](https://whizbrew.com/agents.md?src=body-text&a=155ddee98864). It asks for a free quote (`GET https://whizbrew.com/v1/agent/guide?goal=<the task in plain words>`), then one request (`POST https://whizbrew.com/v1/agent/start?a=155ddee98864`) gives it a key that works at once with the free credit, with no email and no sign-up form. Its human claims the account later.
- **A chat app** (ChatGPT, Claude, Gemini): add the MCP server `https://whizbrew.com/mcp` as a custom connector and sign in. No key to copy.
- **An agent with a shell** (Claude Code, Codex, Cursor): read [https://whizbrew.com/llms.txt?a=155ddee98864](https://whizbrew.com/llms.txt?src=body-text&a=155ddee98864). The agent starts a pairing with one request, its user approves with one click, and the agent holds its own key.
- **Plain HTTP**: create an account at [https://whizbrew.com/app#signup](https://whizbrew.com/app#signup), make a key, then `POST https://whizbrew.com/v1/call/<tool>` with `Authorization: Bearer <key>`.
