# Yad2 Listing Details API Documentation

Return one public Yad2 real-estate listing by its token: the price in Israeli shekels with the ILS currency, the full address down to the street, house number and floor with coordinates, the property details with room count, built area, condition, entrance date, balcony, parking and top floor, the amenity flags, every image, the seller-facing description as plain text, the marketing tags and the listing dates in ISO 8601 UTC. An unknown token answers a non-billed 404.

- **Documentation:** [https://scrappa.co/docs/yad2-api/yad2_listing](https://scrappa.co/docs/yad2-api/yad2_listing)
- **API group:** Yad2 API
- **Endpoint:** `GET https://scrappa.co/api/yad2/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 |
| --- | --- | --- | --- |
| `token` | string | Yes | Listing token from a search result, for example hei3dmp5. Letters and digits only. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/yad2/listing?token=hei3dmp5"
```

## Example response

```json
{
    "success": true,
    "data": {
        "token": "hei3dmp5",
        "order_id": 57601142,
        "ad_number": 67115601,
        "ad_type": "private",
        "category_id": 2,
        "subcategory_id": 1,
        "status_id": 1,
        "price": 1950000,
        "currency": "ILS",
        "address": {
            "top_area": {
                "id": "41",
                "text": "\u05e9\u05e4\u05dc\u05d4 \u05d5\u05de\u05d9\u05e9\u05d5\u05e8 \u05d4\u05d7\u05d5\u05e3 \u05d4\u05d3\u05e8\u05d5\u05de\u05d9",
                "text_eng": "shfela"
            },
            "region": {
                "id": "2",
                "text": "\u05d3\u05e8\u05d5\u05dd",
                "text_eng": "South"
            },
            "area": {
                "id": "21",
                "text": "\u05d0\u05d6\u05d5\u05e8 \u05d0\u05e9\u05d3\u05d5\u05d3, \u05d0\u05e9\u05e7\u05dc\u05d5\u05df \u05d5\u05d4\u05e1\u05d1\u05d9\u05d1\u05d4",
                "text_eng": "ashdod_askelon"
            },
            "city": {
                "id": "7100",
                "text": "\u05d0\u05e9\u05e7\u05dc\u05d5\u05df"
            },
            "neighborhood": {
                "id": "471",
                "text": "\u05d1\u05e8\u05e0\u05e2"
            },
            "street": {
                "id": "0988",
                "text": "\u05d9\u05d5\u05e0\u05ea\u05df \u05e0\u05ea\u05e0\u05d9\u05d4\u05d5"
            },
            "house": {
                "number": 8,
                "floor": 10
            },
            "coords": {
                "lat": 31.688916,
                "lon": 34.578495
            },
            "address_master_id": 5848394
        },
        "details": {
            "property": {
                "id": "1",
                "text": "\u05d3\u05d9\u05e8\u05d4",
                "text_eng": "apartment"
            },
            "property_group": {
                "id": "1",
                "text": "\u05d3\u05d9\u05e8\u05d5\u05ea",
                "text_eng": "apartments"
            },
            "property_condition": {
                "id": "2",
                "text": "\u05de\u05e9\u05d5\u05e4\u05e5"
            },
            "rooms_count": 4,
            "square_meter": 120,
            "parking_spaces_count": 1,
            "balconies_count": 1,
            "building_top_floor": 14,
            "entrance_date": "2026-10-10",
            "is_entrance_date_flexible": true
        },
        "amenities": {
            "airconditioner": true,
            "balcony": true,
            "elevator": true,
            "parking": true,
            "security_room": true,
            "handicapped_access": true
        },
        "cover_image": "https://img.yad2.co.il/Pic/202610/10/2_1/o/y2_1pa_010545_20261010223138.jpeg",
        "images": [
            "https://img.yad2.co.il/Pic/202610/10/2_1/o/y2_1pa_010545_20261010223138.jpeg",
            "https://img.yad2.co.il/Pic/202610/10/2_1/o/y2_1pa_010921_20261010223139.jpeg"
        ],
        "description": "\u05dc\u05de\u05db\u05d9\u05e8\u05d4 \u05dc\u05dc\u05d0 \u05ea\u05d9\u05d5\u05d5\u05da  \u05d3\u05d9\u05e8\u05ea 4 \u05d7\u05d3\u05e8\u05d9\u05dd \u05de\u05e8\u05d5\u05d5\u05d7\u05ea \u05d1\u05de\u05d9\u05d5\u05d7\u05d3 \u05d1\u05de\u05e6\u05e4\u05d4 \u05d1\u05e8\u05e0\u05e2. \u05d7\u05e0\u05d9\u05d4 \u05e4\u05e8\u05d8\u05d9\u05ea \u05d1\u05d8\u05d0\u05d1\u05d5. \u05dc\u05d5\u05d1\u05d9 \u05de\u05e4\u05d5\u05d0\u05e8 \u05d52 \u05de\u05e2\u05dc\u05d9\u05d5\u05ea.",
        "shelter_distance_m": 870,
        "customer": {
            "name": "\u05e1\u05e8\u05d2\u05d9\u05d9",
            "id": 3022972
        },
        "dates": {
            "updated_at": "2026-10-15T12:02:51Z",
            "created_at": "2026-10-10T19:33:22Z",
            "ends_at": "2027-10-09T21:00:00Z",
            "rebounced_at": "2026-10-15T15:02:51Z"
        },
        "tags": [
            {
                "name": "\u05d7\u05e0\u05d9\u05d4",
                "id": 903,
                "priority": 1
            },
            {
                "name": "\u05de\u05de\"\u05d3",
                "id": 909,
                "priority": 1
            }
        ],
        "web_url": "https://www.yad2.co.il/item/hei3dmp5"
    },
    "meta": {
        "endpoint_family": "listing",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Listing Not Found | Yad2 has no listing with that token. The gateway answers its own 404, and the request is never charged. |
| 503 | Yad2 Upstream Unavailable | Yad2 could not be reached for this request after the attempt budget. Never charged. |
| 503 | Yad2 Refused | Yad2 refused every attempt for this request instead of answering with data. The response is never charged. |
| 422 | Invalid Parameter | Yad2 refused a value in this request. The request is never forwarded upstream and is never charged. |
| 502 | Parser Drift | Yad2 answered with a payload this parser does not recognise. The incident has been reported; retrying returns the same body. |

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