# Bayut Listing API Documentation

Retrieve the full record of one listing by its numeric external id: title, purpose, AED price, rooms, baths, area in square metres and square feet, agency and agent name, the amenities list, all image URLs, the location hierarchy with coordinates and the category tree. Seller phone numbers and contact persons are never returned. An unknown id is a non-billable 404.

- **Documentation:** [https://scrappa.co/docs/bayut-api/bayut_listing](https://scrappa.co/docs/bayut-api/bayut_listing)
- **API group:** Bayut API
- **Endpoint:** `GET https://scrappa.co/api/bayut/listing`

## 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 |
| --- | --- | --- | --- |
| `external_id` | string | Yes | Numeric listing id returned by the search endpoint, e.g. 16832128. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/bayut/listing?external_id=16832128"
```

## Example response

```json
{
    "success": true,
    "data": {
        "listing": {
            "id": "16832128",
            "title": "New Launch | Priority Unit | Park View",
            "url": "https://www.bayut.com/property/details-16832128.html",
            "purpose": "for-sale",
            "rooms": 0,
            "baths": 1,
            "price": {
                "amount": 680000,
                "currency": "AED"
            },
            "area": {
                "value": 37.81,
                "unit": "sqm",
                "sqft": 406.98
            },
            "agency": {
                "external_id": "102943",
                "name": "Golden Wolf Real Estate",
                "slug": "golden-wolf-real-estate-102943"
            },
            "agent_name": "Sanjiv Gangaram",
            "amenities": [
                "balcony or terrace",
                "gym or health club",
                "park view"
            ],
            "photo_count": 13,
            "created_at": "2026-10-12T18:34:03Z"
        }
    },
    "meta": {
        "endpoint_family": "listing",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A public parameter or range is invalid. This response is not billable. |
| 404 | Not Found | No listing or agency matches that id. This response is not billable. |
| 502 | Invalid Source Response | Bayut returned an unexpected response shape. This response is not billable. |
| 503 | Service Unavailable | The transport or Bayut was unavailable after retries. This response is not billable and is safe to retry. |

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