# Mubawab Filters API Documentation

<p><strong>Mubawab Filters API</strong> lists every value the search route accepts: countries, languages, transactions, property types, sort options and amenities. Use the <code>value</code> in requests and the <code>label</code> in your interface. The answer is fixed and costs no upstream request. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/mubawab-api/mubawab_filters](https://scrappa.co/docs/mubawab-api/mubawab_filters)
- **API group:** Mubawab API
- **Endpoint:** `GET https://scrappa.co/api/mubawab/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 response

```json
{
    "data": {
        "sorts": [
            {
                "label": "Recommended",
                "value": "default"
            },
            {
                "label": "Newest first",
                "value": "newest"
            },
            {
                "label": "Price, low to high",
                "value": "price_asc"
            },
            {
                "label": "Price, high to low",
                "value": "price_desc"
            }
        ],
        "amenities": [
            {
                "label": "Swimming pool",
                "value": "pool"
            },
            {
                "label": "Elevator",
                "value": "elevator"
            },
            {
                "label": "Garden",
                "value": "garden"
            }
        ],
        "countries": [
            {
                "label": "Morocco",
                "value": "ma"
            },
            {
                "label": "Tunisia",
                "value": "tn"
            }
        ],
        "languages": [
            {
                "label": "French",
                "value": "fr"
            },
            {
                "label": "English",
                "value": "en"
            }
        ],
        "transactions": [
            {
                "label": "For sale",
                "value": "sale"
            },
            {
                "label": "For rent",
                "value": "rent"
            }
        ],
        "property_types": [
            {
                "label": "Apartments",
                "value": "apartments"
            },
            {
                "label": "Villas and luxury homes",
                "value": "villas"
            },
            {
                "label": "Houses",
                "value": "houses"
            },
            {
                "label": "Land",
                "value": "land"
            },
            {
                "label": "Offices and shops",
                "value": "offices"
            },
            {
                "label": "Commercial premises",
                "value": "premises"
            },
            {
                "label": "Riads",
                "value": "riads"
            },
            {
                "label": "All property types (needs a location)",
                "value": "all"
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "filters"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 503 | Upstream Unavailable | Mubawab could not be reached or returned data that does not match the request. This response is not billable and is retryable. |

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