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

# Search cigars

> Search the published Boxpressd cigar catalog.

Searches published cigars with deterministic ranking.

<ParamField header="x-boxpressd-key" type="string" required>
  Your developer application key.
</ParamField>

<ParamField query="q" type="string" required>
  Search text between 2 and 200 characters.
</ParamField>

<ParamField query="brand" type="string">
  Limits results to a brand name.
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Number of results from 1 through 100.
</ParamField>

<ParamField query="cursor" type="string">
  Opaque `endCursor` returned by the previous page.
</ParamField>

```bash theme={null}
curl --get "https://api.boxpressd.com/v1/cigars/search" \
  --header "x-boxpressd-key: $BOXPRESSD_DEVELOPER_API_KEY" \
  --data-urlencode "q=liga privada" \
  --data-urlencode "limit=20"
```

The response contains a `data` array and `pagination` with `hasNextPage` and `endCursor`.