Community Discussion

Ask a Question
ANSWERED

Load item performance report, daily

Hey team, hope you are well. We are planning to consume the API to get daily reports for every item of every campaign. https://developers.taboola.com/backstage-api/reference#top-campaign-content-report The strategy would be to set the timeframe between start_date and end_date to 1, and request for each item of every campaign. From what I understood, would be necessary only one request per campaign, and the return would be the top 1000 ads with its performance of that day, correct? Or it would be necessary to run one request for each item inside the campaign? For every connection we create, the requests would be done in sequential, but is possible to create multiple connections to run in parallel. I didn't see any formal rate limits in the documentation To load the historical data, this would require a lot from the API but after it, the daily sync would be more stable. It doesn't seem the API was optimized to this specific use case so i'm a little concerned about the reliability. I didn't see any formal rate limits in the documentation, so i don't know how the API would behave with this use case. I'm sharing it with you to see if we would face any limit or reliability issue that I'm not seeing right now, or if you guys have a better way to structure the requests that could guarantee daily reports for every item of a campaign. Thanks a lot,
ANSWERED

How to get hourly Top Campaign Content Report

Hi, We're trying to get hourly report data for campaign items (similar to getting campaign-summary with dimensions "campaign_hour_breakdown", but for item), but it doesn't seems to work- when i'm trying do api call to "reports/top-campaign-content" with start_date and end_date in the format yyyy-mm-ddThh:mm:ss it looks like the api ignores the hours. If it's not supported, there is a workaround? Thanks in advance Avishay
ANSWERED

Why Do I get an error when posting a new ad (item)?

I'm trying to make a post request in order to submit a new item (ad), but. But when I do so I get a 400 error: http_status: 400, message: "Unknown field name 'url'", message_code: 'api.action.bad_request.null' This is the code: const url = 'https://backstage.taboola.com/backstage/api/1.0/'+accountID+'/campaigns/'+cID+'items/'; const options = { method: 'POST', headers: { Authorization: "Bearer" + await getToken(), Accept: 'application/json', 'Content-Type': 'application/json'}, body: JSON.stringify({ url: landingPage, thumbnail_url: image, title: adTitle }) } const respose = await fetch(url, options);
ANSWERED

Access ad creation date along with other ad data

Hi team, is it possible to access the ad creation date along with the ad data (title, image etc.). via the API? This option seems to not be available or am I missing something?
ANSWERED

Is there api which I can use to get spend numbers grouped by date, publisher and campaign_item_id?

Is there api which I can use to get spend numbers grouped by date, publisher and campaign_item_id?
ANSWERED

Creation Date for Item

Hey, How can we get the creation date for item (creative) which exists in your dashboard but I can't find it in the API documentation? Thanks, Leo
ANSWERED

Add a Video URL in Campaign Item

Is it possible to add a Video URL in the campaign item via API? Currently, the thumbnail_url only accepts image URLs, not video URLs. Please help, Thank You.
ANSWERED

Getting 404 status for Campaign Item that actually exists

I'm getting 404 status response when trying to call https://backstage.taboola.com/backstage/api/1.0/{accountId}/campaigns/{campaignId}/items/{campaignItemId}. The account/campaign/campaign item, all them exists, and are valid.. but still the endpoint is giving me 404, can you please let me know why that can happen?
ANSWERED

Reporting API at the item / thumbnail level

Hi, is campaign reporting (through API) available at the item / thumbnail level? I created items / thumbnails, each with title and URL in the Campaign Inventory. Is there any way to pull campaign reporting at such item / thumbnail level, through the reporting API ? Thanks
ANSWERED

Resource Not Found when requesting a campaignItem

