Bing Ads API Blog articles

API interfaces for political ads policy enforcement

garittar — Thu, 02 Oct 2025 21:55:47 GMT

The European Union (EU) Regulation 2024/900 about the transparency and targeting of political advertising will take effect on October 10, 2025. As a reminder, Microsoft Advertising introduced a political advertising declaration requirement for all customers in September 2025.

Microsoft Advertising doesn’t allow political advertising on its platform. Campaigns intended for political advertising won’t be allowed to proceed according to our policies. We expect our customers to take steps to ensure compliance with this policy.

We've updated our political advertising policies to include the EU regulatory requirements. To comply with the regulation, you are required to declare whether campaigns are intended for political advertising before campaign creation and import. If it is, any political advertising must be removed to proceed.

What’s new:

We'll collect declarations regarding whether creatives are political through a new element labeled as IsPolitical made available in the Microsoft Advertising API. Customers will be able to send the declaration using IsPolitical.

If IsPolitical is set to true, attempts to add or update the campaign will fail with the error: PoliticalCampaignsAreNotSupported because we don’t support political advertising.

Additionally, if this field is empty or null in a GET call or bulk download, its value is treated as false. If you don’t explicitly declare that the campaign constitutes political advertising, by default, it will be assumed to be a declaration that the creative is non-political.

What’s not changing:

Existing campaigns will continue to run without interruption.

We'll continue to conduct regular reviews of all ads to confirm that they are not intended for political advertising. Campaigns identified as being intended for political advertising will be treated as an egregious violation and appropriate steps will be taken.

Learn more about Microsoft Advertising API declaration capabilities and requirements:

API Release Notes - Microsoft Advertising API | Microsoft Learn

Campaign Data Object - Campaign Management - Microsoft Advertising API | Microsoft Learn: This topic provides a more detailed description of the IsPolitical element.

Campaign Record - Bulk - Microsoft Advertising API | Microsoft Learn: This topic defines a campaign’s elements that can be uploaded and downloaded in a bulk file, including IsPolitical.

REST API Documentation and Bing Ads SDK Release V13.0.22

rtgaritta — Tue, 19 Nov 2024 14:48:46 GMT

We are pleased to announce that our API documentation has been updated to include the new REST API. You will be able to switch between the REST and SOAP APIs within the documentation.

We are also excited to release Bing Ads SDK 13.0.22 for Java and .NET, which continues our migration from the existing XML-based SOAP API to a new JSON-based REST API for CustomerManagement and CustomerBilling Services.

Please see our previous blog post about the new REST API to learn more.

Changes to product ads search query report

rtgaritta — Wed, 16 Oct 2024 22:10:12 GMT

Currently, we include search query details for product ads and Performance Max product ads in the product search term report. Going forward, we won’t show you Performance Max product ad data in this report. It will only include product ads data from standard shopping campaigns.

To view Performance Max search query info (for both Performance Max search and product ads), you can use the search terms insight report. This change will benefit you by consolidating all Performance Max search query reporting into one report.

Learn more about how Performance Max and other campaigns are now supported with search term insights reports.

Contact your account team or Microsoft Advertising support if you have any questions about this update.

Bing Ads SDK Release V13.0.21

rtgaritta — Tue, 03 Sep 2024 22:02:08 GMT

We are pleased to announce the following new features, improvements, and bug fixes in the Bing Ads SDK Release V13.0.21.

Logo extensions

Logo extensions are an ad extension type that allows you to provide a logo and a business name to serve alongside your ads. This is a great way to make it clear to potential customers which links belong to you.

Benefits:

Promote your brand, allowing it to stand out from the competition by displaying eye-catching logos in ads.

Build brand recognition to drive more clicks and conversions on your website.

Serve on Bing across PC, tablet, and mobile devices and can appear with other ad extensions.

New API interfaces

Campaign Management API: Asset Group Search Theme: AssetGroupSearchTheme. Impression Based Remarketing List: ImpressionBasedRemarketingList, ImpressionBasedEntityType. Logo Ad Extension: LogoAdExtension.

Reporting API: AssetPerformanceReportColumn, AssetPerformanceReportRequest.

Bulk service

Support for adding and updating goals: App Install Goal Record, Campaign Conversion Goal Record, Duration Goal Record, Event Goal Record, In Store Transaction Goal Record, In Store Visit Goal Record, Offline Conversion Goal Record, Pages Viewed Per Visit Goal Record, Product Goal Record, URL Goal Record.

