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

# List Filter Options

> Long Wallapop filter option lists — brands, models — scoped to a category or query. The option ids are the values search accepts.

The options for filters too long to inline in [`/v1/wallapop/filters`](https://docs.scrapebadger.com/api-reference/endpoint/wallapop/list-filters) — those flagged `options_endpoint: true`, such as `brand` and `model`. Pass an option `id` as the matching [search](https://docs.scrapebadger.com/api-reference/endpoint/wallapop/search-items.md) parameter, e.g. `brand=Apple`.

**Credits:** 2. Empty results are not charged.

## Authorization

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

Your ScrapeBadger API key.

## Path Parameters

**filter\_id** `string` *required*

Id of a filter flagged `options_endpoint: true` in [`/v1/wallapop/filters`](https://docs.scrapebadger.com/api-reference/endpoint/wallapop/list-filters), e.g. `brand` or `model`. Lowercase letters and underscores only, up to 40 characters; anything else returns `422`.

## Query Parameters

**category\_id** `integer`

Category to scope the options to, e.g. `100` for car makes and models.

**query** `string`

Search text to scope the options to, e.g. `iphone`.

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

`es`, `it`, or `pt`. See [`/v1/wallapop/markets`](https://docs.scrapebadger.com/api-reference/endpoint/wallapop/list-markets).

## Response

**filter\_id** `string`

Echo of the requested filter id.

**options** `FilterOption[]`

The filter's options.

**FilterOption**

**id** `string`

Option id — the value to send to search.

**title** `string | null`

Display title.

**market** `string`

The market used for the request.

## Example

```bash cURL theme={null}
curl "https://scrapebadger.com/v1/wallapop/filters/brand/options?category_id=24200&market=es" \
  -H "X-API-Key: YOUR_API_KEY"
```

```python Python theme={null}
import requests

res = requests.get(
    "https://scrapebadger.com/v1/wallapop/filters/brand/options",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"category_id": 24200, "market": "es"},
)
data = res.json()
```

```javascript Node.js theme={null}
const res = await fetch(
  "https://scrapebadger.com/v1/wallapop/filters/brand/options?" +
    new URLSearchParams({ category_id: "24200", market: "es" }),
  { headers: { "X-API-Key": process.env.SCRAPEBADGER_API_KEY } },
);
const data = await res.json();
```

```bash CLI theme={null}
scrapebadger wallapop filter-options brand --category-id 24200 --market es
```

```json Response theme={null}
{
  "filter_id": "brand",
  "options": [
    { "id": "2K", "title": "2K" },
    { "id": "2K Games", "title": "2K Games" },
    { "id": "2NLF", "title": "2NLF" },
    { "id": "3 Legged Thing", "title": "3 Legged Thing" },
    { "id": "3DMakerpro", "title": "3DMakerpro" }
  ],
  "market": "es"
}
```

> [!NOTE]
>
> Listing filter options costs **3 credits**. Empty results and failed requests are not charged.


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