Broadsign Ads REST API Endpoints

The Broadsign Ads REST API provides programmatic access to the Reports generated on the Broadsign Ads platform so that you can integrate these report files into your own data management suites.

Note: You must enable the Broadsign Ads API feature for each respective organization In Broadsign Ads, an Organization is a client account that contains one or several users. to which you belong before you can access your reports programmatically.

We use HTTP verbs, response codes, and authentication. All of our REST responses are in JSON.

You will need a token to use the Broadsign Ads REST API.

A token is a piece of data that has no meaning or use on its own, but combined with the correct tokenization system, becomes a vital player in securing your application. Token based authentication works by ensuring that each request to a server is accompanied by a signed token which the server verifies for authenticity and only then responds to the request.

To use the Broadsign Ads REST API:

  1. Access https://api.buy.broadsign.com/v1/auth with the following data:
    2. Copy 
    POST https://api.buy.broadsign.com/v1/auth
    {
      "Username": "myusername",
      "Password": "mypassword"
    }

    Replace the Username and Password with your own.

    The Broadsign Ads REST API will return the following data:

    Copy 
    {
        "token": "mytoken"
    }
  2. Pass the token in the http header:
    3. Copy 
    [POST/GET/PUT] https://api.buy.broadsign.com/v1/auth/[api call]/
    {
      Authorization: [THE_TOKEN]
    }

    The verb used ([POST/GET/PUT]) depends on the API called.

    The API call depends on the method that you are using.

The following REST Methods are available: