DSP endpoint traffic and spend

Returns bid requests, bids, wins, billed impressions and spend per DSP endpoint for a date range.

Reference

GET https://YOUR-NETWORK-DOMAIN/rest-api/rtb/dsp-analytics/search.do

Returns bid requests, bids, wins, billed impressions and spend per DSP endpoint for a date range. Spend is the gross booked on the impressions the endpoint won — the same figure the Gross column of the standard report shows for its creatives — so it reconciles with what the partner is invoiced. Which dimensions the rows carry is decided by groupBy; a dimension left out is aggregated over and comes back null. Note that countryCode is also null when the country could not be resolved, so under groupBy=countryCode a null is an unknown country rather than an aggregate. With no groupBy the call returns a single total row for the range. Requires the DSP Partners Analytics permission.

Query Params

from string required

First day of the range, inclusive

2026-08-01

to string required

Last day of the range, inclusive

2026-08-31

groupBy string

Comma-separated dimensions to break the rows down by: date, dspPartnerName, placementId, countryCode. Empty means one total row.

date,dspPartnerName

sort string

Column to sort on — any dimension listed in groupBy, or one of requests, bids, wins, impressions, spend

spend

dir string

Sort direction

desc

start integer

Row offset for paging

0

limit integer

Maximum rows to return, up to 10000

1000

Responses

200

Analytics rows retrieved successfully

400

Malformed date, reversed range or unknown groupBy dimension

401

Authentication error

403

Permission denied

Language

cURL Request

curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/rtb/dsp-analytics/search.do?from=2026-08-01&to=2026-08-31&groupBy=date%2CdspPartnerName&sort=spend&dir=desc' \
  --header 'X-Api-Key: YOUR_API_KEY'

Python Request

import requests

response = requests.request("GET", "https://YOUR-NETWORK-DOMAIN/rest-api/rtb/dsp-analytics/search.do?from=2026-08-01&to=2026-08-31&groupBy=date%2CdspPartnerName&sort=spend&dir=desc", headers={"X-Api-Key": "YOUR_API_KEY"})
print(response.json())

Node Request

const response = await fetch('https://YOUR-NETWORK-DOMAIN/rest-api/rtb/dsp-analytics/search.do?from=2026-08-01&to=2026-08-31&groupBy=date%2CdspPartnerName&sort=spend&dir=desc', {
  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/rtb/dsp-analytics/search.do?from=2026-08-01&to=2026-08-31&groupBy=date%2CdspPartnerName&sort=spend&dir=desc"))
    .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/rtb/dsp-analytics/search.do?from=2026-08-01&to=2026-08-31&groupBy=date%2CdspPartnerName&sort=spend&dir=desc");
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/rtb/dsp-analytics/search.do?from=2026-08-01&to=2026-08-31&groupBy=date%2CdspPartnerName&sort=spend&dir=desc", 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/rtb/dsp-analytics/search.do?from=2026-08-01&to=2026-08-31&groupBy=date%2CdspPartnerName&sort=spend&dir=desc");
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/rtb/dsp-analytics/search.do?from=2026-08-01&to=2026-08-31&groupBy=date%2CdspPartnerName&sort=spend&dir=desc")
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