Get started with the Hotel API

Note

This beta release of Hotel Price Ads is available to select participants only. For information about participating in the beta release program, please contact your account manager or enroll here.

The API and documentation are subject to change.

Do you have your Microsoft Advertising credentials?

To use the Hotel API, you must have a Microsoft Advertising account and a Microsoft account. To get a Microsoft Advertising account, go to https://ads.microsoft.com. If you're not signed in using your Microsoft account, you're asked to sign in to your Microsoft account or sign up for a Microsoft account. After signing in, you'll have the option to Sign up for a new Microsoft Advertising account. Select the sign-up option and continue with the sign-up process.

Unlike the other Bing Ads APIs, the Hotel API does not use a developer token. The API ignores it if you include it.

Enable your account for Hotel Price Ads

Once we have received your enrollment information, we will contact you via email regarding the next steps.

Authenticating your credentials

Important

Starting June 1st, 2022 we will require multi-factor authentication for all users who sign in through a third-party application that uses the Bing Ads API, Content API, and Hotel APIs.

You must update your application to get user consent using the new msads.manage scope. All application developers must take action to use the new scope.

For more information see the Multi-factor authentication requirement guide.

The Hotel API uses the OAuth authentication scheme. For details about authenticating Microsoft account credentials using OAuth, see Authentication with OAuth (using the Microsoft identity platform is recommended).

You can use the Bing Ads SDK for .NET, Java, or Python to authenticate Microsoft account credentials. For details about using the SDK to get the access token, see C# | Java | Python. You might only want use the SDK to get the access token if you're using the SDK for Microsoft Advertising campaigns, too. Otherwise, it may not be worth the overhead of installing the SDK.

If you choose not to use the Bing Ads SDK to get the tokens, see OAuth C# Example for an example OAuth implementation.

Note

If you use the API from a service, see Using the Hotel API from a service.

Where do you use your credentials?

After getting the user's OAuth access token, set the Authorization header to it.

var headers = new WebHeaderCollection();
headers.Add(HttpRequestHeader.Authorization, "Bearer " + tokens.AccessToken);

For information about the Authorization header and other headers that the request and response may contain, see Headers.

Note

The Hotel API uses the standard Authorization header. If you use the Bing Ads SDK to get the OAuth tokens, you'll use the SDK to get the tokens and then set the Authorization header.

Do you have your hotel feed set up?

Before using the Hotel API, you should have your hotel feeds set up. For details, see: