# Dubizzle Motors Search API Documentation

Search Dubizzle UAE motors listings by text, emirate, category, price, year, kilometers and seller type, with eight sort orders and pagination. Each result carries the price in AED, make, model, year, kilometers, fuel type, transmission, body type, seller type, the dealer name for dealer ads, images and the listing url. Phone numbers and seller accounts are never returned. A valid empty result is a successful, billable response.

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

## 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 |
| --- | --- | --- | --- |
| `query` | string | No | Free-text search, e.g. patrol. |
| `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/nissan/patrol. Defaults to motors/used-cars. |
| `price_min` | integer | No | Optional minimum price in AED. |
| `price_max` | integer | No | Optional maximum price in AED. |
| `year_min` | integer | No | Optional minimum model year, 1950 to 2100. |
| `year_max` | integer | No | Optional maximum model year, 1950 to 2100. |
| `kilometers_min` | integer | No | Optional minimum mileage in kilometers. |
| `kilometers_max` | integer | No | Optional maximum mileage in kilometers. |
| `seller_type` | string | No | dealer or owner. |
| `sort` | string | No | newest, oldest, price_asc, price_desc, mileage_asc, mileage_desc, year_asc or year_desc. Defaults to newest. |
| `page` | integer | No | Zero-based page number. Only the first 10000 results are reachable. Defaults to 0. |
| `limit` | integer | No | Listings per page, 1 to 100. Defaults to 25. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/dubizzle/motors/search?category=motors%2Fused-cars%2Fnissan%2Fpatrol&emirate=dubai&limit=3"
```

## Example response

```json
{
    "success": true,
    "data": {
        "results": [
            {
                "position": 1,
                "id": "949db20a1dd3453a8295d7a581dc831d",
                "numeric_id": 100341225,
                "vertical": "motors",
                "title": "2019 Nissan Patrol SE Platinum American Specs",
                "price": 65000,
                "currency": "AED",
                "url": "https://dubai.dubizzle.com/motors/used-cars/nissan/patrol/2026/09/22/2019-nissan-patrol-se-platinum-american-sp-2-485---949db20a1dd3453a8295d7a581dc831d/",
                "images_count": 7,
                "added_at": "2026-10-15T19:40:58Z",
                "created_at": "2026-09-22T19:39:47Z",
                "is_verified": true,
                "images": [
                    "https://dbz-images.dubizzle.com/images/2026/09/22/58ef31b5870040bbabfc63f984c23e5a-.jpg?impolicy=lpc",
                    "https://dbz-images.dubizzle.com/images/2026/09/22/93d9fd7b1d084f53bd0d1069438f752c-.jpg?impolicy=lpc"
                ],
                "emirate": "dubai",
                "location": "Arabian Ranches 2",
                "make": "Nissan",
                "model": "Patrol",
                "trim": "SE Platinum",
                "year": 2019,
                "kilometers": 180000,
                "fuel_type": "Petrol",
                "transmission": "Automatic Transmission",
                "body_type": "SUV",
                "regional_specs": "American Specs",
                "exterior_color": "Grey",
                "seller_type": "owner"
            }
        ],
        "pagination": {
            "page": 0,
            "limit": 3,
            "total": 557,
            "total_pages": 186,
            "has_more": true
        }
    },
    "meta": {
        "endpoint_family": "motors_search",
        "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)