Getting started with Sitecore Search
Sitecore Search is a powerful platform that you can integrate with to show predictive and personalized search experiences for your visitors. When you integrate with Search, you request data that you can use to build a search experience. This data could be a list of search results, facets, suggestions, and more. You also send visitor-driven events so that Search can generate personalized content and build analytics for your domain.
The complexity, flexibility, and development effort required to integrate depends on the method of integration that you choose.
Sitecore Search provides two integration methods that you can choose from:
REST APIs - integration involves accessing endpoints that expose Search services. Configure the requests you want to send to Search. You'll also need to handle the responses and translate them into Search experiences.
Compared to the SDK, API integration usually takes longer and requires more development effort but provides complete flexibility.
Before you integrate, at a minimum, make sure that you:
Can access the Customer Engagement Console (CEC), a SaaS workbench where you can test requests and monitor events. You also use the CEC to view attributes, features, and widgets configured for your domain and get details like their names and IDs.
Have access to API keys with required scopes. You need this for authentication if an administrator has not set up a subdomain.
Know where to show a search results widget and where to show a preview search widget. For example, you might want to show a full-page search on your company's home page but only a preview search for each vertical.
Know which features, like facets, sorting, and others, are required for each search experience and how these features are configured.Note
While an administrator configures most features in the CEC, you might need to pass some settings at runtime.
Know what content needs to be searchable in each search experience. This is because not all indexed content might need to be available for all searches.
If you have trouble getting any of this information, contact your administrator.
During integration, you add Search-specific code to your application or website. This code sends requests to Search and receives responses from it.
For example, if a visitor enters a term in the search bar and clicks enter, you'll want to show matching results. To get these results, send a request to Search to get content for a search widget. Search looks within your domain's indexed content, applies its algorithm, and returns search results. You'll also need to send events based on visitor actions.