Get advertiser ads.txt lines

Returns the ads.txt lines stored on the advertiser, parsed: each line's id, kind (RECORD — domain, account ID, DIRECT or RESELLER, optional certification ID; VARIABLE — e.g.

Reference

GET https://YOUR-NETWORK-DOMAIN/rest-api/advertisers/{advertiserId}/ads-txt.do

Returns the ads.txt lines stored on the advertiser, parsed: each line's id, kind (RECORD — domain, account ID, DIRECT or RESELLER, optional certification ID; VARIABLE — e.g. INVENTORYPARTNERDOMAIN=), its text, and notPublished — why a variable stored before such lines were refused (OWNERDOMAIN, MANAGERDOMAIN, CONTACT, SUBDOMAIN) is left out of every site's block, else null. They belong on an advertiser that is really a demand partner selling through its own tag (an ad network or exchange tag, a DSP seat): ads.txt lists sellers, so an ordinary advertiser that only buys has none. Every site with one of the advertiser's active banners linked to an active placement adds them to its ads.txt block. Requires ENABLED or READONLY level on the ADVERTISER_ADS_TXT permission and VIEW permission on the advertiser.

Path Params

advertiserId integer required

Unique numeric ID of the advertiser

1001

Responses

200

Lines returned

400

Bad request — invalid or missing parameters

401

Authentication error

403

No ADVERTISER_ADS_TXT permission, or the advertiser is outside the caller's shares

404

Advertiser not found

Language

cURL Request

curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/advertisers/1001/ads-txt.do' \
  --header 'X-Api-Key: YOUR_API_KEY'

Python Request

import requests

response = requests.request("GET", "https://YOUR-NETWORK-DOMAIN/rest-api/advertisers/1001/ads-txt.do", headers={"X-Api-Key": "YOUR_API_KEY"})
print(response.json())

Node Request

const response = await fetch('https://YOUR-NETWORK-DOMAIN/rest-api/advertisers/1001/ads-txt.do', {
  method: 'GET',
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
});

console.log(await response.json());

Java Request

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://YOUR-NETWORK-DOMAIN/rest-api/advertisers/1001/ads-txt.do"))
    .header("X-Api-Key", "YOUR_API_KEY")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

C# Request

using var client = new HttpClient();

var request = new HttpRequestMessage(new HttpMethod("GET"), "https://YOUR-NETWORK-DOMAIN/rest-api/advertisers/1001/ads-txt.do");
request.Headers.Add("X-Api-Key", "YOUR_API_KEY");

var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

Go Request

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://YOUR-NETWORK-DOMAIN/rest-api/advertisers/1001/ads-txt.do", nil)
	req.Header.Set("X-Api-Key", "YOUR_API_KEY")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()

	out, _ := io.ReadAll(res.Body)
	fmt.Println(string(out))
}

PHP Request

<?php
$ch = curl_init("https://YOUR-NETWORK-DOMAIN/rest-api/advertisers/1001/ads-txt.do");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-Api-Key: YOUR_API_KEY"]);

echo curl_exec($ch);
curl_close($ch);

Ruby Request

require 'net/http'
require 'json'

uri = URI("https://YOUR-NETWORK-DOMAIN/rest-api/advertisers/1001/ads-txt.do")
request = Net::HTTP::Get.new(uri)
request['X-Api-Key'] = 'YOUR_API_KEY'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
puts response.body