# Hepsiemlak Bulk Listings API Documentation

<p><strong>Hepsiemlak Bulk Listings API</strong> opens up to 50 listings in one call. Each item has the structured fields the search route does not show: heating, fuel, bathrooms, usage status, loan eligibility, construction type, facades, deposit, interior, exterior and location features, coordinates and all photos. Use it to read the listing ids that search, map and similar return. Ids that do not exist are listed in <code>not_found_ids</code>. When no id exists the route returns 404, not billed.</p>

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

## 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 |
| --- | --- | --- | --- |
| `ids` | array | Yes | Listing ids, comma separated or repeated, 1 to 50, such as 1100-13220,1100-13209. |
| `with_description` | boolean | No | true to include the listing description text. |

## Example response

```json
{
    "data": {
        "items": [
            {
                "id": "1100-13220",
                "url": "https://www.hepsiemlak.com/istanbul-kadikoy-goztepe-satilik/daire/1100-13220",
                "area": {
                    "net_sqm": 92,
                    "gross_sqm": 128
                },
                "fuel": "Do\u011falgaz",
                "agent": {
                    "id": 1,
                    "name": "Example Agent",
                    "photo": null,
                    "phones": [
                        {
                            "type": "PHONE1",
                            "number": "+90212XXXXXXX",
                            "extension": null
                        }
                    ]
                },
                "floor": "11",
                "price": 21850000,
                "rooms": "3+1",
                "title": "EM\u0130R'DEN G\u00d6ZTEPE'DE 3+1 \u00d6N\u00dc A\u00c7IK YE\u015e\u0130LL\u0130K MARMARAY YAKINI",
                "agency": {
                    "id": 1100,
                    "url": "https://www.hepsiemlak.com/emlak-ofisi/emir-emlak-1100",
                    "logo": "https://example.com/photo.jpg",
                    "name": "EM\u0130R EMLAK",
                    "phones": [
                        {
                            "type": "PHONE1",
                            "number": "+90212XXXXXXX",
                            "extension": null
                        }
                    ],
                    "rating": 4.9,
                    "package": "Taahh\u00fctl\u00fc Gold Plus Paket",
                    "badge_year": null,
                    "short_name": "EM\u0130R EMLAK",
                    "branded_logo": null,
                    "member_since": "2006-04-03T00:00:00Z",
                    "licence_number": "3400107"
                },
                "barter": "Yap\u0131lmaz",
                "images": [
                    "https://example.com/photo.jpg",
                    "https://example.com/photo.jpg"
                ],
                "deposit": null,
                "facades": [
                    "G\u00fcney"
                ],
                "heating": "Merkezi (Pay \u00d6l\u00e7er)",
                "bedrooms": 3,
                "currency": "TRY",
                "features": {
                    "exterior": [
                        "Asans\u00f6r",
                        "Bah\u00e7e Manzaral\u0131",
                        "Bah\u00e7eli",
                        "Hidrofor"
                    ],
                    "interior": [
                        "ADSL",
                        "Ankastre Mutfak",
                        "Asans\u00f6r",
                        "\u00c7elik Kap\u0131"
                    ],
                    "location": [
                        "Cadde \u00dczerinde",
                        "Caddeye yak\u0131n"
                    ]
                },
                "location": {
                    "city": {
                        "id": 34,
                        "name": "\u0130stanbul"
                    },
                    "county": {
                        "id": 1421,
                        "name": "Kad\u0131k\u00f6y"
                    },
                    "district": {
                        "id": 12892,
                        "name": "G\u00f6ztepe"
                    }
                },
                "seasonal": null,
                "bathrooms": 2,
                "deed_type": "Kat M\u00fclkiyeti",
                "furnished": false,
                "video_url": null,
                "created_at": "2026-10-19T08:36:07Z",
                "updated_at": "2026-10-24T14:36:15Z",
                "coordinates": {
                    "latitude": 40.9802275583416,
                    "longitude": 29.06115929032134
                },
                "description": null,
                "building_age": 8,
                "listing_type": "sale",
                "usage_status": "M\u00fclk Sahibi",
                "virtual_tour": null,
                "price_per_sqm": 170703,
                "property_type": "Daire",
                "property_class": "Konut",
                "within_complex": false,
                "building_floors": 14,
                "loan_eligibility": "Uygun",
                "construction_type": "Betonarme",
                "construction_state": "\u0130kinci El",
                "listing_type_label": "Sat\u0131l\u0131k",
                "identification_number": "1234abcd",
                "energy_certificate_number": null
            }
        ],
        "returned": 2,
        "requested": 3,
        "not_found_ids": [
            "999-999"
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "listings"
    },
    "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 | None of the ids exists. 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)