Support for new audience type Impression Based Remarketing List: Impression Based Remarketing List Record, Campaign Impression Based Remarketing List Association Record, Campaign Negative Impression Based Remarketing List Association Record, Ad Group Impression Based Remarketing List Association Record, Ad Group Negative Impression Based Remarketing List Association Record.

Add bulk mapping for TargetCostPerSale.

Add bulk mappings for AutoBidding, BulkSeasonalityAdjustment and BulkDataExclusion.

Consolidated Recommendation API Phase 1

rtgaritta — Tue, 14 May 2024 22:17:09 GMT

We are pleased to announce the release of Phase 1 of our new Consolidated Recommendation API. 

The Consolidated Recommendation API introduces a unified interface structure that enables developers to retrieve, apply, or dismiss recommendations in a unified pattern. Instead of requiring individual API calls for each new recommendation, this pipeline will surface any current and new recommendations with a single implementation.

This release supports budget, keyword, and responsive search ads recommendations. Get recommendations with a single service operation RetrieveRecommendations, and apply them with ApplyRecommendations.

Key Features

No need to code each recommendation separately.
Work with current and new recommendations in a single implementation.
Reduce developer effort.
Easier integration of systems with Microsoft Advertising recommendations.

New API Interfaces

Ad Insight API

ApplyRecommendationEntity, ApplyRecommendations, BudgetPointType, CampaignBudgetRecommendation, DismissRecommendationEntity, DismissRecommendations, KeywordRecommendation, RecommendationBase, RecommendationType, ResponsiveSearchAdRecommendation, RetrieveRecommendations.

Learn more about the Micrsoft Advertising Ad Insight API service operations.

Automatic conversion of your existing Smart Shopping campaigns to Performance Max campaigns

rtgaritta — Tue, 07 May 2024 20:32:07 GMT

In March 2024, we announced the global availability of Microsoft Advertising’s Performance Max (PMax). This campaign type enables you to leverage real-time AI for your campaign management—from asset creation to finding the right audience to bring you more results.

Starting in August, we plan on automatically converting all your existing Smart Shopping campaigns to Performance Max campaigns. Your setup, reporting, and performance history will remain unchanged after this transition. Once your Performance Max campaign is running, there's an initial learning period where our AI will continue to optimize your campaign in real time.

After we convert your Smart Shopping campaign, you can manage it as usual in PMax:

Listing groups (formerly known as product groups) with product feeds
Maximize conversions or maximize conversion value bid strategy
Support for local inventory ads
Product ad-related reporting

If you try to create a new Smart shopping campaign after deprecation, you will receive the error code SmartShoppingCampaignCreationNotSupported. Please create a Performance Max campaign instead.

If you’d like to upgrade your Smart shopping campaign to Performance Max earlier, select Edit > Upgrade to Performance Max.

Contact your account team or Microsoft Advertising support if you have any questions about this update.

New REST API and Bing Ads SDK May 2024 Release (V13.0.20)

rtgaritta — Wed, 01 May 2024 16:46:48 GMT

We are excited to release Bing Ads SDK 13.0.20 for Java and .NET, which includes performance improvements such as lower service call latency and reduced network traffic. This allows you to make service calls faster and at a lower cost.

Improvement from previous SDK version

For example, when we run the following test to query ad groups by campaign Id for 1000 ad groups, the previous SDK version 13.0.19.1 has an average call duration of 284 ms:

When running the same code with the new SDK version 13.0.20, the average call duration is reduced to 67 ms. This is a 75% improvement from the previous version.

v13.0.19.1

# Duration (ms)

0 425

1 326

2 304

3 262

4 264

5 253

6 270

7 257

8 245

9 240

Avg. 284 ms

v13.0.20

# Duration (ms)

0 79

1 73

2 66

3 62

4 63

5 70

6 65

7 69

8 61

9 64

Avg. 67 ms

Reduced response size

We have also reduced the response size. For the example above, it is reduced from 784 KB to 8.4 KB, which is a 99% improvement.

You can expect similar improvements for other API method calls as well, especially ones that operate on many entities or return large amounts of data.

New REST API

These improvements are made possible by internally switching the SDK from the existing XML-based SOAP API to a new JSON-based REST API. This SDK release switches Campaign Management, Bulk, and Reporting services to the new API, and other services will be switched in future releases.

Upgrading to the new SDK

Given the significant internal changes we had to make to achieve these improvements, we recommend that you test and monitor your application when upgrading to this version to make sure your application is compatible with the implementation changes and dependencies introduced in this release.

