> For the complete documentation index, see [llms.txt](https://docs.sportradar.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sportradar.com/personalization/api-reference/smart-search.md).
# Smart Search
Smart search endpoints
## Get smart search results
> Returns personalized search results for sport events and casino games.\
> \
> {% hint style="info" %}\
> \
> \## For sports\
> \
> \
> The endpoint supports searches based on both participant/country/league/player\
> similarity and user preferences.The returned results are events that include\
> at least one participant/country/league/player that has string similarities with\
> the searched token. Using the \`mode\` option, the ranking of these events can\
> be based on the user preferences or on event popularity in addition to the\
> string similarity. We also support events filtering by providing a\
> score threshold.\
> \
> Only events starting between the requested time range will be considered.\
> \
> Note that the endpoint supports searching for player related markets as well.\
> For example, searching for "Salah" will return events that include markets\
> related to the player. The player markets are included in the \`markets\` field\
> of the response.\
> \
> For example:\
> \
> \`\`\`json\
> {\
> "begin": "2024-02-04T16:30:00Z",\
> "country": "England",\
> "country\_id": "sr:category:1",\
> "event\_id": "sr:match:41763283",\
> "event\_type": null,\
> "league": "Premier League",\
> "league\_id": "sr:tournament:17",\
> "markets": \[\
> {\
> "event\_id": "sr:match:41763283",\
> "id": "uof:1/sr:sport:1/38/sr:player:244391?goalnr=1",\
> "market": "goalnr=1",\
> "market\_id": null,\
> "market\_type": "First Goal Scorer",\
> "market\_type\_id": 38,\
> "outcome": "244391",\
> "player\_id": "sr:player:244391",\
> "player\_name": "Mahamed Salah",\
> "properties": {\
> "player": "Mahamed Salah",\
> "player\_id": "sr:player:244391"\
> },\
> "quote": 4,\
> "score": 0.97957602445,\
> "status": null\
> }\
> ],\
> "participant\_ids": \[\
> "sr:competitor:42",\
> "sr:competitor:44"\
> ],\
> "participants": \[\
> "Arsenal FC",\
> "Liverpool FC"\
> ],\
> "score": 0.97957602445,\
> "sport": "Soccer",\
> "sport\_id": "sr:sport:1",\
> "status": "closed"\
> }\
> \`\`\`\
> \
> {% endhint %}\
> \
> \
> {% hint style="info" %}\
> \
> \## For casino\
> \
> \
> The endpoint supports searches based on game's name, category, studio and\
> vaix tags.The returned results are casino games that include at least one\
> field that has string similarities with the searched token.\
> \
> {% endhint %}\
> \
> \
> Spelling mistakes, whitespace, typos and many more filters\
> are supported by default for sport and casino product.\
> \
> {% hint style="info" %}\
> \
> \## Picking the correct date parameters for sport events\
> \
> \
> Most of the times it is advised to use a tight date range (ex. 1 week).\
> This avoids season bets and also boosts events that are starting the\
> following days where the player may be more interested.\
> \
> {% endhint %}\
> \
> \
> {% hint style="warning" %}\
> \
> \## Search product\
> \
> \
> You must specify in which product(sport/casino) you are searching for.\
> Make sure to fill out the \`product\` query parameter.\
> \
> {% endhint %}\
````json
{"openapi":"3.0.1","info":{"title":"","version":"0.1.0"},"tags":[{"description":"Smart search endpoints","name":"Smart Search"}],"servers":[{"description":"Production API","url":"https://api.vaix.ai"},{"description":"Staging (integration) API","url":"https://staging-api.vaix.ai"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"scheme":"bearer","type":"http"}},"schemas":{"SmartSearch":{"oneOf":[{"additionalProperties":false,"description":"A smart search sport response object","properties":{"events":{"description":"A list of sport event objects","items":{"additionalProperties":false,"description":"A sport's event object","properties":{"begin":{"description":"The starting time of the event in UTC","format":"date-time","type":"string"},"country":{"description":"The country the event takes place at","nullable":true,"type":"string"},"country_id":{"description":"The id of the country the event takes place at","nullable":true,"type":"string"},"event_id":{"description":"The unique event id","type":"string"},"event_type":{"description":"The type of the event, e.g. `outright","nullable":true,"type":"string"},"league":{"description":"The league associated with the current event","nullable":true,"type":"string"},"league_id":{"description":"The id of the event's league","nullable":true,"type":"string"},"markets":{"description":"The markets of the event","items":{"additionalProperties":false,"properties":{"bet_offer_id":{"description":"The bet_offer identifier","nullable":true,"type":"string"},"market":{"description":"The market's name","nullable":true,"type":"string"},"market_id":{"description":"The market's id","nullable":true,"type":"number"},"market_type":{"description":"The market's type","nullable":true,"type":"string"},"market_type_id":{"description":"The market_type's id","nullable":true,"type":"number"},"outcome":{"description":"The selection's outcome","nullable":true,"type":"string"},"outcome_id":{"description":"The selection's outcome id","nullable":true,"type":"string"},"period":{"description":"The market's period","nullable":true,"type":"string"},"period_id":{"description":"The market's period id","nullable":true,"type":"string"},"player_id":{"description":"The player id of the related market","nullable":true,"type":"string"},"player_name":{"description":"The player name of the related market","nullable":true,"type":"string"},"properties":{"description":"Additional market properties","nullable":true,"properties":{"player":{"description":"The player name","nullable":true,"type":"string"},"player_id":{"description":"The player id","nullable":true,"type":"string"}},"type":"object"},"quote":{"description":"The selection's quote","type":"number"},"quote_group":{"description":"The selection's quote group","type":"string"},"score":{"description":"Search score for the market","type":"number"},"selection_id":{"description":"The market selection identifier","type":"string"},"status":{"description":"The market status","nullable":true,"type":"string"}},"type":"object"},"type":"array"},"participant_ids":{"description":"The id of the event participants","items":{"type":"string"},"nullable":true,"type":"array"},"participants":{"description":"The participants of the event","items":{"type":"string"},"nullable":true,"type":"array"},"score":{"description":"Search score, the highest the value the more relevant the result is.","type":"number"},"sport":{"description":"The sport of the event, e.g. `soccer`","nullable":true,"type":"string"},"sport_id":{"description":"The id of the event's sport","nullable":true,"type":"string"},"status":{"description":"The status of the event, e.g. `live`","type":"string"}},"type":"object"},"type":"array"}},"type":"object"},{"additionalProperties":false,"description":"A smart search casino response object","properties":{"games":{"description":"A list of casino game objects","items":{"additionalProperties":false,"description":"A casino game object","properties":{"game_id":{"description":"The identifier of the casino game","type":"string"},"game_image_url":{"description":"The casino game image URL","nullable":true,"type":"string"},"game_name":{"description":"The name of the casino game","type":"string"},"game_studio":{"description":"The studio of the casino game","type":"string"},"score":{"description":"Search score, the highest the value the more relevant the result is.","type":"number"},"vaix_tags":{"description":"The vaix tags for the casino game","type":"string"}},"type":"object"},"type":"array"}},"type":"object"}]},"Error":{"additionalProperties":false,"description":"The generic API's error response","properties":{"error":{"description":"Description of the error","type":"string"},"status":{"description":"response status","type":"string"}},"type":"object"},"Errors":{"additionalProperties":false,"description":"The generic API's errors response","properties":{"errors":{"description":"An object with the request errors","type":"object"}},"type":"object"},"UnprocessableEntityError":{"oneOf":[{"additionalProperties":false,"description":"The generic API's error response","properties":{"error":{"description":"Description of the error","type":"string"},"status":{"description":"response status","type":"string"}},"type":"object"},{"additionalProperties":false,"description":"The generic API's errors response","properties":{"errors":{"description":"An object with the request errors","type":"object"}},"type":"object"}]}}},"paths":{"/api/search":{"get":{"description":"Returns personalized search results for sport events and casino games.\n\n{% hint style=\"info\" %}\n\n## For sports\n\n\nThe endpoint supports searches based on both participant/country/league/player\nsimilarity and user preferences.The returned results are events that include\nat least one participant/country/league/player that has string similarities with\nthe searched token. Using the `mode` option, the ranking of these events can\nbe based on the user preferences or on event popularity in addition to the\nstring similarity. We also support events filtering by providing a\nscore threshold.\n\nOnly events starting between the requested time range will be considered.\n\nNote that the endpoint supports searching for player related markets as well.\nFor example, searching for \"Salah\" will return events that include markets\nrelated to the player. The player markets are included in the `markets` field\nof the response.\n\nFor example:\n\n```json\n{\n \"begin\": \"2024-02-04T16:30:00Z\",\n \"country\": \"England\",\n \"country_id\": \"sr:category:1\",\n \"event_id\": \"sr:match:41763283\",\n \"event_type\": null,\n \"league\": \"Premier League\",\n \"league_id\": \"sr:tournament:17\",\n \"markets\": [\n {\n \"event_id\": \"sr:match:41763283\",\n \"id\": \"uof:1/sr:sport:1/38/sr:player:244391?goalnr=1\",\n \"market\": \"goalnr=1\",\n \"market_id\": null,\n \"market_type\": \"First Goal Scorer\",\n \"market_type_id\": 38,\n \"outcome\": \"244391\",\n \"player_id\": \"sr:player:244391\",\n \"player_name\": \"Mahamed Salah\",\n \"properties\": {\n \"player\": \"Mahamed Salah\",\n \"player_id\": \"sr:player:244391\"\n },\n \"quote\": 4,\n \"score\": 0.97957602445,\n \"status\": null\n }\n ],\n \"participant_ids\": [\n \"sr:competitor:42\",\n \"sr:competitor:44\"\n ],\n \"participants\": [\n \"Arsenal FC\",\n \"Liverpool FC\"\n ],\n \"score\": 0.97957602445,\n \"sport\": \"Soccer\",\n \"sport_id\": \"sr:sport:1\",\n \"status\": \"closed\"\n}\n```\n\n{% endhint %}\n\n\n{% hint style=\"info\" %}\n\n## For casino\n\n\nThe endpoint supports searches based on game's name, category, studio and\nvaix tags.The returned results are casino games that include at least one\nfield that has string similarities with the searched token.\n\n{% endhint %}\n\n\nSpelling mistakes, whitespace, typos and many more filters\nare supported by default for sport and casino product.\n\n{% hint style=\"info\" %}\n\n## Picking the correct date parameters for sport events\n\n\nMost of the times it is advised to use a tight date range (ex. 1 week).\nThis avoids season bets and also boosts events that are starting the\nfollowing days where the player may be more interested.\n\n{% endhint %}\n\n\n{% hint style=\"warning\" %}\n\n## Search product\n\n\nYou must specify in which product(sport/casino) you are searching for.\nMake sure to fill out the `product` query parameter.\n\n{% endhint %}\n\n","operationId":"get_smart_search_results","parameters":[{"description":"Custom client header, the value should be the name of the group the user belongs to","in":"header","name":"x-vaix-client-id","required":true,"schema":{"type":"string"}},{"description":"Authentication method to be used, supported values [`vaix`, `iam`]. Defaults to `vaix`","in":"header","name":"x-vaix-authentication-method","required":false,"schema":{"type":"string"}},{"description":"The search pattern.","in":"query","name":"token","required":true,"schema":{"type":"string"}},{"description":"The product to search for.","in":"query","name":"product","required":true,"schema":{"enum":["sport","casino"],"type":"string"}},{"description":"Number of events to return.\n","in":"query","name":"count","required":false,"schema":{"default":50,"minimum":1,"type":"integer"}},{"description":"The brand of the operator.","in":"query","name":"brand","required":false,"schema":{"type":"string"}},{"description":"The minimum event's starting datetime. If not explicitly set it defaults to `now`.","in":"query","name":"from","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"How many minutes/hours/days to shift `from`. Use a negative value for a\nbackwards shift, or a positive value for a forwards shift.\nThe value must be in range [`-7d` - `7d`].\n","in":"query","name":"from_offset","required":false,"schema":{"default":"0","pattern":"^[+-]?[0-9]+([.][0-9]+)?[smhd]?$","type":"string"}},{"description":"Filters events based on their calculated score. If not set defaults to\n0.5. The value must be in range [0.0-1.0].\n","in":"query","name":"score_threshold","required":false,"schema":{"maximum":1,"minimum":0,"type":"number"}},{"description":"Considers events starting till the `from` timestamp plus the given\nminutes/hours/days. If not set defaults to one week (7 days).\nThe value must be in range [`0d` - `14`].\n","in":"query","name":"to_offset","required":false,"schema":{"default":"7d","pattern":"^[+-]?[0-9]+([.][0-9]+)?[smhd]?$","type":"string"}},{"description":"Decides whether the smart search results will be returned as is, mixed by\npopular events, or mixed by user recommendations (default). When mode is\n`recommended`, `user` must also be provided, otherwise the results will\nfall back to `popular` mode.\n","in":"query","name":"mode","required":false,"schema":{"default":"recommended","enum":["recommended","popular","unmixed"],"type":"string"}},{"description":"List of event types to consider when generating recommendations.\nOne or more types can be provided.\nAvailable options are:\n* `match`: Standard matches to be considered.\n* `seasonal`: Seasonal events to be considered.\n* `forced_events`: Handpicked events to be considered regardless of their start_time.\n","in":"query","name":"event_types","required":false,"schema":{"default":"match,forced_events","enum":["match","seasonal","forced_events"],"type":"string"}},{"description":"A mix of sports and casino filters. This parameter is useful to specify specific\nfilters on the data you want to return. The appropriate filters for the product\nin use should be applied. Sports and Casino filters cannot be mixed, otherwise\nan error response will be returned.\n","in":"query","name":"filters","required":false,"schema":{"enum":["sport","sport_id","country","country_id","league","league_id","status","booking_status","event_type","participants","participant_ids","game_id","game_studio","category","vaix_tags","tags","channels","has_megaways","is_live","has_bonus","has_buy","has_jackpot","has_sticky","has_avalanche","has_fixed","has_free_spin","has_wilds","has_gamble","has_respin","has_scatter","has_symbols_collection","has_symbols_mega","has_symbols_expanding","has_symbols_mystery","has_multiplier","has_wilds_random","has_wilds_walking","reels","rows","enabled","has_megaways","game_country","is_live","has_bonus","has_buy","has_jackpot","reels","rows","has_sticky","has_avalanche","has_fixed","has_free_spin","has_wilds","has_gamble","has_respin","has_scatter","has_symbols_collection","has_symbols_mega","has_symbols_expanding","has_symbols_mystery","has_multiplier","has_wilds_random","has_wilds_walking","vaix_game_studio","live","market","market_id","market_id_str","market_type","market_type_id","market_type_id_str","outcome","outcome_id","outcome_id_str","period_id_str","market_status","market_group_status","trade_status","trade_market_status","quote"],"type":"string"}},{"description":"The user to get recommendations for.","in":"query","name":"user","required":false,"schema":{"default":"0","type":"string"}},{"description":"The language to perform searches for. Depends on the available translations\nand will be ignored if the provided language is invalid.\n","in":"query","name":"language","required":false,"schema":{"type":"string"}},{"description":"Controls what type of results to return. Only applicable when `product=sport`.\n\nAvailable options:\n* `all` (default): Returns both event and player market results.\n* `player_markets`: Returns only player market results (e.g., searching for\n \"Salah\" will only return player-related market results).\n* `events`: Returns only event results without player markets, filtering out\n player market matches and returning only events that matched on event-level\n fields (participant, league, sport, country, etc.).\n","in":"query","name":"search_mode","required":false,"schema":{"default":"all","enum":["all","player_markets","events"],"type":"string"}},{"description":"The operator to use for querying data. Notice that this is applied only\nif your account has access to multiple operators. In a different case\nthe assigned operator to your account is used and the value of this\nfield is ignored.\n","in":"query","name":"operator","required":false,"schema":{"type":"string"}},{"description":"The bookmaker id to use for querying data. Notice that this is applied only\nif your account has access to multiple operators. In a different case\nthe assigned operator to your account is used and the value of this\nfield is ignored. Note that this parameter is used together with the\n`sub_bookmaker_id` parameter.\n","in":"query","name":"bookmaker_id","required":false,"schema":{"type":"integer"}},{"description":"The sub-bookmaker id to use for querying data. Notice that this is applied only\nif your account has access to multiple operators. In a different case\nthe assigned operator to your account is used and the value of this\nfield is ignored. Note that this parameter is used together with the\n`bookmaker_id` parameter.\n","in":"query","name":"sub_bookmaker_id","required":false,"schema":{"type":"integer"}},{"description":"Optional selection of the object fields to retrieve. It expects a comma\nseparated list of strings, as described in the field selection section,\ne.g. `markets,event_id`.\n","in":"query","name":"fields","required":false,"schema":{"default":["markets","event_id","event_type","begin","country","country_id","league","league_id","sport","sport_id","participants","participant_ids","status","score","game_id","game_name","game_studio","category","vaix_tags","tags","channels","game_image_url","has_avalanche","has_bonus","has_buy","has_jackpot","is_live","has_megaways","has_sticky","has_fixed","has_free_spin","has_wilds","has_gamble","has_respin","has_scatter","has_symbols_collection","has_symbols_mega","has_symbols_expanding","has_symbols_mystery","has_multiplier","has_wilds_random","has_wilds_walking"],"enum":["markets","event_id","event_type","begin","country","country_id","league","league_id","sport","sport_id","participants","participant_ids","status","score","game_id","game_name","game_studio","category","vaix_tags","tags","channels","game_image_url","has_avalanche","has_bonus","has_buy","has_jackpot","is_live","has_megaways","has_sticky","has_fixed","has_free_spin","has_wilds","has_gamble","has_respin","has_scatter","has_symbols_collection","has_symbols_mega","has_symbols_expanding","has_symbols_mystery","has_multiplier","has_wilds_random","has_wilds_walking","matches","rec_score"],"type":"string"}},{"description":"The location of the page where the request takes place.\n","in":"query","name":"location","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"API response","properties":{"data":{"$ref":"#/components/schemas/SmartSearch"},"status":{"description":"The status of the request","enum":["success","error"],"type":"string"}},"type":"object"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Forbidden"},"406":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"}}},"description":"Not Acceptable"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntityError"}}},"description":"Unprocessable Content"},"425":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"}}},"description":"Too Early"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get smart search results","tags":["Smart Search"]}}}}
````
## Get smart search requests
> Returns the smart search requests made by a user.\
> \
> This endpoint helps you retrieve the search queries a user has performed,\
> optionally applying filters and sorting. Supports filtering by uniqueness and without uniqueness.\
> \
> \### Example\
> \
> \`\`\`bash\
> $ curl --request GET \\\
> \--url "
> \`\`\`\
> \
> The above will return the 5 most recent search requests\
> for user user123 sorted by most recent first.\
> \
> For user 0 the endpoint returns the most recent searches or suppresses them.\
> Behavior depends on the \`fallback\_mode\` parameter:\
> \- \`fallback\_mode=ignore\` (default): Returns an empty list.\
> \- \`fallback\_mode=recent\`: Returns recent searches from all users across the system.\
> \
> \`\`\`bash\
> \# Get recent searches from all users\
> $ curl --request GET \\\
> \--url "
> \
> \# Ignore searches for all users (default behavior)\
> $ curl --request GET \\\
> \--url "
> \`\`\`
````json
{"openapi":"3.0.1","info":{"title":"","version":"0.1.0"},"tags":[{"description":"Smart search endpoints","name":"Smart Search"}],"servers":[{"description":"Production API","url":"https://api.vaix.ai"},{"description":"Staging (integration) API","url":"https://staging-api.vaix.ai"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"scheme":"bearer","type":"http"}},"schemas":{"Searches":{"additionalProperties":false,"description":"A search request object","properties":{"location":{"description":"The location of the search request","type":"string"},"raw_search_token":{"description":"The raw search token","type":"string"},"timestamp":{"description":"The timestamp of the search request","format":"date-time","type":"string"},"user_id":{"description":"The user identifier","type":"string"}},"type":"object"},"Error":{"additionalProperties":false,"description":"The generic API's error response","properties":{"error":{"description":"Description of the error","type":"string"},"status":{"description":"response status","type":"string"}},"type":"object"},"Errors":{"additionalProperties":false,"description":"The generic API's errors response","properties":{"errors":{"description":"An object with the request errors","type":"object"}},"type":"object"},"UnprocessableEntityError":{"oneOf":[{"additionalProperties":false,"description":"The generic API's error response","properties":{"error":{"description":"Description of the error","type":"string"},"status":{"description":"response status","type":"string"}},"type":"object"},{"additionalProperties":false,"description":"The generic API's errors response","properties":{"errors":{"description":"An object with the request errors","type":"object"}},"type":"object"}]}}},"paths":{"/api/search/searches":{"get":{"description":"Returns the smart search requests made by a user.\n\nThis endpoint helps you retrieve the search queries a user has performed,\noptionally applying filters and sorting. Supports filtering by uniqueness and without uniqueness.\n\n### Example\n\n```bash\n$ curl --request GET \\\n --url \"http://api.vaix.ai/api/search/searches?user=user123&order_by=-timestamp&count=5\"\n```\n\nThe above will return the 5 most recent search requests\nfor user user123 sorted by most recent first.\n\nFor user 0 the endpoint returns the most recent searches or suppresses them.\nBehavior depends on the `fallback_mode` parameter:\n - `fallback_mode=ignore` (default): Returns an empty list.\n - `fallback_mode=recent`: Returns recent searches from all users across the system.\n\n```bash\n# Get recent searches from all users\n$ curl --request GET \\\n--url \"http://api.vaix.ai/api/search/searches?user=0&fallback_mode=recent&count=10\"\n\n# Ignore searches for all users (default behavior)\n$ curl --request GET \\\n--url \"http://api.vaix.ai/api/search/searches?user=0\"\n```\n","operationId":"get_smart_search_searches","parameters":[{"description":"Custom client header, the value should be the name of the group the user belongs to","in":"header","name":"x-vaix-client-id","required":true,"schema":{"type":"string"}},{"description":"Authentication method to be used, supported values [`vaix`, `iam`]. Defaults to `vaix`","in":"header","name":"x-vaix-authentication-method","required":false,"schema":{"type":"string"}},{"description":"The user to get searches for.","in":"query","name":"user","required":false,"schema":{"default":"0","type":"string"}},{"description":"If set (default), only unique search terms will be returned.\nOtherwise all matching searches will be returned.\n","in":"query","name":"unique","required":false,"schema":{"default":true,"type":"boolean"}},{"description":"Optional filtering of the searches to retrieve.\nIt expects a string adhering to the filtering format,\nas described in the filtering section.\n\nYou can also use `days_since_search` (e.g. `days_since_search:eq:30`)\ninstead of explicit timestamp ranges.\n","in":"query","name":"filters","required":false,"schema":{"enum":["timestamp","location","days_since_search"],"type":"string"}},{"description":"The columns to sort the results by. It expects a string adhering to\nthe ordering format, as described in the ordering section, e.g.\n`+timestamp,-location`.\n","in":"query","name":"order_by","required":false,"schema":{"default":"-timestamp","enum":["timestamp","location"],"type":"string"}},{"description":"Maximum number of results.","in":"query","name":"count","required":false,"schema":{"default":20,"maximum":100,"minimum":0,"type":"integer"}},{"description":"The handling of searches when user is set to 0 (typical for logged out cases)\nor no user is provided. Available options are:\n* ignore: Return an empty list.\n* recent: Return recent searches across the site.\n","in":"query","name":"fallback_mode","required":false,"schema":{"default":"ignore","enum":["ignore","recent"],"type":"string"}},{"description":"The location of the page where the request takes place.\n","in":"query","name":"location","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"API response","properties":{"data":{"description":"Array of objects","items":{"$ref":"#/components/schemas/Searches"},"type":"array"},"status":{"description":"The status of the request","enum":["success","error"],"type":"string"}},"type":"object"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Forbidden"},"406":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"}}},"description":"Not Acceptable"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntityError"}}},"description":"Unprocessable Content"},"425":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Errors"}}},"description":"Too Early"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"summary":"Get smart search requests","tags":["Smart Search"]}}}}
````
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.sportradar.com/personalization/api-reference/smart-search.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.