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

# Get search suggestions

> Get search suggestions.

Get search suggestions.

**Credits:** 20 per successful request. Failed requests and empty result sets are not charged.

## Authentication

**X-API-Key** `string` *required*

Your ScrapeBadger API key.

## Parameters

**query** `string` *required*

Query. Minimum length: 1. Maximum length: 250.

**country** `string` (default: US)

Country.

**currency** `string` (default: USD)

Currency.

**language** `string` (default: en-US)

Language.

## Response

```json theme={null}
{
  "query": "ceramic",
  "suggestions": [
    "ceramic wall art"
  ],
  "results": [
    {
      "query": "ceramic wall art",
      "search_types": [],
      "search_type_names": []
    }
  ]
}
```

## Example

```bash theme={null}
curl --get 'https://scrapebadger.com/v1/etsy/autocomplete' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data-urlencode 'query=ceramic'
```

[Browse all Etsy endpoints](https://docs.scrapebadger.com/etsy/overview.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.