Use the Microsoft Search API to index data
APIs under the
/beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported.
You can use Microsoft Graph to add custom items to search results in the Microsoft Search experience.
Requests to index data are performed on behalf of an application without the presence of a signed-in user, identified using an access token with application permission.
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.
Common use cases
The use cases for the APIs in this section involve building Microsoft Graph connectors, which involves the following primary steps:
- Create a connection to an external data source.
- Create and register a schema that describes the type and how to index the external data.
- Index the data as an external item.
|Use cases||REST resources||See also|
|Create, update, or delete a connection||externalConnection||externalConnection methods|
|Register a schema for the external data||schema||schema methods|
|Add, update or delete a custom item in the index||externalItem||externalItem methods|
The following are current knownlimitations:
- Organizations are limited to a maximum of 10 connections.
- Only Azure Active Directory identities are supported.
- You can create only four
externalItemresources items per second.
- An application is limited to four concurrent operations on a connection.
- Connections have a capacity limit of 700,000 items or ~70 GB of data.
- Maximum size of an
externalItementity is 4 MB.
- Sorting results is not supported.
- Result ranking is best effort.
Find out about the latest new features and updates for this API set.