Realtime Ads Report

get

https://backstage.taboola.com/backstage/api/1.0/{account_id}/reports/realtime-top-campaign-content/dimensions/{dimension}

The Realtime Ads (aka Top Campaign Content) report provides performance data for ads in (near) real time.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

📍
Important
Metrics and amounts are not accurate for billing.

📘
Dimensions & filters

Pass a dimension path param, and the relevant query param filters.

Make sure to follow the specific guidelines for your chosen dimension and filters - see Dimensions Cheat Sheet and Filters.

📘
Sample requests
Some sample requests are provided below.

🚧
Rate limit

The rate limit is 10 requests per minute.

If the rate limit is exceeded, a response code of 429 is returned.

Path Params

account_id

string

required

An alphabetic ID. See Get Account Details.

dimension

string

enum

required

The report dimension (aka view) e.g. by_item.
See Dimensions Cheat Sheet

Allowed:

Query Params

start_date

string

required

E.g. 2023-03-28T00:00:00

end_date

string

required

E.g. 2023-03-28T23:59:59

item

string

required

1 or more numeric Item IDs (aka Ad IDs), as a comma-separated list.
E.g.item=1001,1002,1003
Can be required or unsupported - see Dimensions Cheat Sheet

campaign

string

1 or more numeric Campaign IDs, as a comma-separated list.
E.g.campaign=101,102,103

platform

string

1 or more platform enums, as a comma-separated list.
Possible values:
DESK
PHON
TBLT

country

string

1 or more 2-letter ISO-3166 country codes, passed as a comma-separated list.
Use the Dictionary to fetch a list of supported values.

site_id

string

1 or more numeric Site IDs (publisher Account IDs), as a comma-separated list.