Freebuff Ads
Developer docs
Freebuff shows your ads to developers inside their coding agent and charges per click. Three things to build against: tracking, the reporting API, and the MCP server.
Start here
Track with no code One script tag. Pick a goal in the console. Fifteen minutes.Track from your server Store the click id, POST once when the signup commits.Pull your numbers Delivery and conversions per day, JSON or CSV.Use it from an agent Claude Code or Cursor runs the console through MCP.
Everything needs an advertiser account. The API and MCP also need an API key.Agentic campaigns are invoiced contracts with a $15,000 monthly minimum, not self-serve.
Five terms
| Term | Meaning |
|---|---|
| Click id | The signed bfcid query parameter every ad click lands with. Pass it through verbatim. |
| Conversion | A business event you report back: signup, trial, demo, install, subscription, or your own. |
| Attribution window | Up to 30 days after the click. Report outside it and the event is refused. |
| What bills | The click, once per developer per campaign per day. Conversions never charge. |
| API key | fbadv_… with scopes ingest, read, manage. Test keys only record test events. |
First call
curl -H "Authorization: Bearer $FREEBUFF_ADS_API_KEY" \
"https://freebuff.com/api/v1/advertisers/reporting/delivery?from=2026-10-01&to=2026-10-07"