Start a campaign

Advertiser API

Your campaign data, wherever you work.

The Advertiser API sends your bidsystem.ai performance to the tools your team already uses, and lets you run campaigns from code. One API key, plain JSON.

Start a campaignTalk to sales

Already advertising? Generate a key under Developer > API Keys.

RequestPOST /v1/reports
X-API-Key: your-api-key

{
  "start_date": "2026-03-01",
  "end_date": "2026-03-06",
  "dimensions": ["date", "placement_type"],
  "metrics": ["impressions", "clicks", "spend"]
}
Response200 OK
{
  "total_records": 2,
  "data": [
    { "date": "2026-03-05", "placement_type": "banner",
      "impressions": 50000, "clicks": 1200, "spend": 450 },
    { "date": "2026-03-06", "placement_type": "interstitial",
      "impressions": 48000, "clicks": 1150, "spend": 430 }
  ]
}
Example request and response, from the API docs.

What your team can do with it.

Built for performance marketers, agencies and in-house teams who report and optimize outside the dashboard.

  • Your data, in your tools.

    Pull campaign performance into your BI tool, warehouse or client dashboards. Choose the dimensions and metrics, filter, and run it on your schedule. No more CSV exports.

  • Real-time numbers.

    Spend, clicks and conversions from the last hour, by campaign and ad group, so you can act while there is still budget to change.

  • Automate the busywork.

    Pause, activate and update campaigns, ad groups and creatives in bulk from your own scripts and rules.

  • Close the loop on offline sales.

    Upload CRM and offline conversions by click ID, with their value, so bidding optimizes to the revenue you actually booked.

Connected in three steps.

Your developer or analyst can take it from here. The docs cover every report, field and limit.

Read the API docs

The docs open after you sign in to your bidsystem.ai account.

  1. Create an account. Self-serve registration. No sales call required.
  2. Generate an API key. In your dashboard, under Developer > API Keys.
  3. Connect your tool or script. Send the key in the X-API-Key header and pull your first report.

Launch a campaign. Plug in the API.

Set a goal and a budget, go live across 5,000+ premium sites and apps, and pull every result into the tools you already use.

Start a campaignBook a walkthrough