Ads.txt API

BidSwitch collects ads.txt information, as outlined in the BidSwitch and Ads.txt. This information is made available through the ads.txt information endpoint, where filename can take the following options.

<!-- Endpoint Syntax -->
https://api.bidswitch.com/adstxt/<filename>
Ads.txt Info API Files and Types
Filename Types Description
ssp-domains-mapping .json .csv The BidSwitch mapping file for converting Supplier names from BidSwitch-specific names to those listed in Ads.txt files, e.g. https://api.bidswitch.com/adstxt/ssp-domains-mapping.json
ssp-domains-valid .json .csv Valid Supplier domains which appear in publisher ads.txt files, e.g. https://api.bidswitch.com/adstxt/ssp-domains-valid.json
ssp-domains-invalid .json .csv Invalid Supplier domains which appear in publisher ads.txt files, e.g. https://api.bidswitch.com/adstxt/ssp-domains-invalid.json
pub-domains-enforced .json .csv Publisher who have requested their Ads.txt file is enforced on any Bid Request referencing their inventory, e.g. https://api.bidswitch.com/adstxt/pub-domains-enforced.csv

Note

The .csv file will return one file with all of the information, the .json file will contain 10 results. See the below section for the JSON Response Format.

JSON Response Format

Each response includes zero or more objects packed into one response as shown in the below example.

Ads.txt Info API JSON Response Format
Value Type Description
count int Specifies the total amount of results to be returned, 10 results are returns per page,
previous str Contains the URL for the previous set of status returns.
results array of objects Returns the results of the query.
next string

Contains the URL for the next set of returns. The status information is divided into pages of no more than 10 objects each, and you have to request pages one at a time.

To receive the next page, you need to make a new HTTP GET request to the next field value in each response. To receive the complete list, you need to make GET requests until you reach the page which has null in the "next" field, e.g. "next":null,

{
   "count":1985,
   "next":"http://api.bidswitch.com/adstxt/ssp-domains-valid.json?page=5",
   "previous":"http://api.bidswitch.com/adstxt/ssp-domains-valid.json?page=3",
   "results":[
      {
         "domain":"liqwid.com",
         "bsw_name":"external"
      },
      {
         "domain":"redirect.com",
         "bsw_name":"external"
      },
      {
         "domain":"miaozhen.com",
         "bsw_name":"external"
      },
      {
         "domain":"platform.videologygroup.com",
         "bsw_name":"videology"
      },
      {
         "domain":"ideologygroup.com",
         "bsw_name":"videology"
      },
      {
         "domain":"vidmatic.tv",
         "bsw_name":"vidmatic"
      }
   ]
}

Table Of Contents