We have also provided an easy way to switch Bing Ads SDK back to the old implementation in case any issues arise when using the new implementation. For more details on that and other information regarding the upgrade process, please see:

BingAds SDK March 2024 Release (V13.0.19)

rtgaritta — Thu, 28 Mar 2024 02:17:44 GMT

We are pleased to announce the following new features, improvements, and bug fixes in the BingAds SDK March 2024 Release (V13.0.19).

Key Features

New API Interfaces
- Campaign Management API: AddDataExclusions, GetDataExclusionsByAccountId, GetDataExclusionsByIds, UpdateDataExclusions, DeleteDataExclusions for DataExclusion. AddSeasonalityAdjustment, GetSeasonalityAdjustmentsByAccountId, GetSeasonalityAdjustmentByIds, UpdateSeasonalityAdjustments, DeleteSeasonalityAdjustments for SeasonalityAdjustment.
Bulk service
- Disable VerifiedTrackingSettings in BulkCampaign. New fields AutoGeneratedImageOptOut and AutoGeneratedTextOptOut for Perfromance Max in BulkCampaign.
- Add bulk mappings BulkAccountNegativeKeywordList, BulkAccountNegativeKeywordListAssociation and BulkAccountSharedNegativeKeyword for Account Level Negative Keyword List.
- Support PageFeedIds for Performance Max in BulkCampaign.
- Add bulk mapping for TargetCostPerSale.
- Add bulk mappings for AutoBidding, BulkSeasonalityAdjustment and BulkDataExclusion.

Release notes

BingAds SDK November 2023 Release (V13.0.18)

rtgaritta — Fri, 17 Nov 2023 20:56:29 GMT

We are pleased to announce the following new features, improvements, and bug fixes in the BingAds SDK November 2023 Release (V13.0.18).

Key Features

New API Interfaces
- Campaign Management API: UpdateSitelinkUrls for GoogleImportOption.
- Bulk API: LeadFormAdExtensions.
Bulk service
- New fields HashedEmailAddress and HashedPhoneNumber in BulkOfflineConversion.

Release notes

API documentation now available in Japanese and Simplified Chinese

rtgaritta — Mon, 06 Nov 2023 23:22:27 GMT

We are pleased to announce that our API documentation is now available in Japanese and Simplified Chinese. You will be automatically redirected based on your browser's language setting.

We will add more languages including German, French, Italian, Spanish, Portuguese, and Traditional Chinese later this year. Our goal is to make it easier for you to use our APIs and integrate them with your applications. We are committed to providing you with the best tools and resources to grow your business with Microsoft Advertising.

Thank you for your continued support and feedback.

Multi-factor authentication API notice

rtgaritta — Wed, 04 Oct 2023 23:36:22 GMT

In June 2022, we introduced multi-factor authentication as a requirement for Bing Ads.

You may still need to make a code change in order to become compliant with this requirement. Microsoft Advertising is performing technical enforcement checks in early October.

Multi-factor authentication is a security process that requires you to verify your identity in two different ways (e.g., entering your password along with a code sent to your phone).

Here's what developers need to do:

1. Make a code change and/or SDK update

Update all applications to use the new msads.manage scope via the Microsoft identity platform endpoint. Note: Access tokens acquired via the bingads.manage or ads.manage scope will not be authenticated.

Live Connect: If you are still on Live Connect for some reason, this is no longer supported. The Live Connect endpoint was sunsetted upon enforcement of MFA.

Task: Change from bingads.manage to msads.manage
Task: Change endpoint to Microsoft identity endpoint

Microsoft Identity platform endpoint for developers: If you are already on the Microsoft identity platform endpoint, you only need to upgrade to the new authentication scope.
Task: Change from ads.manage to msads.manage

A detailed how-to guide is available via this link.

2. Prompt all users for consent (again)

The new msads.manage authentication scope requires renewed consent from all users of your application. This scope will not allow users to grant consent and authenticate without passing through MFA.

Task: Get all users to re-login to the application

Here is what to do if you use a 3rd party application:

If you use a 3rd party application to connect to the Microsoft Advertising API but aren't the application owner, please contact the provider to confirm that they make the code change. Then, proceed with re-authenticating your Microsoft accounts within the application to avoid disruption after enforcement.

If you have any questions or would like assistance, please contact your account team or support.

Thanks for your collaboration.

BingAds SDK August 2023 Release (V13.0.17)

rtgaritta — Tue, 19 Sep 2023 23:15:54 GMT

We are pleased to announce the following new features, improvements, and bug fixes in the BingAds SDK August 2023 Release (V13.0.17).

Key Features

