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.

Rate limit: Tier 4

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

🚧
Rate limit
Tier 4. Each of the two dimensions has its own budget, separate from one another and from every other report.
See Rate limits for the request allowance each tier carries.

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.