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 Team, Can someone help me with exact url to fetch reports as date and site as dimensions? https://backstage.taboola.com/backstage/api/1.0/XXXXXXX-network/reports/revenue-summary/dimensions/day_site_placement_country_platform_breakdown?start_date=2021-06-01&end_date=2021-06-30 This is working though, But need just date and site, Tried with below variations, But none are working, day_site_breakdown site_day_breakdown day_site
Posted by Prasad about a month ago
Hi, As an advertiser preparing for a test with Taboola, we try transfer the performance data to our BI with Taboola api provided. However, it seems that we can only see the data by country or by campaign in total, rather than the detailed data within each campaign by site/country. For example, if we are targeting more than one countries in one campaign, we would like to be able to analyze the performance of each country separately. Is there any option available for that? Looking forward to your reply soon. Thanks!
Posted by Xi Liu about a month ago
When we pull the Visit Value report via API at endpoint '/reports/visit-value/dimensions/by_campaign' we get one row of data with campaign listed as "(no campaign)". Looking in our reporting interface we have campaigns with names listed for the same timeframe. Is there something separate we need to set up to get our campaigns to be listed in this report via API? Or something else we're missing? Thank you!
Posted by Clay Andrews about a month ago
At the moment we have implemented authentication via "Client Credentials Flow". I cannot find this in the documentation, but what permissions do we have? Could you provide a list of permissions? https://developers.taboola.com/backstage-api/reference#client-credentials-flow
Posted by Vitaly Mashyanov about a month ago
When using this endpoint: https://developers.taboola.com/backstage-api/reference#add-or-remove-users the server is responding with an html document that appears to be a sign in page. There is nothing in the docs and other endpoint work with the same credentials so what am I doing wrong? here is the postman export: "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\r\n \"operation\": \"ADD\",\r\n \"audience_id\": 521159,\r\n \"identities\": [{\"cluster\": [\r\n {\r\n \"user_id\": \"[email protected]\",\r\n \"type\": \"EMAIL_ID\",\r\n \"is_hashed\": false\r\n }\r\n ]}]\r\n}" }, "url": { "raw": "https://backstage.taboola.com/onsemiconductor-sc/audience_onboarding", "protocol": "https", "host": [ "backstage", "taboola", "com" ], "path": [ "onsemiconductor-sc", "audience_onboarding" ] } }
Posted by Craig Douglas about a month ago
Hello all, I have this script to extract my campaign data splited by plateform (see bellow). But now, I want to know how to extract the revenues earn by my publisher. Do you knwo how I can do that ? ___________________________ My Script : client_id =XXXXXXXXXXX client_secret = XXXXXXXXXXXXX start_date = "2021-06-08" end_date = "2021-06-08" account_id = "XXXXXXXX" dimension = "content_provider_breakdown" folder_path = r"/Users//Documents/" url = "https://backstage.taboola.com/backstage/oauth/token" payload = f"client_id={client_id}&client_secret={client_secret}&grant_type=client_credentials" headers = {"Content-Type": "application/x-www-form-urlencoded"} response = requests.request("POST", url, data=payload, headers=headers) data = response.json() access_token = data["access_token"] url = f"https://backstage.taboola.com/backstage/api/1.0/{account_id}/reports/campaign-summary/dimensions/{dimension}" url = f"https://backstage.taboola.com/backstage/api/1.0/{account_id}" querystring = {"start_date":start_date,"end_date":end_date,"platform":"DESK"} bearer = f"Bearer {access_token}" headers = {"Authorization": bearer} response = requests.request("GET", url, headers=headers, params=querystring) data = response.json() _____________________________
Posted by Charles M. about a month ago
Hello all, Just a little question, How can filter in order to have just the campaign on SMARTPHONE or just on DESTKOP ? I tried something with filter but it does not woks :/ Do you know how can I do ? Here is my screenshot https://files.readme.io/7d7a791-Script_Filter_Device.PNG Here is my code : account_id = "reworldmedia-mariefrance2-sc" dimension = "campaign_breakdown" folder_path = r"/Users//Documents/" url = "https://backstage.taboola.com/backstage/oauth/token" payload = f"client_id={client_id}&client_secret={client_secret}&grant_type=client_credentials" headers = {"Content-Type": "application/x-www-form-urlencoded"} response = requests.request("POST", url, data=payload, headers=headers) data = response.json() access_token = data["access_token"] url = f"https://backstage.taboola.com/backstage/api/1.0/{account_id}/reports/campaign-summary/dimensions/{dimension}" querystring = {"start_date":start_date,"end_date":end_date} bearer = f"Bearer {access_token}" headers = {"Authorization": bearer} response = requests.request("GET", url, headers=headers, params=querystring) data = response.json() df = pd.json_normalize(data['results']) df ################################### Thank you in advance,
Posted by Charles Martinaud about a month ago
Hello everyone, I hope you are doing well. My question is why I can't see the data in my Taboola Dashboard immediately or just after launching my campaign. For example, when I launch my campaign and set up everything, after running a campaign and driving traffic to my website I can't see the website ID that sends me traffic so I can block them. Note: I can see the website ID that sends me traffic but after spending my daily budget. Is this normal or not? If not what can I do? Also, I contact Taboola support to open a new ad account but they refuse. In this case, what can I do!
Posted by Yacine Es about a month ago
Good morning everyone, I have two problems and I would like to know if I am doing something wrong. I'm trying to list campaigns in my account and it returns blank data. Using the endpoint https://backstage.taboola.com/backstage/api/1.0/{{account_id}}/campaigns/base I can get the list of campaigns. When detailing a campaign taking the parameter id listed from the campaign above I have the following endpoint: https://backstage.taboola.com/backstage/api/1.0/{{account_id}}/campaigns/10519570, it has the return 404 . Could you help me with what I might be doing wrong? Thank you very much in advance. Att Ycaro Brambila
Posted by Ycaro Brambila about a month ago
We are experiencing problems with the speed of the API. Simple requests are taking lots of time. For example: `path: [our-account]/campaigns/[id] data: {"version":"1.0","headers":{"content-type":"application\/json;charset=UTF-8"},"body":"{\"daily_cap\":20,\"cpc\":\"0.006\"}"} time in ms: 33.827 (33 seconds)` PATCH requests also take 5-10 seconds per request. This number of requests with slow responses seem to have increased over the last few weeks. Are there more people experiencing this issue?
Posted by Eelco 2 months ago
Hi, I make the following call: curl --location --request PATCH 'https://backstage.taboola.com/backstage/api/1.0/{account_id}/campaigns/{campaign_id}/' \ --header 'Authorization: Bearer {token}' \ --header 'Content-Type: application/json' \ --data-raw '{ "patch_operation": "REMOVE", "publisher_targeting": { "publishers": [ "ndtv-newsapp-ios" ] } }' I get the following response: {"http_status":400,"message":"publisher ndtv-newsapp-ios not exists in campaign targeting","offending_field":"publisher_targeting.publishers","message_code":"api.action.bad_request.publisher_targeting.publishers"} is there a way to activate and deactivate publishers that are part of a whitelist campaign via the API? thanks
Posted by aaron 2 months ago
Hi, I am using Voluum as a tracking tool . The API has started to return a response of "PREREQUISITES_NOT_MET". My Taboola account manager revoked and reissued my API key today and we have the same response. Voluum are asking to reach out to you. please can someone help me resolve this issue? thanks
Posted by Aaron 2 months ago
One of our media buyers constantly disables other media buyers campaigns/creatives This usually happens with top spending campaigns/creatives Since multiple people have access to same taboola account we don't know exactly who's it is Please provide IP address from which next action was made: Action: campaign status changed to disabled Time: May 25 ~11AM-12PM EST Account: 1378845 Campaign: 10273258
Posted by Igor Lapshyn 2 months ago