> To build a Wix site agentically, follow https://www.wix.com/headless/skill.md
> 
> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# GetRecentSearches

# Package: dashboard

# Namespace: BackOfficeSearch

# Method link: https://dev.wix.com/docs/api-reference/business-management/dashboard/back-office-search/get-recent-searches.md

## Permission Scopes:
SCOPE.BACK_OFFICE.SEARCH: SCOPE.BACK_OFFICE.SEARCH

## Introduction

Retrieves the terms the calling user searched for on this site, newest first, up to 10.

Recent searches are kept per user and per site, and expire 30 days after the user last added a
term. An empty list means the user hasn't searched on
this site, cleared their recent searches, or they couldn't be read: a read failure isn't returned
as an error.

To add a term, call [Add Recent Search](https://dev.wix.com/docs/api-reference/business-management/dashboard/back-office-search/add-recent-search.md).
To remove all of them, call [Clear Recent Searches](https://dev.wix.com/docs/api-reference/business-management/dashboard/back-office-search/clear-recent-searches.md).

---

## REST API

### Schema

```
 Method: getRecentSearches
 Description: Retrieves the terms the calling user searched for on this site, newest first, up to 10.  Recent searches are kept per user and per site, and expire 30 days after the user last added a term. An empty list means the user hasn't searched on this site, cleared their recent searches, or they couldn't be read: a read failure isn't returned as an error.  To add a term, call [Add Recent Search](https://dev.wix.com/docs/api-reference/business-management/dashboard/back-office-search/add-recent-search.md). To remove all of them, call [Clear Recent Searches](https://dev.wix.com/docs/api-reference/business-management/dashboard/back-office-search/clear-recent-searches.md).
 URL: https://www.wixapis.com/back-office-search/v1/recent-searches
 Method: GET
 Return type: GetRecentSearchesResponse
  - name: searchTerms | type: array<string> | description: Recent search terms, newest first.  | validation: maxItems 10, maxLength 200


```

### Examples

### Retrieve the user's recent searches
Retrieves the terms the calling user searched for on the site, newest first.

```curl
curl -X GET \
'https://www.wixapis.com/back-office-search/v1/recent-searches' \
-H 'Authorization: <AUTH>'
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.backOfficeSearch.backOfficeSearch.getRecentSearches()
 Description: Retrieves the terms the calling user searched for on this site, newest first, up to 10.  Recent searches are kept per user and per site, and expire 30 days after the user last added a term. An empty list means the user hasn't searched on this site, cleared their recent searches, or they couldn't be read: a read failure isn't returned as an error.  To add a term, call [Add Recent Search](https://dev.wix.com/docs/api-reference/business-management/dashboard/back-office-search/add-recent-search.md). To remove all of them, call [Clear Recent Searches](https://dev.wix.com/docs/api-reference/business-management/dashboard/back-office-search/clear-recent-searches.md).
 Return type: PROMISE<GetRecentSearchesResponse>
  - name: searchTerms | type: array<string> | description: Recent search terms, newest first.  | validation: maxItems 10, maxLength 200


```

### Examples

### Retrieve the user's recent searches
Retrieves the terms the calling user searched for on the site, newest first.

```javascript
import { backOfficeSearch } from "@wix/back-office-search";

async function getRecentSearches() {
  const response = await backOfficeSearch.getRecentSearches();
}

/* Promise resolves to:
 * {
 *   "searchTerms": ["domain", "invoices"]
 * }
 */

```

### getRecentSearches (self-managed)
Self-managed SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md).

```javascript
import { createClient } from '@wix/sdk';
import { backOfficeSearch } from '@wix/back-office-search';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

const myWixClient = createClient ({
  modules: { backOfficeSearch },
  // Include the auth strategy and host as relevant
});


async function getRecentSearches() {
  const response = await myWixClient.backOfficeSearch.getRecentSearches();
};
```

---