> ## 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 facets

> Get search facets.

Get search facets.

**Credits:** 5 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`

Query. Minimum length: 1.

**category\_id** `integer`

Category id.

**market** `string` (default: uk)

Market.

**store** `string`

Store.

**country** `string`

Country.

**currency** `string`

Currency.

**language** `string`

Language.

## Response

```json theme={null}
{
  "market": "uk",
  "total_results": 13710,
  "facets": [
    {
      "id": "range",
      "name": "Sale/New Season",
      "facetValues": [
        {
          "count": 8426,
          "id": "new_season",
          "name": "New Season",
          "isSelected": false
        }
      ],
      "displayStyle": "Single-Column",
      "facetType": "TextMultiSelect",
      "hasSelectedValues": false
    }
  ]
}
```

## Example

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

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


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