Welcome to the Taboola Backstage API documentation. You'll find comprehensive guides and examples to help you get started with Taboola Backstage API quickly.
Lots of 502 responses at around 2020-02-20 05:16:18.006 PST Were there server issues? Could this be load related? Most of the API calls are for campaign updates. Thanks
Posted by Raymond Ho about a year ago
I am trying to get hourly data, and the API only responds with hour 0. Is there a special parameter I need to pass in order to get the entire day of hourly? Here is an example of my API call: https://backstage.taboola.com/backstage/api/1.0/spigot-network/reports/campaign-summary/dimensions/by_hour_of_day?start_date=2020-02-20&end_date=2020-02-20&include_multi_conversions=true
Posted by Carl about a year ago
I'm getting an error sometimes when accessing the item_breakdown endpoint. It'll work fine the first few times and then I'll get his error. I'm masking out specific information in the calls and responses to paste them here. The endpoint: Request URL: https://backstage.taboola.com/backstage/api/1.0/##########-altium-sc1/reports/top-campaign-content/dimensions/item_breakdown?start_date=1900-01-01&end_date=2020-02-17&campaign=########## Referrer Policy: no-referrer-when-downgrade The response message after the call errors out is: accept-ranges: bytes content-length: 0 date: Mon, 17 Feb 2020 21:27:02 GMT server: nginx status: 429 via: 1.1 varnish x-cache: MISS x-cache-hits: 0 x-served-by: cache-chi21133-CHI x-timer: S1581974823.691708,VS0,VE160 The error in the browser console is: Access to XMLHttpRequest at 'https://backstage.taboola.com/backstage/api/1.0/###########-altium-sc1/reports/top-campaign-content/dimensions/item_breakdown?start_date=1900-01-01&end_date=2020-02-17&campaign=###########' from origin 'https://###############.com' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource.
Posted by Brendan Malone about a year ago
Hi, I am having troubles getting right responses from API. I get '502 Bad Gateway' as response when I try to get some of the reports. It's been couple of months since I started getting some reports using API everyday and I came across this problem for the first time yesterday(2/11). ``` "<html> <head><title>502 Bad Gateway</title></head> <body bgcolor="white"> <center><h1>502 Bad Gateway</h1></center> <hr><center>nginx</center> </body> </html> " ``` Here is the request. （ {XXX} is for security reasons. ） ``` https://backstage.taboola.com/backstage/api/1.0/{campaign_id}/reports/top-campaign-content/dimensions/item_breakdown?start_date=2020-02-04&end_date=2020-02-04&campaign={id} ``` Could you help me out solve this issue? Thank you in advance.
Posted by kamei about a year ago
When obtaining a campaign list or specific campaign ID, I get zero responses, or a forbidden error: - https://backstage.taboola.com/backstage/api/1.0/users/current/account gives me the account id - https://backstage.taboola.com/backstage/<ACCOUNT_ID>/campaigns/ gives me zero responses - https://backstage.taboola.com/backstage/<ACCOUNT_ID>/campaigns/<CAMPAIGN_ID/ gives me 403 forbidden. Where do I go now?
Posted by Karel about a year ago
I'm looking to download settings for all campaign items, and it seems like the only documented way is to iterate through each campaign and download item settings. This means we'd need an HTTP request per campaign. Do you happen to know if there's an endpoint for getting ALL campaign item settings, at the account level?
Posted by Tyler about a year ago
hi ! im using reporting campaign-summary for a while now but i have been facing an issue in the last couple of days when i run the report for the endpoint : https://backstage.taboola.com/backstage/api/1.0/<account_name>/reports/campaign-summary/dimensions/campaign_day_breakdown?start_date=2020-01-29&end_date=2020-01-29 i get a list of all campaigns including paused which sums up to a lot of campaigns do i need to delete all paused campaigns for the not to show up in the reporting ? or is there another parameter so that the paused campaigns will not show up in the reporting ?
Posted by shani shamilovich about a year ago
Hello again, For reporting purposes I am attempting to generate a map from site -> site_id for all of the publishers which are sending us impressions. I am attempting to use the API endpoint documented here to generate that map: https://backstage-api.readme.io/reference#list-of-publishers I queried for the `taboola-network` admin network, but received records for only 80% of the publishers which are sending us impressions. As noted in the docs, I contacted our account manager to see what other admin networks are relevant to our accounts, but he said that `taboola-network` should be the extent of it. How can I look up the remaining publishers? `newsuk-thesun` is a notable missing value. Thanks! Cleve
Posted by Cleve Pasarell about a year ago
I'm not sure why, but it appears that it takes two requests to update the status on a campaign item. Here's an example of the first response: {'id': '225041018', 'campaign_id': '2258352', 'status': 'RUNNING', 'policy_review': {'reject_reason': None}, 'is_active': True, 'thumbnail_url': 'https://media.workandmoney.com/96/56/9656faa856ba4ccbb80632b03aa83c23.jpg', 'title': 'Who Are the Best Liverpool Players of All Time?', 'approval_state': 'APPROVED', 'type': 'ITEM', 'url': 'https://www.stadiumtalk.com/s/greatest-liverpool-football-club-all-time-2910538a984a4f5e'} Then the same exact request seconds later: {'url': 'https://www.stadiumtalk.com/s/greatest-liverpool-football-club-all-time-2910538a984a4f5e', 'thumbnail_url': 'https://media.workandmoney.com/96/56/9656faa856ba4ccbb80632b03aa83c23.jpg', 'campaign_id': '2258352', 'id': '225041018', 'status': 'PAUSED', 'title': 'Who Are the Best Liverpool Players of All Time?', 'approval_state': 'APPROVED', 'policy_review': {'reject_reason': None}, 'type': 'ITEM', 'is_active': False} Any help would be greatly appreciated. Thank you.
Posted by Tyler about a year ago
Hi there, 2 questions related to the API: 1. Are there any formal API rate limits? We have not bumped into any limits, but are about to ramp up our ingest of performance data and want to make sure we are good citizens. 2. I have found API docs for the campaign-level blacklisting (https://backstage-api.readme.io/reference#patching-targeted-publishers) but no docs for an account-level blacklist. However, in the backstage UI if I go to Campaign Summary -> By Site, there does appear to be the ability to manually blacklist sites for my account. Is there a way to ingest or update this list via the API? Thanks! Cleve
Posted by Cleve Pasarell 2 years ago