# Dubizzle Classified Search API Documentation

Search Dubizzle UAE general classifieds by text, emirate, category and price with pagination. Each result carries the price in AED, category path, location, images, the listing url and the item attributes such as model, color, storage and condition. 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_classified_search](https://scrappa.co/docs/dubizzle-api/dubizzle_classified_search)
- **API group:** Dubizzle API
- **Endpoint:** `GET https://scrappa.co/api/dubizzle/classified/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. iphone. |
| `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 starting with classified, e.g. classified/mobile-phones-pdas/mobile-phones/apple-iphone. |
| `price_min` | integer | No | Optional minimum price in AED. |
| `price_max` | integer | No | Optional maximum price in AED. |
| `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/classified/search?query=iphone&emirate=dubai&limit=3"
```

## Example response

```json
{
    "success": true,
    "data": {
        "query": "iphone",
        "results": [
            {
                "position": 1,
                "id": "9081b93b37c644f2b3cf8de25076c8ec",
                "numeric_id": 100538272,
                "vertical": "classified",
                "title": "Outstanding condition iPhone 16 Pro Max - 256GB (Desert Titanium Color), Scratch-less, 91% btry",
                "price": 3475,
                "currency": "AED",
                "url": "https://dubai.dubizzle.com/classified/mobile-phones-pdas/mobile-phones/apple-iphone/2026/10/09/outstanding-condition-iphone-16-pro-max-25-2-663---9081b93b37c644f2b3cf8de25076c8ec/",
                "images_count": 9,
                "added_at": "2026-10-15T16:02:14Z",
                "created_at": "2026-10-09T13:52:31Z",
                "is_premium": true,
                "is_verified": true,
                "images": [
                    "https://dbz-images.dubizzle.com/images/2026/10/09/07c9ec5eb4824820bd092fcc8a492d2b-.jpg?impolicy=lpc",
                    "https://dbz-images.dubizzle.com/images/2026/10/09/c1d0553c726e4e569bfe3616d8eb2a37-.jpg?impolicy=lpc"
                ],
                "emirate": "dubai",
                "location": "Jumeirah Lake Towers (JLT), JLT Cluster V, Jumeirah Business Centre 2",
                "category": "Mobile Phones & Tablets > Mobile Phones > Apple",
                "attributes": {
                    "Age": "2 Years",
                    "Model": "iPhone 16 Pro Max",
                    "Color": "Desert Titanium",
                    "Storage Capacity": "256 GB",
                    "Warranty": "Does not apply",
                    "Condition": "Pre Owned",
                    "Version": "UAE",
                    "Battery Capacity": "91%",
                    "Damages On Device": "No",
                    "Percentage Of Battery Health": "Above 85%"
                }
            }
        ],
        "pagination": {
            "page": 0,
            "limit": 3,
            "total": 6097,
            "total_pages": 2033,
            "has_more": true
        }
    },
    "meta": {
        "endpoint_family": "classified_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)