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"
      }
   ]
}