Welcome to the Taboola Backstage API documentation. You'll find comprehensive guides and examples to help you get started with Taboola Backstage API quickly.
When duplicating a campaign from an account A to account B after 6pm EST fails with "Start Date cannot be set in the past" error. The POST endpoint with JSON body is attached below : ------------------------------------------------------------------ https://backstage.taboola.com/backstage/api/1.0/{account_A}/campaigns/{campaignId}/duplicate?destination_account={account_B} {'tracking_code': 'parameter=1234', 'branding_text': 'Search', 'spending_limit': 40, 'name': 'this_is_the_campaign_name', 'daily_cap': 20, 'platform_targeting': {'type': 'INCLUDE', 'value': ['DESK']}, 'cpc': 0.5, 'country_targeting': {'type': 'INCLUDE', 'value': ['US']}, 'spending_limit_model': 'MONTHLY', 'marketing_objective': 'DRIVE_WEBSITE_TRAFFIC'} ------------------------------------------------------------------ Any recommendation on how to be able to duplicate without start date error?
Posted by Melody Song 3 days 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 5 days ago
Hi there, where/how can we add the redirect URIs to the whitelist? The account manager asked us to ask you here. Also is it possible to get credentials that are not tied to an advertiser, so that we can properly utilize the code authorization flow? Thank you.
Posted by Nils 17 days ago
Hello, My name is Moosa Nayeem. I work for TapClick's on the data integration team. I am reaching out regarding an issue reported by one of our mutual clients Recrue Media. The client has provided a set of creds which they have mentioned are valid credentials confirmed by Taboola. However, we see the API call failing for those credentials. API Response: RESPONSE:* error":"invalid_client","error_description":"Bad client credentials"} Thoughts?
Posted by Moosa Nayeem Mohammed 25 days ago
Are special characters scrubbed if passed into the placement variable? One of the string we pass into the placement variable contains ! in it. The reporting api endpoint passes that string back without !. Are there are characters that are scrubbed out? If so, why?
Posted by Carmen Ruder about a month ago
Hello all. I have requested via email, several times, access to the API but no one is responding to me. Does anyone know a method I could use in order to get my client_id and client_secret so I can gain access to the API? Thanks in advance.
Posted by Chris about a month ago
Hello. A cording to docs hours are in 0-24 range, inclusive, 'from' must be smaller then 'to'. Its bit confusing: 0-0 does not work, so if 0-1 means 'first hour of the day' then 'to' is not inclusive. 0-24 does not work (25 hours if 'to' is inclusive) 0-23 works and so does 1-24 - both means 'whole day' because its 24 hours? Then, if I set 1-23. is 23 hours (not including the first hour of the day)? I think few examples can help because we can't have both hour 0 and hour 24 - at least not on this planet :) Thanks Misha
Posted by Misha Makarevsky about a month ago
Our revenue data are provided on UTC timezone. To perform our analysis with our Taboola expenses we use the by_hour_of_day dimension to get expenses from day <d-1> 7pm to day <d> 6pm (Taboola uses ET timezone), details: 1/ To get expenses by campaign for day <d> "UTC", 2 requests: /reports/campaign-summary/dimensions/by_hour_of_day?campaign=<idCampaign>&start_date=<d>&end_date=<d> (we keep datas from 12am to 6pm) /reports/campaign-summary/dimensions/by_hour_of_day?campaign=<idCampaign>&start_date=<d-1>&end_date=<d-1> (we keep data from 7pm to 12am) 2/ To get expenses by site for day <d> "UTC": 2.a/ we get all idsite for day <d-1> and <d>: /reports/campaign-summary/dimensions/site_breakdown?campaign=<idCampaign>&start_date=<d>&end_date=<d> /reports/campaign-summary/dimensions/site_breakdown?campaign=<idCampaign>&start_date=<d-1>&end_date=<d-1> 2.b/ for each idsite: /reports/campaign-summary/dimensions/by_hour_of_day?site=<site_name>&campaign=<idCampaign>&start_date=<d>&end_date=<d> (we keep datas from 12am to 6pm) /reports/campaign-summary/dimensions/by_hour_of_day?site=<site_name>&campaign=<idCampaign>&start_date=<d-1>&end_date=<d-1> (we keep data from 7pm to 12am) -- But it doesn't work as expected, the total of expenses for an "UTC day" is far (always less) from our estimations (based on an average for few days). What is wrong? Thank you!
Posted by Peter about a month ago
Hi, According to the Backstage API doc, there are only a number of available preset dimensions to pull a Campaign Summary Report. I am currently using 'campaign_site_day_breakdown'. I'm trying to get reporting data down to the creative/item level but none of them go down to that level. Is it possible to pull a report down to a creative/item level? Thanks, Ed
Posted by Edward Tan about a month ago
Dear support, I would love your assistance, I feel like I am missing something basic We have just started working on an integration with the backstage API. To authorize we use the 'Client Credentials' flow, with client_id and client_secret, and recieve an access_token. When making any requests with the access_token, e.g. '/users/current/account' the response is a 200 o.k. with a login page, instead of the actual JSON data we want. Thanks in advance
Posted by Sapir Malka 2 months ago
I'm updating the tracking_code for a campaign and noticed I'm able to update the campaign item url too for tracking. After reading the documentation I found this: Use each parameter only once, and only to apply them at either the campaign or item level - not both. URL parameters cannot be added at both the individual URL level AND campaign level, it will cause the data to be incorrect in your analytics platform. (For example, you cannot have "utm_source=Taboola" added at the campaign level and "utm_source=cpc" appended to a URL in the campaign.) So question here is if on the campaign level I have utm_source=Taboola, am I able to add ?utm_source=Taboola on the campaign item level too?
Posted by Chelsea 2 months ago
Hi Guys, We are using a Rule tool (through the API) and it seems that it's having difficulties to exclude sites from campaigns that have a total exclusion of 1,500 sites from both account + campaign level. we do manage to exclude manually, however, the API getting an error. after discussing our Taboola AM, we understnad that we are limited with 1,500 (from the campaign level) + 1,500 (from the account level). For example, on the below campaign we didn't reach our limitation and our API tool is getting error when it try to exclude any other site: Campaign ID: 6436943 Campaign Name: Taboola_Bras_Mob_US_144181212_iOS_RON_TN Blocked on Account Level: 1255 Blocked for this Campaign: 563 any suggestion what could be the problem when we are trying to exclude through API?
Posted by Nissim Duek 2 months ago
Hi, I'm having this message : {"http_status":400,"message":"You can not target/block more than 1,500 sites.","offending_field":"","message_code":"campaign.blockedPublishers.error.server.limitReached"} Is there any way to increase this limit?
Posted by Melanie Macias 2 months ago