When we try to pull a campaignItem we get a ‘Resource not found’ error, although the item is actually existing and visible through the Taboola UI. This is preventing us to update the campaignItem with imageUrl and headline. As an example: https://backstage.taboola.com/backstage/api/1.0/inpowered-sc/campaigns/4636610/items/2900178486 Can you please help to understand why this is happening?
150030003014004014034044294_flows50050390_daysaccess_tokenaccountaccount_creationaccount_idaccount_levelaccount_level_blockaccount_typeaccountsactivity_scheduleactual_cpcadvertiser_idadvertisersallowed_accountsalphabeticapi_accessapi_changesapi_keyapi_newsletterapi_secretaudienceaudience_onboardingaudience_segmentsaudience_targetingaudiencesaudit_trailauthorization_codeauto_targetingaws_downtimeaws_serverbalancebasebasic_authenticationbibidbid_modifierbid_modifiersbillingbilling_cycleblockblock_publisherblock_publishersbrand_safetybrowser_breakdownbulk_createbulk_updatebulk_update_campaignsby_audienceby_campaignby_hour_of_daycachingcampaigncampaign_daycampaign_day_breakdowncampaign_fieldscampaign_learningcampaign_levelcampaign_ownercampaign_site_daycampaign_summarycampaignscity_targetingclick_idclicksclient_credentialscode_snippetconnectorcontent-typeconversion_dataconversion_ruleconversionsconversions_valuecorscountriescountrycountry_codescpa_actionscpa_actions_numcpccpc_macrocreate_campaigncreate_itemcreate_timecreation_datecustom_audiencecustom_audience_rulecustom_conversion_rulecustom_conversionscut_offdaily_capdaily_spenddata_freshnessdata_studiodata_studio_connectordayday_dimensiondelaydeletedictionarydifferent_accountdiscrepancydocs_issuedocumentationdomainduplicateduplicate_campaignempty_responseend_dateevent_basedexelatefeature_requestfetch_levelfiltersfirst_party_audienceflowfull_authenticationget_account_detailsgoogle_apps_scriptgoogle_scriptgoogle_sheetshidden_audiencehidden_segmentshourlyhourly_reportinghourly_spendhtmlhtml_login_pagehtml_responseiasimplicit_flowinactive_accountsinclude_multi_conversionsinclusionsintegrationinternal_support_ticketip_addressis_atomicitemitemsixudra_curljava_client_sdkjava_sdkjavascriptjsjupyter_notebooklaravellearning_statelimitlist_of_publisherslookalike_audiencelookalike_audienceslookback_windowloss_of_scalemacrosmalformed_jsonmarketplacemarketplace_audiencesmax_campaignsmax_itemsmax_resultsminimum_bidminimum_cpcmixedanalyticsmy_audiencesnetworknetwork_accountnew_featurenullnumeric_site_idoauth2os_breakdownpage_viewpagingpartner_typepassword_credentialspatchpausepermissionsphppixel_lookalikeplacementplacement_breakdownplacement_filterplacement_nameplatform_targetingpostmanprecannedprerequisites_not_metpublisherpublisher_bid_modifierpublisher_blockspublisher_idpublisher_namepublisher_networkpublisher_reportspublisher_targetingpublisher_urlpublisherspythonpython_clientrrate_limitreal_timereal_time_reportingrecommendation_apiredirect_urirejected_campaignsremove_allreport_cachingreportingreporting_discrepancyreportsretention_periodrevenuerevenue_summaryrevenue_summary_reportroadmaps2ssafety_ratingsalessandboxscalesitesite_breakdownsite_nameslowslownesssort_filterspecial_charsspendspending_limitsslssostatussub_accountssupermetricssupport_tickettataboola_adstaboola_pixeltargetingtcctest_accounttheoptimizertimeouttimezonetlstop_campaign_contenttop_contenttracking_codetypouiunblock_publishersunknown_publisherupdate_itemupload_imageurluser_accountsuser_segmentsutmvaluevideovideo_campaign_summaryvideo_campaignsvideo_completionsvideo_itemvideo_itemsviewsvisit_valuevoluumweb_hookswhitelistx-www-form-urlencodedyearly_reportingנ