Overview

The Advertiser API empowers advertisers to streamline campaign management and gain valuable insights through programmatic access. Gain real-time access to data and campaign performance, empowering informed decision-making.

Requesting private API key#

The BuySellAds API uses private key authentication to authenticate all endpoints. If you would like to leverage the API, please reach out to your account manager so that they can generate your unique API Key.

To authenticate your requests, append your API key as a URL parameter:

?key=YOUR_API_KEY

Important notes#

• HTTPS required: All API requests must use HTTPS.
• Timezone: All dates and "current month" references use UTC.
• No pagination: Endpoints return all matching records. Use startDate and endDate parameters to limit results for large date ranges.

Error responses#

Invalid or missing API key:

{
  "response": {
    "error": "HTTP Error 401 Unauthorized"
  }
}

Invalid endpoint returns an HTML error page.