---
title: "DSP endpoint traffic and spend"
type: reference
method: GET
path: /rest-api/rtb/dsp-analytics/search.do
tag: "Analytics"
---

# DSP endpoint traffic and spend

`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

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `from` | string | yes | `2026-08-01` | First day of the range, inclusive |
| `to` | string | yes | `2026-08-31` | Last day of the range, inclusive |
| `groupBy` | string | no | `date,dspPartnerName` | Comma-separated dimensions to break the rows down by: date, dspPartnerName, placementId, countryCode. Empty means one total row. |
| `sort` | string | no | `spend` | Column to sort on — any dimension listed in groupBy, or one of requests, bids, wins, impressions, spend |
| `dir` | string | no | `desc` | Sort direction |
| `start` | integer | no | `0` | Row offset for paging |
| `limit` | integer | no | `1000` | Maximum rows to return, up to 10000 |

## Responses

- `200` — Analytics rows retrieved successfully
- `400` — Malformed date, reversed range or unknown groupBy dimension
- `401` — Authentication error
- `403` — Permission denied

## Example request

```bash
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'
```

Source: https://epom.com/ad-server/docs/api/analytics/get-rtb-dsp-analytics-search