--- title: "Create your first integration" slug: "create-your-first-integration" abstract: "Describes the steps required to integrate your application with Sitecore Search using the JS SDK for React, the Data package, or the API." --- # Create your first integration This is part three of the [get started](https://doc.sitecore.com/search/en/users/search-user-guide/get-started.html "Get started") walkthrough series. The previous parts of the walkthrough series describe how to configure entities and experiences for your specific requirements. This walkthrough describes how your developer [integrates an application](https://doc.sitecore.com/search/en/users/search-user-guide/integrate-the-application.html "Integrate the application") with Search. The developer can choose to use the [Sitecore Cloud SDK](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/sitecore-cloud-sdk-for-javascript.html), the SDK for React, the JS Data package, or the API. ![Integrate your application using the JS SDK to match the designs.](https://doc.sitecore.com/api/markdown-image/search/en/users/search-user-guide/images/getstarted-5.PNG) This walkthrough describes how to: :::walkthrough 1. [Retrieve information on hosts and paths](https://doc.sitecore.com/search/en/users/search-user-guide/get-started/create-your-first-integration.html#retrieve-information-on-hosts-and-paths) 2. [Set up a subdomain](https://doc.sitecore.com/search/en/users/search-user-guide/get-started/create-your-first-integration.html#set-up-a-subdomain) 3. [Integrate into a website or an application](https://doc.sitecore.com/search/en/users/search-user-guide/get-started/create-your-first-integration.html#integrate-into-a-website-or-an-application) ::: ## Retrieve information on hosts and paths To retrieve information on hosts and paths: - On the menu bar, click **Developer Resources**. On the **API Access** tab, your developer can copy the endpoints for **Server**, **Authentication**, **Search and Recommendation**, **Events**, and **Incremental Feed**. ## Set up a subdomain You can set up a subdomain for your implementation. This requires configuring your [domain and CNAME records](https://doc.sitecore.com/search/en/users/search-user-guide/integrate-the-application/cname-records-and-subdomain-delegation.html "CNAME records and subdomain delegation"). Using a subdomain provides the following advantages: - **Avoids tracking blocks** - ad blockers and intelligent tracking prevention (ITP) technologies commonly block cookies from third-party domains, affecting services like Search that rely on cookies for anonymous visitor tracking. To circumvent this, you can create a subdomain, like *rfk.yourdomain.com*, allowing Search to store cookies under your domain. This approach prevents Search cookies from being flagged as third-party, ensuring uninterrupted tracking and reporting through your dedicated subdomain. - **Simplifies authentication** - running Search on your subdomain means that it's automatically trusted, removing the need for extra [authentication](https://doc.sitecore.com/search/en/developers/search-developer-guide/en/api-authentication-and-authorization.html) steps. To set up domain delegation, do one of the following: - [Use Sitecore certificates](https://doc.sitecore.com/search/en/users/search-user-guide/integrate-the-application/cname-records-and-subdomain-delegation/configure-using-sitecore-certificates.html "Configure using Sitecore certificates") - [Use your own certificates](https://doc.sitecore.com/search/en/users/search-user-guide/integrate-the-application/cname-records-and-subdomain-delegation/configure-using-your-own-certificates.html "Configure using your own certificates") ## Integrate into a website or an application Sitecore Search is [preconfigured with experiences](https://doc.sitecore.com/search/en/users/search-user-guide/ai-driven-experiences.html "AI-driven experiences") using the entities *Content*, *Product*, *Category*, and *Store*. These experiences are displayed on a website or application integrated with Search as soon as indexing is complete. > [!important] > You'll need to update the URL or the URL pattern associated with the preconfigured pages to match your application. You can learn more about search experience integration options and events tracking in the Sitecore Search developer documentation. This also includes tracking visitor interactions, which are used to drive personalization and generate analytics insights. Depending on what you want to implement, the effort needed to customize your integration can vary. To integrate your website or application with Search, choose one of the following options according to your current setup: - For a React implementation - install the Search JS SDK for React and the UI Components CLI, then use the CLI to add widgets to your website or application. - For non-React JavaScript frameworks - install the JS Data package and then [make your first query](https://doc.sitecore.com/search/en/developers/search-developer-guide/en/make-your-first-query.html) to fetch data. - For all other implementations - use the [API documentation](https://doc.sitecore.com/search/en/developers/search-and-recommentation-api/index.html) to [create search experiences and send events](https://doc.sitecore.com/search/en/developers/search-developer-guide/en/walkthrough--using-apis-to-create-a-search-experience-and-send-events.html). > [!note] > Refer to the developer guide for more details of the various integration methods. ## Next steps The following procedures describe more ways for you to explore Search functionality and personalize experiences: - Create [additional pages and widgets](https://doc.sitecore.com/search/en/users/search-user-guide/display-relevant-results/add-pages-and-widgets.html "Add pages and widgets") as listed in your plan. - [Add rules](https://doc.sitecore.com/search/en/users/search-user-guide/display-relevant-results/variations-and-rules.html "Variations and rules") to the search and recommendation widgets. - [Run split tests](https://doc.sitecore.com/search/en/users/search-user-guide/run-split-tests.html "Run split tests") and [monitor their performance](https://doc.sitecore.com/search/en/users/search-user-guide/monitor-performance.html "Monitor performance").