> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openbridge.shop/llms.txt
> Use this file to discover all available pages before exploring further.

# .search()

> Search products by query

```javascript theme={null}
openbridge.products.list().search(query)
```

Searches products by a text query.

## Parameters

| Param   | Type     | Required | Description         |
| ------- | -------- | -------- | ------------------- |
| `query` | `string` | Yes      | Search query string |

## Returns

`ProductListBuilder` (chainable)

## Examples

### Basic search

```javascript theme={null}
const { items } = await openbridge.products.list().search('cotton shirt')
```

### With limit

```javascript theme={null}
const { items } = await openbridge.products
    .list()
    .search('blue')
    .limit(20)
```

### With field selection

```javascript theme={null}
const { items } = await openbridge.products
    .list()
    .search('summer dress')
    .limit(10)
    .select(['title', 'handle', 'priceRange', 'featuredImage'])
```

### Search within collection

```javascript theme={null}
const { items } = await openbridge.products
    .list()
    .collection('womens')
    .search('dress')
    .limit(12)
```