Welcome to the Taboola Backstage API documentation. You'll find comprehensive guides and examples to help you get started with Taboola Backstage API quickly.
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 about 12 hours 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 6 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 9 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 12 days 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 14 days 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 21 days 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 29 days 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 about a month 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 about a month ago
Is there a chance to get data about not just conversions but about qualification conversions (ones on the customer's page) from the API ?
Posted by Natalia Smirova about a month ago
Hello I am having problem with getting specifiec data from the api I am trying to get" Peres Academic Center - SC" data I got the Client ID and Client Secret and i got the token. but in the response i get message: 'Unknown publisher' what could be the problem?
Posted by shahar terem about a month ago