Credits and limits

Coverage

Ads delivered in the EU or UK only. The only number of people shown is Meta's EU total reach (eu_reach, "EU reach (Meta's total)"), as read on the date shown. Meta publishes no spend or impressions for commercial ads. Countries, ages and genders are shown only as shares of Meta's age x gender breakdown of the same read, never as numbers of people: Meta's breakdown rows do not add up to its EU total (measured 0.93x to 1.10x on 3,820 reads), so a country figure in people would not be a fact.

Credits

1 credit = €0.01, prepaid, never expire. search_winners 5; search_experiments 5; get_ad 2; get_brand 5; get_weights 10; filters 0; account 0. A call that returns nothing costs 0. Errors and refusals are never billed.

Rate limits (they protect the server, not your wallet)

3 requests a second per key, bursts of 15; 8 s at most per query; 50 rows per page, offset up to 1000. A 429 answer has a Retry-After header.

Versions

Paths are versioned (/v1). Inside v1, changes only add things. See CHANGELOG.md.