Hepsiemlak Listing API returns the full record of one listing: title, price, rooms, bathrooms, gross area, the complete attribute list (heating, fuel, deed type, usage status, facade and more), feature groups, description as text and HTML, the address with place ids, breadcrumbs, coordinates, all photos, video and virtual tour, nearby places with distances, the agency with licence number and rating, the agent and seasonal rental fees. Coordinates are null when the agency hides them. An unknown id returns 404 and is not billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
string
Required
Listing id from search, such as 1100-13220.
1234567890
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"id": "1100-13220",
"url": "https://www.hepsiemlak.com/istanbul-kadikoy-goztepe-satilik/daire/1100-13220",
"area": {
"gross_sqm": 128
},
"agent": {
"id": 1,
"name": "Example Agent",
"photo": null,
"phones": [
{
"type": "PHONE1",
"number": "+90212XXXXXXX",
"extension": null
}
]
},
"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": null,
"logo": "https://example.com/photo.jpg",
"name": "EM\u0130R EMLAK",
"phones": [
{
"type": "PHONE1",
"number": "+90212XXXXXXX",
"extension": null
}
],
"rating": 4.9,
"package": "Gold",
"badge_year": 21,
"short_name": null,
"branded_logo": null,
"member_since": "2006-04-03T00:00:00Z",
"licence_number": "3400107"
},
"badges": [
"Ultra Listeleme",
"\u0130lan\u0131m G\u00fcncel"
],
"images": [
"https://example.com/photo.jpg",
"https://example.com/photo.jpg"
],
"summary": "\u0130stanbul, Kad\u0131k\u00f6y, G\u00f6ztepe Mahallesi'nde yer alan **128 m\u00b2 br\u00fct, 92 m\u00b2 net** kullan\u0131m alan\u0131na sahip **3+1 sat\u0131l\u0131k daire**, 14 katl\u0131 binan\u0131n 11. kat\u0131nd...",
"currency": "TRY",
"location": {
"city": {
"id": 34,
"name": "\u0130stanbul"
},
"county": {
"id": 1421,
"name": "Kad\u0131k\u00f6y"
},
"district": {
"id": 12892,
"name": "G\u00f6ztepe"
}
},
"seasonal": null,
"bathrooms": 2,
"is_shared": false,
"video_url": null,
"attributes": [
{
"name": "Fiyat",
"value": "21.850.000 TL"
},
{
"name": "\u0130lan No",
"value": "1100-13220"
},
{
"name": "Son G\u00fcncelleme Tarihi",
"value": "2026-10-24T14:36:15.250+0000"
},
{
"name": "\u0130lan Durumu",
"value": "Sat\u0131l\u0131k"
}
],
"updated_at": "2026-10-24T14:36:15Z",
"breadcrumbs": [
{
"url": "https://www.hepsiemlak.com/satilik",
"name": "Sat\u0131l\u0131k"
},
{
"url": "https://www.hepsiemlak.com/istanbul-satilik",
"name": "\u0130stanbul Sat\u0131l\u0131k"
}
],
"coordinates": {
"latitude": 40.9802275583416,
"longitude": 29.06115929032134
},
"description": "Emir Emlak Gayrimenkul ve Dan\u0131\u015fmanl\u0131k;\n-- TEK YETK\u0130L\u0130 --\nEM\u0130R'DEN SATILIK G\u00d6ZTEPE MAHALLES\u0130'NDE 3+1\nBR\u00dcT : 128 m2 NET : 92 m2\nMARMARAY \u0130STASYONU'NA YA...",
"listing_type": "sale",
"virtual_tour": null,
"property_type": "Daire",
"feature_groups": [
{
"items": [
"ADSL"
],
"title": "\u0130\u00e7 \u00d6zellikler"
},
{
"items": [
"Asans\u00f6r"
],
"title": "D\u0131\u015f \u00d6zellikler"
},
{
"items": [
"Cadde \u00dczerinde"
],
"title": "Konum \u00d6zellikleri"
}
],
"property_class": "Konut",
"description_html": "<p><strong style=\"font-size: 18px; background-color: rgb(255, 160, 122);\"><u>Emir Emlak Gayrimenkul ve Dan\u0131\u015fmanl\u0131k;</u></strong></p>\n<p><strong>-- TEK...",
"days_since_created": 1,
"listing_type_label": "Sat\u0131l\u0131k",
"points_of_interest": [
{
"type": "TRANSPORTATION",
"items": [
{
"name": "Elektrikli Ara\u00e7 \u015earj \u0130stasyonu - \u00c7etin Eme\u00e7 Demokrasi Park\u0131",
"distance": "649 m"
}
],
"label": "Ula\u015f\u0131m"
},
{
"type": "HEALTH_ORGANIZATIONS",
"items": [
{
"name": "Hastane - Profes\u00f6r Doktor S\u00fcleyman Yal\u00e7\u0131n \u015eehir Hastanesi",
"distance": "616 m"
}
],
"label": "Sa\u011fl\u0131k Kurumlar\u0131"
}
],
"identification_number": "1234abcd",
"energy_certificate_number": null
},
"meta": {
"billable": true,
"endpoint_family": "listing"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing or outside its allowed values. This response is not billable.
{
"errors": {
"id": [
"The id field is invalid."
]
},
"message": "The request validation failed"
}Not Found
The listing does not exist or was removed. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "listing"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested resource was not found."
},
"success": false
}Upstream Unavailable
Hepsiemlak could not be reached or capacity is busy. Retry after a short pause. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "listing"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Hepsiemlak could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.