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 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 about a month 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 about a month ago
Dear Team, I was wondering if it is possible to access the fields that hold the campaign settings in the UI under "Schedule > Days and Hours > Specific days and hours via the API (the new interface in testing)?
Posted by Daniel SKultety 4 months ago
Hi, i'm trying to get campaign details so I could make changes to it afterwards. we have several accounts and i'm authenticating with our main one (network, account id: 1308199). for getting campaign I tried to use below request: https://backstage.taboola.com/backstage/api/1.0/account_id/campaigns/_campaign_id/. But I got 404 resource not found. (account id: 1308205, campaign Id: 6085733) I tried to get all campaigns for above account with: https://backstage.taboola.com/backstage/api/1.0/account_id/campaigns. but still got 404 resource not found. (also tried with the network account id and still same 404 error). I believe i'm missing something basic here, can you please check it out? Avi.
Posted by Avi L 5 months ago
This is regarding and endpoint to`DUPLICATE` a campaign - [backstage-api reference](https://developers.taboola.com/backstage-api/reference#duplicate-a-campaign) POST https://backstage.taboola.com/backstage/api/1.0/{advertiser_id}/campaigns/{campaign_id}/duplicate The above is the endpoint I'm using to duplicate a campaign, but attempting to duplicate to a different advertiser_id, I receive 400 BAD REQUEST with the following msg: ``{ "http_status": 400, "message": "Trying to modify a read-only field", "offending_field": "advertiser_id", "message_code": "api.action.bad_request.field_read_only.advertiser_id" }`` Is there a way to duplicate a campaign into a different `advertiser_id` via API? This functionality seems to be available on Taboola dashboard, so any guidance would be appreciated.
Posted by Melody Song 5 months ago
I want to ingest the Safety Rating column for a campaign that is available in the UI. Currently I ingest the campaign reports using the Campaign Summary Report API i.e. https://backstage.taboola.com/backstage/api/1.0/account_id/reports/campaign-summary/dimensions/account_id/campaign_breakdown?start_date={start_date}&end_date={end_date} This api does not give information about the `Safey Rating` per campaign. How can I get this data?
Posted by Annette Kotian 6 months ago
Taboola API is sometimes responding with malformed JSON when hitting endpoint: "https://backstage.taboola.com/backstage/api/1.0/{account_id}/campaigns/". JSON response is getting cut off, and we're not able to decode so it is breaking all of our automation. For example, the last debug response I pulled is ending in the middle of a "publisher_targeting" array. This is the very end of a response we got, where you can clearly see it is not a closed array or object, it just ends: "publisher_targeting":{"type":"EXCLUDE","value":[ ... "mp-metropcs-cashew-appnoticias-es","mp-metropcs-cashew-app" This is a log of the raw JSON response, and as I said it works a % of the time so I don't think it is anything on our end. Are you aware of this issue?
Posted by Mike 6 months 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 6 months 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 7 months 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 7 months ago
Hi, I'm getting this error trying to create a campaign through API: Failed to perform API call with response code [400]. Response payload status [400], message [You have exceeded the maximal number of active campaigns per account]. According to our research on this topic, the maximum is 3000, but so far we have created only 554 campaigns in one of our accounts. Can you please let me know the real threshold.
Posted by Gabriel Diaz 8 months ago
I sent a GET request to "https://backstage.taboola.com/backstage/api/1.0/<account_id>/campaigns/" with my access_token in the header. I get the following response: ``` data: { results: [], metadata: { total: 0, count: 0, static_fields: [], static_total_fields: [] } } ``` From this old github issue (https://github.com/singer-io/tap-taboola/issues/1) I found on the deprecated Backstage API docs (https://github.com/taboola/Backstage-API) says that: ``` Reading, creating or updating Campaigns is only possible when the [account-id] references an Account with ADVERTISER in its partner_types field. Trying to send a request with a non-Advertiser Account will result in a 404 Not Found response. ``` I checked, my<account_id> does not have "ADVERTISER" in its `partner_types`. I did not see any mention of this issue regarding `partner_types` in the current documentation. Could anyone confirm if "ADVERTISER" really is required to access Campaigns? Thank you.
Posted by Andy Shih 8 months ago
Hi there, Can you share how up to date are the campaigns settings (budget, cpc, status) in the API? If I were to make changes at 2pm and try to pull this information at 2:05pm, am I going to get the correct information? Thanks, Sandra
Posted by Sandra 9 months ago