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 trying to block publishers via campaign update. for some reason I get: Invalid publisher_targeting.value I've exported the names of the publishers via https://backstage.taboola.com/backstage/api/1.0/account_id/allowed-publishers/ I used the exact name as written in the response but I still get: Invalid publisher_targeting.value I tried many variations for instance for this publisher - Gannett - USA today I've tried: gannett-usatoday gannett - usa today Gannett - USA Today publisher id - 1168 please let me know what could be the problem. Thanks, Amir.
Posted by Amir Gat 5 days ago
Good Afternoon, Is it possible (as an advertiser) to get the URL for the publishers? Using the Get All Allowed Publishers end-point (https://backstage.taboola.com/backstage/api/1.0/account_id/allowed-publishers/) I can get the ids and names but in the UI there is a small icon to the right of each publisher's name that links to the publisher which I need to replicate within our system. Thanks, Robert
Posted by Robert Humphries 5 days ago
Hello team, I did not receive any client credentials (client id and secret) for the backstage api. I have tried to mail the support but there's no reply for a week. Can you please help me? I also have a taboola account. This is our Reference ID #: ref:_00Dd0eHCX._5003o1SDUgq:ref Thanks, Ritwik B
Posted by Ritwik Bandgar 13 days ago
Hello, As stated in the topic, I am trying to get the access token that will allow me to manipulate the Backstage API but when trying the Password Credentials flow I am receiving the error "False". Here is the function to fetch the token: const credentials = { this is where my credentials are registered } function fetchTaboolaAccessToken() { const options = {}; options.method = 'post'; options.headers = { 'Content-Type': '"application/x-www-form-urlencoded"' }; options.body = { client_id: credentials.client_id, client_secret: credentials.client_secret, username: credentials.username, password: credentials.password, grant_type: 'password' }; const result = fetchUrl('https://backstage.taboola.com/backstage/oauth/token', options) console.log("Result", result); } Can someone tell me what is wrong in my function for this error to be logged ?
Posted by Alexandre Macrel 18 days ago
Hello, how can I get utm data from "/backstage/api/1.0/aitargetpikgroup-sc/reports/campaign-summary/dimensions/day" report? I know how to get data from "/backstage/api/1.0/aitargetpikgroup-sc/campaigns/", but I need organise day-partitioned tables.
Posted by Andrey 19 days ago
Hi team, I recently created an account on Taboola with Backstage access, however I haven't received the necessary client_credentials (client_id, client_secret) required to use the API. I tried contacting the support team but its been a couple of weeks of radio silence. Any help would be appreciated..
Posted by Gokul Chandrasekaran 25 days ago
We are requesting reporting data using the by_hour_of_day dimension. Each start of the hour. And we found out that the values for that same hour are changing from while to while. Can you please tell us, when is the best time to request actual reporting data for the hour that passed. Thanks in advance
Posted by Natalia Smirova 28 days ago
Has anyone tried this and can provide information and recommendations? Which R package did you use? How did you go about it? I tried the httr package and used the code below: url = 'https://ads.taboola.com//backstage/api/1.0/[account_id]/campaigns/' r <- GET(url = 'https://ads.taboola.com//backstage/oauth/token', config = list(username, password, type = "basic"))) data <- r$content The account ID was not alphabetical, it was numerical. and the username and password are for the ad campaigns account. I did not get any media fields, even though the response showed 200 - which confirmed some sort of connection was made.
Posted by Senan Mele about a month ago
I have a question when the active Taboola ads stats (clicks, impressions and spend) become stable and final. Each day we are downloading Top Campaign Content API reports for today, yesterday, day before yesterday etc. All stats older that 4 days are cached and considered to be final. But for some campaigns it seems not to be enough and we still see some small discrepancies compared to the latest Taboola dashboard UI result. Updating the old cached stats through the API fixes the issue. Am I wrong the stats to become stable on the 4th day?
Posted by Mike Zub about a month ago
Hi, We are trying accessing our token in order to pull reporting data and recieve the following error: <p>Probelm accessing / authentication/oauth/token. Reason: <pre> Full authentication is required to acecess this resource </pre> We've used Client id & Client secret, password and username and made the request with all the nessacery data. Could you please assist? Thanks, Yuval
Posted by Yuval Goldenberg about a month ago
Hi, Is it possible to block publishers via the API using the numeric site IDs or by using the exact site name as they appear in the platform UI? Example here: https://prnt.sc/10tjolm
Posted by Kunal about a month ago
I'm currently researching the possibility of integrating Taboola Backstage, so that when changes happen in our account, we get some kind of event send to our internal Campaign Management system. To that end I want to ask if you have (or at least plan to have) any of the following: 1) Webhooks that fire when Campaigns and Items are created/updated with info on what changed 2) Some kind of account change event history that can be accessed from the API and provides the same info as the above 3) Fields with the time of the Campaign's or Item's creation/last update, preferably one you can filter on through the API 4) A way to all fetch Items in an account without having to make a separate API request for every Campaign. The UI has a screen like this, but the API seems to have no equivalent endpoint 5) Some kind of Sandbox environment or a testing account, where we can experiment with creating mock Campaigns without risking them being seen by our customers or getting charged/banned for it Thanks
Posted by Filip Filipov about a month ago
I am trying to block a publisher within a single company via a POST request to a URL: https://backstage.taboola.com/backstage/api/1.0/account-id/campaigns/campaign-id Request body: { "publisher_targeting": { "type": "EXCLUDE", "value": [ "my-publisher" ], "href": null } } Next, I go to the control panel, where all the publishers of the campaign are located. Here I can see that the publishers I specified in the request body specified above are not blocked after the POST request is executed. What could be the problem? Perhaps there is a delay in the web interface until the actual data appears?
Posted by Danil Makogon about a month 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 about a month ago
Hi there, we would like to integrate the Publisher Revenue Reporting API and have a few questions around limitations. Currently, the endpoint only supports a daily breakout. 1. Is there any non-documented feature that would allow hourly? The docs only show the option of UTM CAMPAIGN and UTM SOURCE + MEDIUM. 2. Is there any other option to get more granular data e.g. UTM CAMPAIGN + SOURCE + MEDIUM (ideally also TERM and CONTENT)? There is a Custom Key/Value report. With the account in use, these are always undefined. We couldn't find any documentation on how to set them and what the limits are. 3. Can you point us in the right direction?
Posted by Nils about a month ago
If we have created custom conversions - is it possible to get statistics for them in reporting data by hour? For example, we've crated custom conversion 'specific' and we want to know how many 'specific' conversions we had for the last hour. From where should we take that data?
Posted by Natalia Smirova 2 months ago
Hello! I getting `campaign-summary` report using `campaign_site_day_breakdown`: https://backstage.taboola.com/backstage/api/1.0/<account_id>/reports/campaign-summary/dimensions/campaign_site_day_breakdown?start_date=2021-02-24&end_date=2021-02-24 API response is: { // omitted... "results": [ { "date": "2021-02-24 00:00:00.0", "site": "site-string-id", "site_name": "Site pretty name", "site_id": 1053067 // omitted... "site_url" field is not provided } } but there is no property containing `site_url`. How can I get it?
Posted by Skorokhodov Egor 2 months ago