# Inmuebles24 Filters

Returns the filter groups and the facet codes accepted by the seller_type, room_type, services, outside, general, amenities, age and published_within parameters, so codes never need to be guessed. The vocabulary is collected from search traffic and served locally, so it never adds a charge to a search request. Right after a deploy, before any search has succeeded, the facet groups are still empty and facet_vocabulary_captured is false; the operations and property_types codes are always present.

- **Documentation:** [https://scrappa.co/docs/inmuebles24-api/inmuebles24_filters](https://scrappa.co/docs/inmuebles24-api/inmuebles24_filters)
- **API group:** Inmuebles24 API
- **Endpoint:** `GET https://scrappa.co/api/inmuebles24/filters`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/inmuebles24/filters"
```

## Example response

```json
{
    "success": true,
    "data": {
        "groups": {
            "services": {
                "36": {
                    "label": "Aire acondicionado"
                }
            }
        },
        "facet_vocabulary_captured": true,
        "operations": [
            {
                "name": "sale",
                "code": "1"
            }
        ],
        "property_types": {
            "1": "Casa"
        }
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 402 | Payment Required | The request carried neither an API key nor an x402 payment signature, so it was answered with a payment challenge before the endpoint ran. Nothing was charged. Send an X-API-KEY header, or retry with a PAYMENT-SIGNATURE. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)