---
title: "SEARCH event"
slug: "search-event-1166450"
abstract: "Describes the JSON object for a SEARCH event when using direct HTTP requests (Sitecore CDP Stream API)."
---
# SEARCH event

The SEARCH event captures the user's action of searching for a product. You must send the SEARCH event to Sitecore CDP when the search results page loads.

::::tabs
:::tab{title="2.1"}

To send a SEARCH event, use the following required attributes:

| Attribute | Type | Description | Example |
| --- | --- | --- | --- |
| `channel` | string (uppercase) | The touchpoint where the user interacts with your brand. | <ul><li>`"MOBILE_APP"`</li><li>`"MOBILE_WEB"`</li><li>`"WEB"`</li></ul> |
| `type` | string (uppercase) | The type of the event that takes place when the user interacts with your brand. | `"SEARCH"` |
| `language` | string (uppercase [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)) | The language the user is using your app in. | <ul><li>`"DE"`</li><li>`"EN"`</li><li>`"FR"`</li></ul> |
| `currency` | string (uppercase [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217#Active_codes)) | The alphabetic currency code of the currency the user is using in your app. | <ul><li>`"EUR"`</li><li>`"GBP"`</li><li>`"USD"`</li></ul> |
| `page` | string | The name of the webpage where the interaction with your brand takes place.<br><br>This is a custom value of your choice. | `"search page"` |
| `pos` | string | [The name of the point of sale](https://doc.sitecore.com/cdp/en/developers/api/stream-api/direct-http-requests-reference/sending-events-1166442/collect-required-details.html#UUID-60c4c930-3cfe-e0ad-3b98-69ceff75989f_section-idm1903325950166538) where the interaction with your brand takes place. | <ul><li>`"myretailsite/ireland"`</li><li>`"spinair.com/france"`</li></ul> |
| `browser_id` | string | The [browser ID](https://doc.sitecore.com/cdp/en/developers/api/stream-api/direct-http-requests-reference/sending-events-1166442/retrieve-the-browser-id.html). | `"a38b230c-11eb-4cf9-8d5d-274e9f344925​"` |
| `product_name` | string | The product name the guest searched for. | `"airSupport"` |
| `product_type` | string (uppercase) | The product type the guest searched for. | `"RUNNERS"` |

To send a SEARCH event for a flight search, use the following attributes:

| Attribute | Type | Description | Example | Required/optional |
| --- | --- | --- | --- | --- |
| `channel` | string (uppercase) | The touchpoint where the user interacts with your brand. | <ul><li>`"MOBILE_APP"`</li><li>`"MOBILE_WEB"`</li><li>`"WEB"`</li></ul> | Required |
| `type` | string (uppercase) | The type of the event that takes place when the user interacts with your brand. | `"SEARCH"` | Required |
| `language` | string (uppercase [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)) | The language the user is using your app in. | <ul><li>`"DE"`</li><li>`"EN"`</li><li>`"FR"`</li></ul> | Required |
| `currency` | string (uppercase [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217#Active_codes)) | The alphabetic currency code of the currency the user is using in your app. | <ul><li>`"EUR"`</li><li>`"GBP"`</li><li>`"USD"`</li></ul> | Required |
| `page` | string | The name of the webpage where the interaction with your brand takes place.<br><br>This is a custom value of your choice. | `"search page"` | Required |
| `pos` | string | [The name of the point of sale](https://doc.sitecore.com/cdp/en/developers/api/stream-api/direct-http-requests-reference/sending-events-1166442/collect-required-details.html#UUID-60c4c930-3cfe-e0ad-3b98-69ceff75989f_section-idm1903325950166538) where the interaction with your brand takes place. | <ul><li>`"myretailsite/ireland"`</li><li>`"spinair.com/france"`</li></ul> | Required |
| `browser_id` | string | The [browser ID](https://doc.sitecore.com/cdp/en/developers/api/stream-api/direct-http-requests-reference/sending-events-1166442/retrieve-the-browser-id.html). | `"a38b230c-11eb-4cf9-8d5d-274e9f344925​"` | Required |
| `product_name` | string | The product name the guest searched for. | `"DUB-LHR"` | Required |
| `product_type` | string (uppercase) | The product type the guest searched for. | `"FLIGHT"` | Required |
| `flight_type` | string (uppercase) | The flight type the guest searched for. | <ul><li>`"OW"` for one way</li><li>`"RT"` for return</li></ul> | Required |
| `origin` | string (uppercase) | The IATA code (airport or city) of the origin the guest searched for. | <ul><li>`"DUB"`</li><li>`"LHR"`</li><li>`"BCN"`</li></ul> | Required |
| `destination` | string (uppercase) | The IATA code (airport or city) of the destination the guest searched for. | <ul><li>`"DUB"`</li><li>`"LHR"`</li><li>`"BCN"`</li></ul> | Required |
| `start` | string ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601))<br><br>Format: `YYYY-MM-DD’T’hh:mm` | The local departure date and time of the flight the guest searched for. | `"2026-08-21T16:17"` | Required |
| `end` | string ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601))<br><br>Format: `YYYY-MM-DD’T’hh:mm` | The local return date and time of the flight the guest searched for. | `"2026-08-28T10:00"` | Required |
| `adults` | integer<br><br>Minimum `0` | The number of adults of the flight the guest searched for. | `2` | Required |
| `children` | integer<br><br>Minimum `0` | The number of children of the flight the guest searched for. | `1` | Required |
| `infants` | integer<br><br>Minimum `0` | The number of infants of the flight the guest searched for. | `0` | Required |
| `fare_class` | string (title case) | The class of flight the guest searched for. | <ul><li>`"Economy"`</li><li>`"Premium Economy"`</li><li>`"Business"`</li><li>`"First Class"`</li></ul> | Required |
| `fare_family` | string (title case recommended) | The fare family of the flight the guest searched for. | <ul><li>`"Economy Plus"`</li><li>`"Flexi Economy"`</li></ul> | Optional |

:::
:::tab{title="2.0"}

To send a SEARCH event, use the following attributes:

| Attribute | Type | Description | Example | Required/optional |
| --- | --- | --- | --- | --- |
| `channel` | string (uppercase) | The touchpoint where the user interacts with your brand. | <ul><li>`"MOBILE_APP"`</li><li>`"MOBILE_WEB"`</li><li>`"WEB"`</li></ul> | Required |
| `type` | string (uppercase) | The type of the event that takes place when the user interacts with your brand. | `"SEARCH"` | Required |
| `language` | string (uppercase [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)) | The language the user is using your app in. | <ul><li>`"DE"`</li><li>`"EN"`</li><li>`"FR"`</li></ul> | Required |
| `currency` | string (uppercase [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217#Active_codes)) | The alphabetic currency code of the currency the user is using in your app. | <ul><li>`"EUR"`</li><li>`"GBP"`</li><li>`"USD"`</li></ul> | Required |
| `page` | string | The name of the webpage where the interaction with your brand takes place.<br><br>This is a custom value of your choice. | `"search page"` | Required |
| `pos` | string | [The name of the point of sale](https://doc.sitecore.com/cdp/en/developers/api/stream-api/direct-http-requests-reference/sending-events-1166442/collect-required-details.html#UUID-60c4c930-3cfe-e0ad-3b98-69ceff75989f_section-idm1903325950166538) where the interaction with your brand takes place. | <ul><li>`"myretailsite/ireland"`</li><li>`"spinair.com/france"`</li></ul> | Required |
| `browser_id` | string | The [browser ID](https://doc.sitecore.com/cdp/en/developers/api/stream-api/direct-http-requests-reference/sending-events-1166442/retrieve-the-browser-id.html). | `"a38b230c-11eb-4cf9-8d5d-274e9f344925​"` | Required |
| `product_name` | string | The product name the guest searched for. | `"DUB-LHR"` | Required |
| `product_type` | string (uppercase) | The product type the guest searched for. | `"FLIGHT"` | Required |
| `flight_type` | string (uppercase) | The flight type the guest searched for. | <ul><li>`"OW"` for one way</li><li>`"RT"` for return</li></ul> | Required |
| `origin` | string (uppercase) | The IATA code (airport or city) of the origin the guest searched for. | <ul><li>`"DUB"`</li><li>`"LHR"`</li><li>`"BCN"`</li></ul> | Required |
| `destination` | string (uppercase) | The IATA code (airport or city) of the destination the guest searched for. | <ul><li>`"DUB"`</li><li>`"LHR"`</li><li>`"BCN"`</li></ul> | Required |
| `start` | string ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601))<br><br>Format: `YYYY-MM-DD’T’hh:mm` | The local departure date and time of the flight the guest searched for. | `"2026-08-21T16:17"` | Required |
| `end` | string ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601))<br><br>Format: `YYYY-MM-DD’T’hh:mm` | The local return date and time of the flight the guest searched for. | `"2026-08-28T10:00"` | Required |
| `adults` | integer<br><br>Minimum `0` | The number of adults of the flight the guest searched for. | `2` | Required |
| `children` | integer<br><br>Minimum `0` | The number of children of the flight the guest searched for. | `1` | Required |
| `infants` | integer<br><br>Minimum `0` | The number of infants of the flight the guest searched for. | `0` | Required |
| `fare_class` | string (title case) | The class of flight the guest searched for. | <ul><li>`"Economy"`</li><li>`"Premium Economy"`</li><li>`"Business"`</li><li>`"First Class"`</li></ul> | Required |
| `fare_family` | string (title case recommended) | The fare family of the flight the guest searched for. | <ul><li>`"Economy Plus"`</li><li>`"Flexi Economy"`</li></ul> | Optional |

:::
::::

Example 39. SEARCH event object

```json
{
    "channel": "MOBILE_APP",
    "type": "SEARCH",
    "language": "EN",
    "currency": "EUR",
    "page": "search page",
    "pos": "myretailsite/ireland",
    "browser_id": "a38b230c-11eb-4cf9-8d5d-274e9f344925​",
    "product_name": "airSupport",
    "product_type": "RUNNERS"
}

```

Example 40. SEARCH event object for flight search

```json
{
    "channel": "MOBILE_APP",
    "type": "SEARCH",
    "language": "EN",
    "currency": "EUR",
    "page": "search page",
    "pos": "spinair.com/france",
    "browser_id": "a38b230c-11eb-4cf9-8d5d-274e9f344925​",
    "product_name": "DUB-LHR",
    "product_type": "FLIGHT",
    "flight_type": "RT",
    "origin": "DUB",
    "destination": "LHR",
    "start": "2026-01-30T00:00",
    "end": "2026-02-01T00:00",
    "adults": 2,
    "children": 1,
    "infants": 0,
    "fare_class": "Economy",
    "fare_family": "Economy Plus"
}

```