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 -->

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