# Sreality Property Detail API

Fetch one full public Sreality listing by its `hash_id`.

## Listing details

The response preserves the complete detail record, including the published description, pricing, property attributes, location, and available media. Image URLs are returned as absolute HTTPS URLs.

## Scope

This endpoint returns public listing information only. It does not expose account features, contact-form actions, saved searches, or non-public data.

- **Documentation:** [https://scrappa.co/docs/sreality-api/sreality_estate](https://scrappa.co/docs/sreality-api/sreality_estate)
- **API group:** Sreality API
- **Endpoint:** `GET https://scrappa.co/api/sreality/estate`

## 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 |
| --- | --- | --- | --- |
| `hash_id` | string | Yes | Sreality listing hash identifier, up to 64 characters. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/sreality/estate?hash_id=4c8d2f6a2f1b4c619a5f"
```

## Example response

```json
{
    "success": true,
    "data": {
        "result": {
            "hash_id": "4c8d2f6a2f1b4c619a5f",
            "advert_name": "Prodej bytu 2+kk, 58 m\u00b2, Praha 10 - Vr\u0161ovice",
            "advert_description": "Sv\u011btl\u00fd byt po rekonstrukci v klidn\u00e9 ulici.",
            "price_czk": 6890000,
            "usable_area": 58,
            "locality": {
                "city": "Praha",
                "district": "Praha 10",
                "region": "Praha",
                "gps_lat": 50.0714,
                "gps_lon": 14.4657
            },
            "advert_images": [
                "https://img1.sreality.cz/..."
            ]
        }
    },
    "meta": {
        "endpoint_family": "listing_detail",
        "billable": true,
        "retryable": false
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Listing Not Found | The listing identifier does not match a public listing. This response is not billable. |
| 422 | Validation Error | The listing identifier is missing or invalid. This response is not billable. |
| 503 | Detail Temporarily Unavailable | The listing detail could not be returned. This response is not billable. |

## Frequently asked questions

### How do I retrieve a listing?

Pass its hash_id to the listing detail endpoint. Search results include the identifier for each returned listing.

### Does this include all published listing fields?

Yes. The public detail record is returned without removing optional fields.

### What happens when a listing is unavailable?

An unknown listing returns a non-billable 404 response.

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