# Hepsiemlak Project API Documentation

<p><strong>Hepsiemlak Project API</strong> returns one new-build project: everything of the projects list plus the description, features and the unit plans with room layout, gross and net area and price. An unknown id returns 404, not billed.</p>

- **Documentation:** [https://scrappa.co/docs/hepsiemlak-api/hepsiemlak_project](https://scrappa.co/docs/hepsiemlak-api/hepsiemlak_project)
- **API group:** Hepsiemlak API
- **Endpoint:** `GET https://scrappa.co/api/hepsiemlak/project`

## 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 |
| --- | --- | --- | --- |
| `id` | integer | Yes | Project id from the projects route, such as 6985. |

## Example response

```json
{
    "data": {
        "id": 6985,
        "url": "https://www.hepsiemlak.com/proje/kktc-girne/mediterra-projesi-6985",
        "area": {
            "max_sqm": 205,
            "min_sqm": 90
        },
        "name": "Mediterra",
        "rooms": [
            "1+1",
            "2+1"
        ],
        "floors": {
            "max": 2,
            "min": 2
        },
        "status": {
            "sale": "Aktif Sat\u0131\u015f",
            "complex": "Premium",
            "heating": "Ba\u011f\u0131ms\u0131z",
            "parking": "A\u00e7\u0131k",
            "elevator": "Yok",
            "construction": "Proje Tamamland\u0131 - Teslim",
            "interior_finish": "Anahtar Teslim"
        },
        "address": "\u00c7a\u011fatay \u00d6zbirim Cad. - Alsancak - Girne / K\u0131br\u0131s",
        "currency": "TRY",
        "delivery": {
            "year": 2025,
            "quarter": 3
        },
        "features": [],
        "location": {
            "city": "K\u0131br\u0131s",
            "county": "Girne",
            "district": "A\u015fa\u011f\u0131 Girne"
        },
        "developer": {
            "id": null,
            "url": "https://www.hepsiemlak.com/insaat-firmalari/kibris-developments-4005",
            "name": "K\u0131br\u0131s Developments"
        },
        "min_price": null,
        "created_at": "2026-08-13T10:35:41Z",
        "unit_count": 100,
        "unit_plans": [
            {
                "price": 10000000,
                "net_sqm": 81,
                "bedrooms": 1,
                "gross_sqm": 90,
                "living_rooms": 1,
                "price_per_sqm": 111111
            },
            {
                "price": 15000000,
                "net_sqm": 105,
                "bedrooms": 2,
                "gross_sqm": 116,
                "living_rooms": 1,
                "price_per_sqm": 129310
            }
        ],
        "coordinates": {
            "latitude": 35.33910170821205,
            "longitude": 33.225612869044234
        },
        "description": "MEDITERRA, Alsancak\u2019ta avlular, bah\u00e7eler ve ortak sosyal alanlar etraf\u0131nda tasarlanm\u0131\u015f d\u00fc\u015f\u00fck n\u00fcfus yo\u011funluklu bir konut sitesidir. Akdeniz mimarisini ...",
        "image_count": 49,
        "video_count": 0,
        "price_per_sqm": null,
        "property_type": "Daire",
        "units_for_sale": null,
        "description_html": "<p>MEDITERRA, Alsancak\u2019ta avlular, bah\u00e7eler ve ortak sosyal alanlar etraf\u0131nda tasarlanm\u0131\u015f d\u00fc\u015f\u00fck n\u00fcfus yo\u011funluklu bir konut sitesidir. Akdeniz mimarisi...",
        "price_checked_at": "2026-08-12T18:00:00Z"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "project"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or outside its allowed values. This response is not billable. |
| 404 | Not Found | The project does not exist. This response is not billable. |
| 503 | Upstream Unavailable | Hepsiemlak could not be reached or capacity is busy. Retry after a short pause. 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)