Welcome to the Taboola Backstage API documentation. You'll find comprehensive guides and examples to help you get started with Taboola Backstage API quickly.
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 10 months 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 10 months 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 10 months 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 months 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 months 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 months 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 11 months 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 11 months 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 11 months 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 11 months 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 11 months 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 11 months 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 11 months ago
Hi, Is there any way to get a list of available publishers only? I mean, only the active ones; the blocked and network publishers to be excluded from that API call. https://backstage.taboola.com/backstage/api/1.0/account_id/allowed-publishers/ I want to block any publisher with the word "push" and I can find 2500~ matches. I can't block all of them because of blocking limit of 1500. Thank you!
Posted by Ciocan Alexandru 11 months ago
Hello. I have 2 questions: 1. I want to block some publishers at the campaign level. I tried to PATCH with the action "REMOVE" and I'm receiving the same error for all publishers even if we have data in the last 10 days for that publisher. ERROR: "publisher cnbc does not exist in the campaign’s auto_publisher_targeting" or "{publisher_id} not exists in campaign targeting" Before REMOVING it, I tried to ADD the publisher to that campaign and after that, it worked, I could block it. There is another way or I'm doing it wrong? 2. What is the difference between "publisher_targeting" and "auto_publisher_targeting" for blocking at campaign level?
Posted by Ciocan Alexandru 11 months ago
Hi, I ran API to update "Bid Modifier Per Publisher" to 0.011 and got a successful message, >> string(212) "{"patch_operation":"ADD","publisher_targeting":null,"auto_publisher_targeting":null,"publisher_bid_modifier":{"values":[{"target":"villagenews","cpc_modification":0.011}]},"publisher_bid_strategy_modifiers":null}" But when I check back on Taboola backstage Bid amount for that specific site is not updated. http://prntscr.com/sc3z6l The campaign is in fixed bid setting at .60. Any idea why it fails to be updated? thank you.
Posted by shawn park 11 months ago