Taboola Backstage API

Taboola Backstage API

Welcome to the Taboola Backstage API documentation. You'll find comprehensive guides and examples to help you get started with Taboola Backstage API quickly.

Get Started    
Ask A Question



"top_campaign_content_report" API returning NULL for certain items

We are receiving a null value for 'item' in the "top_campaign_content_report" table. We have made the primary key for the table "top_campaign_content_report", which is a hash value of item, date, item_name, campaign_id fields. Sometimes, we get a null value for the item field in the response, for eg: curl -H 'Authorization: Bearer XXX' -A 'Jesey/2.25.1' '' | jq Returns: { "item": null, "item_name": "xxxxxxxxx", "thumbnail_url": "xxxxxxx", "url": "xxxxxxxx", "campaign": "898661", "campaign_name": "xxxxxxxx", "content_provider": "1121684", "content_provider_name": "xxxxxxxx", "impressions": 1371, "visible_impressions": 376, "ctr": 0.15, "vctr": 0.53, "clicks": 2, "cpc": 0.108, "cvr": 50.00, "cvr_clicks": 50.00, "cvr_views": 0.00, "cpa": 0.22, "cpa_clicks": 0.22, "cpa_views": 0.00, "actions": 1, "actions_num_from_clicks": 1, "actions_num_from_views": 0, "cpm": 0.16, "vcpm": 0.57, "spent": 0.22, "conversions_value": 0.00, "roas": 0.00, "currency": "USD" }, The same request executed on a different date sometimes returns a valid 'item' and the hash value will get changed and this causes us to add duplicate records while upserting the data. We do not expect to be getting a null value because the item value is the same as id in the "campaign_item" table, and we do not see any null id value in the campaign_item table. After more discovery, we found that these values are being returned as 'null' because that item has been deleted from the campaign history. Can everything be paused instead of deleted to try overcome this data integrity issue?

Posted by Sean about a year ago


Duplicate campaigns to different advertiser (within the same account)

Hello, In taboola UI: When we select "network" in advertiser selection in top right corner and then duplicate campaign (by click the last icon in campaign management) we have option to select advertiser on the next screen (its called provider). However if we select specific advertiser we can duplicate only to the same advertiser - "provider" selection is grayed out. We try to use the first behavior via API, duplicate campaign to different advertiser. This is attempt to duplicate to different advertiser from network level as its done in UI: RES { "http_status": 404, "message": "Resource not found" } This is attempt to duplicate to different advertiser (we not expected this will work as its not working in taboola UI) BODY: { "advertiser_id": "bleacherbreaker-m-sc", "name": "wuz-d-uk-c-0-p3-200623-bb-tb-0--dev" } RES { "http_status": 400, "message": "Trying to modify a read-only field", "offending_field": "advertiser_id" } Without passing "advertiser_id" duplication works fine. Can we somehow duplicate to different advertiser_id from API as its done from taboola UI? This can help us to avoid manual operations/error and reduce usage of taboola UI. Thanks, Misha


Posted by Misha Makarevsky 8 months ago