# Dubizzle Facets API Documentation

Count Dubizzle UAE listings for a vertical, grouped by emirate, category, seller type (motors) or furnished state (property). Use the same query, emirate, category and price filters as search. The result lists each value with its listing count. A valid empty result is a successful, billable response.

- **Documentation:** [https://scrappa.co/docs/dubizzle-api/dubizzle_facets](https://scrappa.co/docs/dubizzle-api/dubizzle_facets)
- **API group:** Dubizzle API
- **Endpoint:** `GET https://scrappa.co/api/dubizzle/facets`

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

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `vertical` | string | Yes | motors, property or classified. |
| `purpose` | string | No | Property only: sale or rent. Defaults to sale. |
| `segment` | string | No | Property only: residential or commercial. Defaults to residential. |
| `query` | string | No | Free-text search. |
| `emirate` | string | No | Emirate filter: dubai, abu-dhabi, sharjah, ajman, al-ain, ras-al-khaimah, umm-al-quwain or fujairah. Omit for all of the UAE. |
| `category` | string | No | Category slug path, e.g. motors/used-cars. |
| `price_min` | integer | No | Optional minimum price in AED. |
| `price_max` | integer | No | Optional maximum price in AED. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/dubizzle/facets?vertical=motors&emirate=dubai"
```

## Example response

```json
{
    "success": true,
    "data": {
        "vertical": "motors",
        "total": 34592,
        "facets": {
            "emirate": [
                {
                    "value": "dubai",
                    "count": 34592
                }
            ],
            "seller_type": [
                {
                    "value": "dealer",
                    "count": 17153
                },
                {
                    "value": "owner",
                    "count": 8272
                }
            ],
            "category": [
                {
                    "value": "motors",
                    "count": 34592
                },
                {
                    "value": "motors/used-cars",
                    "count": 25130
                }
            ]
        }
    },
    "meta": {
        "endpoint_family": "facets",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A public parameter or range is invalid. This response is not billable. |
| 503 | Service Unavailable | Dubizzle is temporarily unavailable or returned an unexpected response. Retry later. This response is not billable. |

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