New API Interfaces
- Campaign Management API: GenreCriterion for AdGroup level, DealCriterion for Campaign level.
- Bulk API: LogoAdExtensions.
Bulk service
- Bulk support of AdGroupGenreCriterion and CampaignDealCriterion.
- New fields DestinationChannel and IsMultiChannelCampaign in BulkCampaign, VerifiedTrackingData in BulkResponsiveAds.
- Added mappings of TargetWidth and TargetHeight for ImageAsset.

Release notes

Deprecation of legacy Ad Insight Keyword APIs and features

rtgaritta — Fri, 25 Oct 2024 13:54:53 GMT

We're updating our Ad Insight API to provide you with a better keyword planner experience. As part of this process, we'll stop supporting some legacy and low-usage APIs and features that are no longer aligned with our quality and service.

The following will be deprecated as of August 21, 2023.

Service operations related to legacy Ad Insight Keyword APIs:

These APIs were released with a discontinued Microsoft Advertising Intelligence (MAI) tool. They have low usage and high maintenance costs. They won't be compatible with the new REST API interface that we are migrating to.

The "CategorySearchParameter" data object:

“CategorySearchParameter” in “GetKeywordIdeas Service Operation”

“Your Product Category” in Keyword Planner (Find new keywords):

This feature is based on an outdated offline table, only available in English, and does not reflect the current market trends and user behavior, so we'll deprecate it in the Microsoft Advertising web UI as well.

Timeline and Changes

2023-08-21

The “Your Product Category” on Keyword Planner UI: Drop-down will be removed.

Legacy AdInsight Keyword APIs: Requests will no longer be acceptable, return error.

BingAds SDK June 2023 Release (V13.0.16)

jonmeyers — Tue, 13 Jun 2023 14:40:36 GMT

We are pleased to announce the following new features, improvements, and bug fixes in the BingAds SDK June 2023 Release (V13.0.16).

Key Features

New API Interfaces
- Campaign Management API: PMax Campaign, new Bidding Schemes (CostPerSale, ManualCPA)
Bulk service
- Bulk support for PMax campaigns, i.e. AssetGroup, AssetGroupListingGroup, AudienceGroup, AudienceGroupAssetGroupAssociation, CampaignNegativeWebPage.

Release notes

BingAds SDK December 2022 Release (V13.0.15)

jonmeyers — Fri, 13 Jan 2023 16:58:47 GMT

We are pleased to announce the following new features, improvements, and bug fixes in the BingAds SDK December 2022 Release (V13.0.15).

Key Features

New API Interfaces
- AdInsight API:
  - GetTextAssetSuggestionsByFinalUrls
  - GetRecommendations
- CustomerManagement API:
  - New interface for SignupCustomer
- Reporting API:
  - Hotel Ad reporting
  - Video reporting
- CampaignManagement API:
  - OnlineConversionAdjustment
  - HotelAds
  - New bidding schemes (PercentCpc, Commission)
Bulk service
- Bulk support for OnlineConversionAdjustment
- Bulk support for Hotel Ad entities, i.e.  HotelAdvanceBookingWindowCriterion, HotelCheckInDayCriterion, HotelCheckInDateCriterion, HotelDateSelectionTypeCriterion, HotelLengthOfStayCriterion and HotelListingGroup
- Bulk Support for UseOptimizedTargeting, HotelAdGroupType, CommissionRate and PercentCpcBid in BulkAdGroup

Release notes

Advertisers to use Ad Insights API for all Auto-apply recommendations controls and settings.

jonmeyers — Wed, 16 Nov 2022 21:06:54 GMT

In February 2022, Microsoft Advertising launched Auto-apply recommendations (AAR) to help our customers efficiently and automatically optimize their campaigns. Once opted in, we'll showcase and automatically apply high-quality recommendations such as:

Adding responsive search ads
Adding multimedia ads
Removing conflicting negative keywords
Creating conversion goals
Fixing many issues with conversion goals

We automatically apply each specific recommendation seven days after you opt in.

Given the positive usage rates we saw with this feature, we created a new Ad Insight API in May 2022 to expand on the controls and settings for AAR. Ad Insight API API Auto-apply management - Microsoft Advertising API | Microsoft Learn

Around the time we launched the new Ad Insights API last spring, we shared that we’d be deprecating the AutoApplyRecommendation module from the Campaign Management API and Bulk API later this calendar year. As most developers have now switched over and are using the Ad Insights API, we’ll be deprecating the AAR modules within the Campaign Management API and Bulk API on November 30, 2022.

