Overview of the Microsoft Search API in Microsoft Graph (preview)

Microsoft Search is an enterprise search engine that delivers productivity gains and relevant search results for your organization. It harnesses the collective knowledge and productivity of an organization, and surfaces relevant content to keep end users up to date. Microsoft Search is available in various experiences including Office, SharePoint, Delve, Windows, and Bing. You can use the Microsoft Search API in Microsoft Graph to extend Microsoft Search to your apps.


Microsoft Graph connectors and Microsoft Search APIs (query and index) are currently in preview status. To use connectors with Microsoft Search or to build connectors, you must sign up for the connectors preview program. To join the preview program, submit the Microsoft Graph connectors preview sign-up form.

Why use the Microsoft Search API?

One unified search endpoint for Microsoft cloud data

The Microsoft Search API provides one unified search endpoint that you can use to query data in the Microsoft cloud - messages and events in Outlook mailboxes, and files on OneDrive and SharePoint - that Microsoft Search already indexes.

Include custom external data in search experience

Customers who want to include data outside of the Microsoft cloud in their search experience can use connectors to connect to a specific data source such as an organization's human resources database or product catalog, and use the Microsoft Search API to seamlessly query the external data source. The Microsoft Graph connectors gallery lists a number of ready-to-use connectors. Alternatively, customers can build connectors, index external custom items, and query specific external data sources as well.

Consistent, up-to-date search experience

When you use the Microsoft Search API, your customers benefit from more personalized, relevant search results powered by Microsoft Graph. The search experience in your apps will return results that are consistent with search in Office applications.

What data can I add or access by using the Microsoft Search API?

The Microsoft Search API supports searching the following content in the Microsoft cloud:

In addition, you can index and search external content via the externalItem object.

API reference

Looking for the API reference for this service?

Next steps

See also