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 there, Is there a script available that I can use within Google Sheets to import campaign data such as costs on an hourly/daily basis from my Taboola Ad account? If so I'd be very grateful if someone could share this with me :)
Posted by Matt Seldon 17 days ago
We are working on the feature to allow uploading video creatives through our campaign creation feature and some questions: 1. Do you have integration to get videos from Getty images (or other provider) - just like you have with image creatives? 2. For the default images which accompany the video - can we get these from Getty images? I'm asking since you have a unique flow on how these getty images can be used so I'm trying to understand if it's possible to use it as the default images for the video item. 3. Can we upload more than one video at a time? 4. What about variations as we do with image creatives where we create combinations between all the images and the titles which are selected, is it possible to do with videos?
Posted by Lior about a month ago
Hello Is there an option to create and update an Audience via the API? We have built audiences by uploading a list of email addresses manually before but we are looking to do this via API and updating everyday. I have looked in the documentation but cannot find the answer I am looking for. Can you point me to the documentation for this so I can send to our developers? Thanks
Posted by Ivan Mak 2 months ago
Hello, we are getting this error when trying to block some site via API. The problem is that these sites do belong to the campaign and are also currently getting traffic. There are multiple examples but below I'm sending just one: Campaign id: 9761652 Sites we're trying to block: nbcsports-probasketballtalk, tegna-wxia
Posted by Ervin 2 months ago
Hello, I'm trying the option of 'is_atomic=false' when bulk update campaigns status to paused. I tried to send 2 ids, fake one and a real one to see if it updates the real ones status and I received 404 error for the entire request. Is the 'is_atomic' option available only for specific errors? How can I test it? Thanks Or
Posted by Or Brand 2 months ago
Hello, I would like to know how to export datas from taboola using your API through Python. Do you have a script wich allows me to extract datas directly from a Jupyter Notebook. There is some informaiton on this site but i'm not a developper, just a data analyst: https://github.com/dolead/pytaboola (Currently I use the export button then I clean and export datas using python with numpy and pandas library but I don't know how to directly export data from a notebook using your API) Thank you in advance, Charles Martinaud
Posted by Charles Martinaud 5 months ago
We are trying to get information about the sum of budget spent for 1 day, but we can see only total amount spent for the whole campaign time. Spending limit is set as "monthly". Is it possible to get daily budget spent without changing spending limit type? Update: we are asking about using the "get all campaigns" request, but we know that the spent is shown also in the reporting data. Just because we're trying to use as less as possible requests at once.
Posted by Natalia Smirova 7 months ago
Hi I am starting to work with the api. After fetching the access token I am trying to get all campaigns (as listed here https://developers.taboola.com/backstage-api/reference#fetching-campaigns) but I am getting an empty array result. Please advise.
Posted by David Baruch 8 months ago
We are looking to create campaigns via the API and have run into an issue with the API documentation. https://developers.taboola.com/backstage-api/reference#create-a-campaign We would like to be able to set the advertiser ID for the campaign during the creation process, but there appears to be no field listed for it. The call would be to https://backstage.taboola.com/backstage/api/1.0/account_id/campaigns/ but I suspect we have to use our main account ID in that URL. then later provide the advertiser ID that lives within our account? It would be awesome if the documentation could be updated at some point to mention things like this, as there are a lot of blind spots in what it covers. Under "Campaign Fields" there is advertiser_id but it is listed as read-only. Also, is there an API call that will return all advertiser IDs for an account? Thanks! /Chris
Posted by Chris Ellerby 9 months ago
Hello, I'd like to know how to obtein via the plateforme, the id audience taht API need in collection for targeting. The id audience in the plateform is not the same apparently.
Posted by MΓ©lanie Macias about a year ago
Hey, When I Fetch campaigns I get the results as an empty array, but when I run the summary report I get the report as it should be with campaigns. The Request: https://backstage.taboola.com/backstage/api/1.0/account_id/campaigns/
Posted by Guy Horowitz about a year ago
μλ νμΈμ. νλΈλΌ APIλ₯Ό μ΄μ©ν΄μ κ°μ μ‘°ννλ €κ³ ν©λλ€. client_id + client_secret λ₯Ό μ΄μ©νμ¬ "access_token" μ μ±κ³΅νμ΅λλ€. access_token μ μ΄μ©νμ¬ "account_id" λ μ±κ³΅νμ΅λλ€. κ·Έλ¬λ "Get All Campaigns" μ μ€ν¨νμ΅λλ€. "https://backstage.taboola.com/backstage/api/1.0/{{account_id}}/campaigns/?fetch_level=R" λ‘ νΈμΆνμ΅λλ€. κ²°κ³Όλ "200"μΌλ‘ μ±κ³΅νμ΅λλ€. κ·Έλ¬λ "total:0, count:0"μΌλ‘ 리μ€νΈλ₯Ό μ‘°ννμ§ λͺ»νμ΅λλ€. λμμ΄ νμν©λλ€. λμμ λΆνλ립λλ€.
Posted by Seok about a year ago
Quite similar to this issue: https://developers.taboola.com/backstage-api/discuss/5ee15745fdb1010136aa891c Sending a GET request to "/backstage/api/1.0/{{account_id}}/campaigns" with relevant account_id and bearer token in the Authorization header returns an empty list. account_id passed is returned in "/backstage/api/1.0/users/current/allowed-accounts" so no issues there. Account also has at least one campaign which passes "minimum CPC" enforcement as verified from the Taboola Backstage UI. Link to private Google doc: https://docs.google.com/document/d/1C2uRE0js0dNxjae64YB611J7pL1yMUnWhNM0gFZIB54/edit?usp=sharing Link to Backstage UI: https://backstage.taboola.com/backstage/1169136/reports/campaigns/campaign-summary#%7B%22id%22%3A%22xdp2a6m7h29%22%2C%22groupId%22%3A%22campaigns%22%2C%22reportId%22%3A%22campaign-summary%22%2C%22dateRangeSelector%22%3A%7B%22id%22%3A%223%22%2C%22term%22%3A%22last%207%20day%22%2C%22range%22%3A6%2C%22dateStart%22%3A%222020-07-10%22%2C%22dateEnd%22%3A%222020-07-16%22%7D%2C%22queryFilter%22%3A%5B%7B%22id%22%3A%22campaign_param%22%2C%22operator%22%3A%22equal%22%2C%22value%22%3A%22-1%22%7D%2C%7B%22id%22%3A%22top_results%22%2C%22operator%22%3A%22equal%22%2C%22value%22%3A%22100%22%7D%5D%2C%22currentDimension%22%3A%7B%22tab%22%3A%22tab-campaign_breakdown%22%2C%22pages%22%3A%5B%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fday%22%2C%22table%22%3A%7B%22key%22%3A%22date%22%2C%22order%22%3A%22desc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%2200001000000100%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fweek%22%2C%22table%22%3A%7B%22key%22%3A%22date%22%2C%22order%22%3A%22desc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%2200001000000100%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fmonth%22%2C%22table%22%3A%7B%22key%22%3A%22date%22%2C%22order%22%3A%22desc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%2200001000000100%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fby_day_of_week%22%2C%22table%22%3A%7B%22key%22%3A%22dow%22%2C%22order%22%3A%22asc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%2200000000000100%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fby_hour_of_day%22%2C%22table%22%3A%7B%22key%22%3A%22hour_of_day%22%2C%22order%22%3A%22asc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%2200000000000100%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fcontent_provider_breakdown%22%2C%22table%22%3A%7B%22key%22%3A%22spent%22%2C%22order%22%3A%22desc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%2200000000000100%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fcampaign_breakdown%22%2C%22table%22%3A%7B%22key%22%3A%22spent%22%2C%22order%22%3A%22desc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%2200000000000100%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fsite_breakdown%22%2C%22table%22%3A%7B%22key%22%3A%22spent%22%2C%22order%22%3A%22desc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%2200000000000100%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fcountry_breakdown%22%2C%22table%22%3A%7B%22key%22%3A%22spent%22%2C%22order%22%3A%22desc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%2200000000000100%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fregion_breakdown%22%2C%22table%22%3A%7B%22key%22%3A%22spent%22%2C%22order%22%3A%22desc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%2200000000000100%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fdma_breakdown%22%2C%22table%22%3A%7B%22key%22%3A%22spent%22%2C%22order%22%3A%22desc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%22000000000%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fplatform_breakdown%22%2C%22table%22%3A%7B%22key%22%3A%22spent%22%2C%22order%22%3A%22desc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%2200000000000100%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fuser_segment_breakdown%22%2C%22table%22%3A%7B%22key%22%3A%22%22%2C%22order%22%3A%22asc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%220000000000010%22%7D%5D%7D%7D
Posted by Rijumone Choudhuri about a year ago
I've been using publisher_bid_modifier for months with no problems. Today, my system is unable to change CPC (site level). Below, the message that my system is receiving due to the cpc_modification sent. I paused all my campaigns. Waiting for a return. cpc_modification | message 0.2 | The bid amount cannot be less than the minimum 0.01 USD 0.4 | The bid amount cannot be less than the minimum 0.025 BRL 1.0 | The bid amount cannot be less than the minimum 1.0 JPY 1.2 | The bid amount cannot be less than the minimum 1.0 JPY
Posted by David about a year ago
Iβm hoping someone can help with a stumbling block Iβm facing with our auth flow. Iβm trying to use the Authorisation Code method outlined in the api docs (https://developers.taboola.com/backstage-api/reference#authorization-code) as follows: This flow is similar to Implicit Grant (above), but involves an additional step: User clicks on Connect within your App. Your App redirects the user to a Taboola login page: [authentication_domain]/authentication/oauth/authorize/?client_id=[client_id]&redirect_uri=[redirect-uri]&response_type=code Note: set authentication_domain = 'https://authentication.taboola.comβ Iβve built the Taboola login url as outlined above using our client id and desired redirect however when I test the URL and subsequent login process there is no redirect back to our app, instead the user is taken to this page within Taboola that asks whether I want to go to backstage or newsroom, both of which keep the user in Taboola. Anyone know why I canβt redirect back out to our app to complete the authors flow?
Posted by Matt about a year ago
Hi there, I'm writing from Blinkist or Blinks Labs GmbH. At the moment, a lot of automation changes that we push through the API are not working. Mainly to do with campaign level CPC changes and publisher bid adjustment. You can find them documented in this file, along with the error messages that we receive. Can you have a lot and tell us what we are doing wrong? Here's a quick summary to help you get into this. 1. We push campaign level CPC changes and the publisher bids for the respective campaigns in one go, so we only get one error message -> message: 'Cpc boost value must be between -99% and 100%'. This doesn't help us understand why the campaign level CPC changes are not happening. 2. For publisher bids, we always send it as a %, either +20%, +10% or -50%. We see instances of failure with each of these changes, which isn't explained by this error message: Cpc boost value must be between -99% and 100%' 3. We do have instances where the campaign level CPC changes are pushed successfully, it is when a campaign does not have publisher bidding changes. We're looking forward to your assistance so we can solve this asap. Sandra
Posted by Sandra Wu about a year ago
We need to have an ability to get hourly statistic for specific campaigns. There is such an ability on the UI (https://i.imgur.com/LSP2LyO.png), but we did`t find a way to get this statistic via the API (https://i.imgur.com/R3rEqZS.png). Please let us know whether we can retrieve hourly statistic for a specific campaign via the API?
Posted by Alex Kolesnykov 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
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