Registrations Open for the September 30 Developer Webcast

JennCockrell — Thu, 23 Sep 2021 16:30:22 GMT

Join the Microsoft Advertising team to learn about exciting new features coming soon to the developer roadmap. We’ll explore features that are currently available as well as several that we’ll be piloting and releasing soon.

This webcast will provide you with a clear understanding of upcoming features and the value they can bring to your Microsoft Advertising campaigns. Along with a view of the features coming soon and those recently updated, we’ll also provide an estimated timeline as to when features will become available, so you’ll have the building blocks needed to develop the solution that works best for you.

You can register here for the webcast on September 30, 2021 8:00 AM (PDT).

In this webcast we will cover:

Video Campaigns
Multichannel Ads
Credit Card Ads and Professional Service Ads
Google Import API
Multi-factor Authentication

If you can't make the live webcast, register to watch it on demand when it's most convenient for you. The on-demand version is usually available 24 hours after the live event.

Looking forward to connecting with you soon,

Bing Ads API team

Microsoft Advertising

New authentication scope for multi-factor authentication

urban-eric — Thu, 24 Feb 2022 18:01:28 GMT

In early 2020, we started requiring multi-factor authentication in Microsoft Advertising online. Multi-factor authentication is a security process that requires you to verify your identity in two different ways, and it's critical for the security and safety of our users.

As we continue to assess the readiness of our developer community and consider the many partner disruptions due to the pandemic, we're extending our enforcement date by three months. The new date is June 1, 2022. Even with this extended timeline, security updates aren't something to put aside until later.

Action required

To complete this upgrade, you must update your application and prompt users for consent using “msads.manage” scope via the Microsoft identity platform endpoint. All Microsoft Advertising developers must take action to use the new scope.

With each API request, we'll check the access token to ensure the user granted consent via the new “msads.manage” scope. Upon enforcement of multi-factor authentication, any access token provisioned otherwise (i.e., the "bingads.manage" scope with the Microsoft identity platform endpoint or the "bingads.manage" scope with the Live Connect endpoint) won’t be accepted and the corresponding API calls will fail.

We recommend that you make the necessary changes as soon as possible.

SDK support

Support for the new “msads.manage scope” is added with Bing Ads SDKs (NET, Java, Python, and PHP) version 13.0.10 released this month.

The new “msads.manage” scope is now used by default in all SDKs. For backwards compatibility you can temporarily use “ads.manage” or “bingads.manage” with a small code change.

var oAuthDesktopMobileAuthCodeGrant = new OAuthDesktopMobileAuthCodeGrant( Settings.Default["ClientId"].ToString(), apiEnvironment, OAuthScope.ADS_MANAGE // temporary workaround );

For more information, see our API documentation. As always please feel free to contact support or post a question in the Bing Ads API developer forum. 

Dynamic search ads update

urban-eric — Sat, 12 Jun 2021 00:15:58 GMT

As announced in a previous blog post, dynamic search ads can be created within search campaigns via the use of ad group type. Within a search campaign, you now have the option to create a standard ad group (containing expanded text ads, responsive search ads, and keywords) or a dynamic ad group (containing dynamic search ads and auto targets).

Starting this month you can no longer add, update, or retrieve campaigns that only support dynamic search ads. The campaign type of your existing campaigns has been updated from "DynamicSearchAds" to "Search". The ad groups are now considered "dynamic" ad groups, but there are no structural changes i.e., they contain the same auto targets and dynamic search ads as before.

As always please feel free to contact support or post a question in the Microsoft Advertising developer Q&A forum.

Conversion goal category requirements

urban-eric — Mon, 07 Jun 2021 03:49:28 GMT

IMPORTANT: If you already use conversion goals, please read this section about required changes.

You can categorize your conversion goals however makes sense for your business. Goal categories don't affect performance - they are here to help you segment your goals and their performance metrics.

Previously Bing Ads API did not require conversion goal categories. Depending on the goal type the default category is set to Download, None, Other, or Purchase.

Now when you add or update the custom event, offline conversion, or URL goals you must set a goal category or the Campaign Management service will return an error. There are no changes to the default category of other goal types as shown in the table.

Goal type	Default before	Default after
EventGoal OfflineConversionGoal UrlGoal	None	No default; Service returns an error
DurationGoal PagesViewedPerVisitGoal	Other	Other
InStoreTransactionGoal	Purchase	Purchase
AppInstallGoal	Download	Download

For more information, see our API documentation about conversion goal categories.

As always please feel free to post a question in the Bing Ads API developer forum or contact support.