Marketing API documentation ><\/strong><\/a><\/p>\n\n\n\n The Marketing API provides programmatic access to the SmartNews Ads platform, enabling you to automate campaign management and retrieve detailed performance insights. Key features include:<\/p>\n\n\n\n Before you can start using the Marketing API, you’ll need to register as a developer. You\u2019ll also need an existing SmartNews Ads account before completing the following steps:<\/p>\n\n\n\n Once approved, follow these steps to obtain your client secret. This is your confidential key used for API authentication.<\/p>\n\n\n\n Your client secret will only be displayed once at generation. Once approved, your app\u2019s details should appear under the Developer Apps > App Registration tab as shown below.<\/p>\n\n\n\n To access ad account resources via the Marketing API, the owner of the ad accounts must assign the resources to your developer app.<\/p>\n\n\n\n The following guide is for ad account operators who wish to integrate their ad accounts with their team\u2019s developer apps. These steps require Business Manager Admin permissions. If your user account has access to developer features, your account also has Business Manager Admin permissions.<\/p>\n\n\n\n A: Unlike the legacy API, you don\u2019t need to apply as a developer to publish the API key and share it with the developers. You only need developer access if you plan on developing a new app using the API. A: We maintain the latest and previous API versions simultaneously for 6 months. This allows you to test your integration against a new version while still running production traffic through the previous version.<\/p>\n\n\n\n A: Response fields or parameters will never be deleted or updated within any given version. However, some breaking changes may be introduced in new versions. You may see these types of changes within a version:<\/p>\n\n\n\n New versions and previous versions will co-exist for 6 months to ensure you have time to make any required updates.<\/p>\n\n\n\n <\/p>\n","protected":false},"excerpt":{"rendered":"This guide will walk you through the process of integrating with the updated SmartNews Ads Marketing API, designed to help developers programmatically manage SmartNews Ads campaigns and access analytics data. If you are not a developer and just need help integrating your ad account with a developer app via the API, please check the For advertisers and agencies section. Marketing API documentation > Introducing Marketing API The Marketing API provides programmatic access to the SmartNews Ads platform, enabling you to automate campaign management and retrieve detailed performance insights. Key features include: For API developers Submit your application Before you can start using the Marketing API, you’ll need to register as […]","protected":false},"author":4,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"categories":[206],"tags":[],"label":[],"class_list":["post-5513","post","type-post","status-publish","format-standard","hentry","category-tracking-en"],"acf":[],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/posts\/5513","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/comments?post=5513"}],"version-history":[{"count":9,"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/posts\/5513\/revisions"}],"predecessor-version":[{"id":9023,"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/posts\/5513\/revisions\/9023"}],"wp:attachment":[{"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/media?parent=5513"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/categories?post=5513"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/tags?post=5513"},{"taxonomy":"label","embeddable":true,"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/label?post=5513"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Introducing Marketing API<\/h2>\n\n\n\n
\n
For API developers<\/h2>\n\n\n\n
Submit your application<\/h3>\n\n\n\n
1<\/i>Complete the Developer Application Form<\/a>.<\/span><\/h6>\n\n\n\n
2<\/i>Provide your company information and intended API usage details.<\/span><\/h6>\n\n\n\n
3<\/i>Applications will be reviewed by the SmartNews team. We\u2019ll send you a notification upon approval.<\/span><\/h6>\n\n\n\n
Note<\/h4>\n\n\n\n
\n
Generate your client secret<\/h3>\n\n\n\n
1<\/i>Log in to Business Manager.<\/span><\/h6>\n\n\n\n
2<\/i>Navigate to the Developer Apps management section and select \u201cApp Registration\u201d from the drop-down menu, followed by \u201cRegister developer app information.\u201d<\/span><\/h6>\n\n\n\n
![\"\"](\"https:\/\/help-ads.smartnews.com\/wp-content\/uploads\/2024\/11\/image-49-1024x481.png\")
<\/figure>\n\n\n\n3<\/i>For the app name, enter the exact name you used when you submitted the Developer Application Form and select \u201cSave and generate API client secret.\u201d<\/span><\/h6>\n\n\n\n
![\"\"](\"https:\/\/help-ads.smartnews.com\/wp-content\/uploads\/2024\/12\/image-1-2.png\")
<\/figure>\n\n\n\n4<\/i>Note and securely store your client secret.<\/span><\/h6>\n\n\n\n
![\"\"](\"https:\/\/help-ads.smartnews.com\/wp-content\/uploads\/2024\/12\/image-2-2-1024x550.png\")
<\/figure>\n\n\n\nNote<\/h4>\n\n\n\n
Keep your Client Secret secure and never share it publicly.<\/p>\n\n\n\n![\"\"](\"https:\/\/help-ads.smartnews.com\/wp-content\/uploads\/2024\/11\/image-50-1024x411.png\")
<\/figure>\n\n\n\n\n
For advertisers and agencies<\/h2>\n\n\n\n
Assigning ad accounts to a developer app<\/h3>\n\n\n\n
1<\/i>Navigate to the Developer Apps > App Access Management tab in Business Manager.<\/span><\/h6>\n\n\n\n
![\"\"](\"https:\/\/help-ads.smartnews.com\/wp-content\/uploads\/2024\/11\/image-51-1024x271.png\")
<\/figure>\n\n\n\n2<\/i>Select the relevant app on the left-hand side, followed by Assign ad account.<\/span><\/h6>\n\n\n\n
![\"\"](\"https:\/\/help-ads.smartnews.com\/wp-content\/uploads\/2024\/11\/image-52-1024x524.png\")
<\/figure>\n\n\n\n3<\/i>Enter the Developer App ID and select the advertising accounts you want to link (you can select multiple accounts).<\/span><\/h6>\n\n\n\n
4<\/i>Select appropriate ad account role for all selected accounts.<\/span><\/h6>\n\n\n\n
![\"\"](\"https:\/\/help-ads.smartnews.com\/wp-content\/uploads\/2024\/11\/image-2026-01-07T141621.040-1024x901.png\")
<\/figure>\n\n\n\n5<\/i>Select \u201cNext\u201d.<\/span><\/h6>\n\n\n\n
6<\/i>A confirmation pop-up will appear, select \u201cSave\u201d to apply your changes.<\/span><\/h6>\n\n\n\n
![\"\"](\"https:\/\/help-ads.smartnews.com\/wp-content\/uploads\/2024\/12\/image-6-1.png\")
<\/figure>\n\n\n\nFAQ<\/h2>\n\n\n\n
Q: I\u2019m not an API developer, but I want to use an existing service which uses the SmartNews Ads API. Do I need to apply as a developer?<\/h6>\n\n\n\n
Linking developer apps with an ad account<\/a><\/p>\n\n\n\nQ: How long do you maintain each API version?<\/h6>\n\n\n\n
Q: Will my code break when you release a new API version?<\/h6>\n\n\n\n
\n
Support and resources<\/h2>\n\n\n\n
\n
\n