Read your Inventory, Missed Traffic and Reports from your own scripts, bots and AI assistants. The API is read-only: it never changes campaigns or money.
1. Get your API key
In PPCmate X go to Profile → Security → API key and click Generate API key.
- Keep it private: anyone with the key can read your data.
- Rotate makes a new key and stops the old one at once. Revoke stops all calls.
- Send the key in the
X-Api-Keyheader. - Up to 30 calls a minute per key.
- Dates are
YYYY-MM-DD, at most 31 days per call. With no dates you get the last 7 days.
2. Inventory
The traffic you can buy, grouped by one dimension: requests, average floor (CPM, over the requests that carried a floor), our bids and impressions.
curl "https://api.ppcmate.com/api/public/v1/inventory?from=2026-11-01&to=2026-11-02&by=rootdomain" \
-H "X-Api-Key: YOUR_KEY"
| Parameter | Values |
|---|---|
by |
rootdomain (default), domain, country, ssp, format |
from, to |
Inclusive dates |
timezone |
Optional, for example Europe/Paris |
The answer has columns (the names) and rows (one array per group, in column order).
3. Missed Traffic
Requests your campaigns skipped before bidding, by reason (for example below floor or targeting), with the average floor where it applies.
curl "https://api.ppcmate.com/api/public/v1/missed-traffic?from=2026-11-01&to=2026-11-02" \
-H "X-Api-Key: YOUR_KEY"
Optional filters: campaignId, country (ISO code), reason. The answer has summary (by reason), byCampaign and rows (top 200).
4. Reports
POST https://api.ppcmate.com/api/public/v1/report takes the same report request the Reports page sends (dimensions, columns, dates) and returns the same table.
5. AI assistants (MCP)
Connect PPCmate X to ChatGPT or Claude (see Connecting PPCmate to Claude or ChatGPT) and ask in plain words. The tools get_inventory and get_missed_traffic read the same data as above.
Errors
| Status | Meaning |
|---|---|
| 401 | Missing or wrong key |
| 400 | Bad parameter, or more than 31 days |
| 403 | The key does not belong to an advertiser |
| 429 | More than 30 calls in a minute |