Welcome to Taboola's Backstage API hub. You'll find comprehensive guides and documentation to help you start working with the Backstage API as quickly as possible, as well as support if you get stuck. Let's jump right in!
I couldn't find how to create a network-level conversion in the documentation. Is there anyway to implement that? I only found account-level conversion creation here: https://developers.taboola.com/backstage-api/reference#create-a-conversion-rule Thanks
Posted by Kais Salha 3 days ago
Hi there, Can you share how up to date are the campaigns settings (budget, cpc, status) in the API? If I were to make changes at 2pm and try to pull this information at 2:05pm, am I going to get the correct information? Thanks, Sandra
Posted by Sandra 4 days ago
Hi, is there any delay in reporting through API for clicks / spend that took place ? For example, if there's click / spend event that takes place now, how soon is this information available for the reporting API ? Thanks
Posted by Jack Qian 5 days ago
Hi i am making this API call: https://backstage.taboola.com/backstage/api/1.0/1219366/reports/campaign-summary/dimensions/campaign_site_day_breakdown?start_date=2020-05-21&end_date=2020-05-21 and getting this answer back: Array ( [http_status] => 400 [message] => Unknown publisher ) can anyone explain why am i getting this and what am i doing wrong?
Posted by dotan guy 5 days ago
Hey, Is there an option to choose a different provider (advertiser) when using a "duplicate campaign API"? For example, if I have "demo-advertiser" (that contains campaign 123) and "another-advertiser", can I do something like: curl --request POST \ --url https://backstage.taboola.com/backstage/api/1.0/demo-advertiser/campaigns/123/duplicate \ --header 'content-type: application/json' \ --data '{"name":"Copy to another", "advertiser": "another-advertiser"}' Thanks!
Posted by Sasha 5 days ago
Hi, is campaign reporting (through API) available at the item / thumbnail level? I created items / thumbnails, each with title and URL in the Campaign Inventory. Is there any way to pull campaign reporting at such item / thumbnail level, through the reporting API ? Thanks
Posted by Jack Qian 9 days ago
## H3 Looks like something went wrong! **Our server reports an error occurring while preparing this page. Please try again later once we have solved the problem.** --- Every time [duplicate API](https://developers.taboola.com/backstage-api/reference#duplicate-a-campaign) is executed, 200 OK status with above error msg is received in HTML. Is this API ready to be used or is the sample call (below) constructed incorrectly? https://backstage.taboola.com/backstage/api/1.0/`{{account id}}`/campaigns/`{{campaign id}}`/duplicate with JSON body: `{"name":"duplicate-or-clone-this-campaign"}`
Posted by Melody Song 10 days ago
Hi, We are requesting for this report (reports/campaign-summary/dimensions/campaign_breakdown) several times a day. We request it for 2 time periods: - 1 day - 365 days (to get campaign lifetime spend) I suspect that sometimes, depending on how long it took to respond, the response is not full. It happens randomly when we try to parse the response to json and it fails: `ValueError: Unterminated string starting at: line 1 column 25130053 (char 25130052)` `ValueError: Unterminated string starting at: line 1 column 44233078 (char 44233077)` This suggests the response is incomplete. And indeed, catching the response itself when this happens shows HTTP200 but the response itself is not complete: "..."conversions_value":0.00,"roas":0.00,"ctr":0E-18,"vctr":0E-18,"cpm":0.00,"vcpm":0.00,"cpc":0.00,"campaigns_num":1,"cpa":0.00,"cpa_actions_nu" I do not think this is a timeout from our end as we wait for 360 seconds and the error happens much sooner than that. So I suspect your server cut the response if it happens to take to long, and then I get a partial response. Please advise on how to get this solved... Perhaps there is a way to cut the report to chunks (paged report) or perhaps selecting which dimensions will be returned? (i only want the spend in this case). example request that just failed: GET 'https://backstage.taboola.com/backstage/api/1.0/samyonetwork/reports/campaign-summary/dimensions/campaign_breakdown?start_date=2019-05-27&end_date=2020-05-26' response headers: {'X-Timer': 'S1590508558.250668,VS0,VE5509', 'X-XSS-Protection': '1; mode=block', 'X-Cache': 'MISS', 'X-Content-Type-Options': 'nosniff, nosniff', 'transfer-encoding': 'chunked', 'Accept-Ranges': 'bytes', 'Expires': '0', 'Vary': 'Accept-Encoding', 'X-Served-By': 'cache-bwi5053-BWI', 'Server': 'nginx', 'Connection': 'keep-alive', 'Via': '1.1 varnish', 'X-Cache-Hits': '0', 'Pragma': 'no-cache', 'Cache-Control': 'no-cache, no-store, max-age=0, must-revalidate', 'Date': 'Tue, 26 May 2020 15:56:03 GMT', 'P3P': 'policyref="http://trc.taboola.com/p3p.xml", CP="NOI DSP COR LAW NID CURa ADMa DEVa PSAa PSDa OUR BUS IND UNI COM NAV INT DEM"', 'Content-Type': 'application/json;charset=utf-8', 'X-Frame-Options': 'DENY'}
Posted by Or 11 days ago
Hi! Yesterday starting from 7PM GMT+1 we faced API authorization problems. We work with Ubuntu 16.04, which is located on Amazon. The problem is when we try to get the token we get the "401" response. Sreenshot: https://prnt.sc/snzqlc The authorization code is absolutely the same on the working PC, and everything works correctly. Screenshot: https://prnt.sc/snzskf Also, everything works correctly via Postman. Screenshot: https://prnt.sc/snztko Please help us find and solve the problem.
Posted by Ivan Borokh 11 days ago
Hey team, I am looking for a way to get hourly data (specifically spend, clicks) in an hourly resolution with the ability to get the data by campaign. So either: a. By campaign breakdown with an hourly resolution. b. Hourly data with the ability to filter by campaign. Are any of these possible ? Thanks ! p.s. Option b. is possible via your dashboard so I'm sure the data is there but not sure how to access it programmatically.
Posted by Shai 12 days ago
I see it in the retired documntation on github https://github.com/taboola/Backstage-API/blob/master/Backstage%20API%20-%20Users.pdf but it's not documented here, is it deprecated?
Posted by Abdallah AlHalees 14 days ago
Hello! I would like you to confirm if the dimension placement_breakdown in Revenue Summary reports still working. When i make the request returns Error Code 500. Can you assist me? Thanks in advance! Foteini
Posted by Foteni P 15 days ago
Hi Peter, I'm receiving this error: {"http_status":400,"message":"You can not target\/block more than 1,500 sites.","offending_field":""} I know the limit is 1500 per campaign and 1500 per account limit. We have blocked 1121 blocked on the account level and 463 at the campaign level. But I don't understand why we cannot block anymore at the campaign level as I can see that we blocked only 463. There are some cases where we request to block some publisher_id and I can't see it in the blocked list even if I received the OK message. Campaign id: 4667401 https://www.screencast.com/t/rpQvZ4Vdm Our account is: "[email protected]" Thank you!
Posted by alexandru ciocan 15 days ago
We are trying to load marketplace audiences performance (user segments) data via API. We noticed that some campaigns, even they are running and buying in selected period does not return any data. EXAMPLE campaign name ygs-d-us-r-msn-p3-200407-hg-tb-d5-a1 We also tried if there is breakdown by marketplace audiences in taboola UI for this campaigns - no luick Which campaigns with spend data will not have marketplace performance data?
Posted by Moran shwartz 16 days ago
Hello, We are not able to set custom audiences using API Everything was working fine ~14 hours ago but on some point custom audience ids changed and updating custom audience fails. After checking the current values I noticed (for example) https://backstage.taboola.com/backstage/api/1.0/giveitlove-sc/campaigns/4594930/targeting/my_audiences The value in "collection" array used to appear as string "226875" and now its a number 1642268. The new id is not in a dictionary we are getting from /universal_pixel/custom_audience_rule This change is permanent and if so where we can get new ids? Thanks Michael
Posted by Misha Makarevsky 17 days ago
When we try to pull a campaignItem we get a ‘Resource not found’ error, although the item is actually existing and visible through the Taboola UI. This is preventing us to update the campaignItem with imageUrl and headline. As an example: https://backstage.taboola.com/backstage/api/1.0/inpowered-sc/campaigns/4636610/items/2900178486 Can you please help to understand why this is happening?
Posted by Filippo Portolano 19 days ago