Hepsiemlak Agency API returns the profile of one agency and a page of its current listings: name, logo, licence number, package, badge year, member since, rating and the public office phone numbers, then the listings in the search item shape. Narrow the listings with property_class and listing_type. An unknown agency id returns 404, 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.
4 optional filters available.
integer
Required
Agency id from autocomplete or a listing, such as 1100.
1234567890
string
Optional
housing, commercial, land, timeshare or tourist.
example
string
Optional
sale, rent, seasonal_rent, transfer_sale, transfer_rent or swap_sale.
example
integer
Optional
One-based page number, default 1. A page past the last result returns an empty list.
1
integer
Optional
Listings per page, 1 to 50, default 20.
10
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"items": [
{
"id": "1100-13220",
"url": "https://www.hepsiemlak.com/istanbul-kadikoy-goztepe-satilik/daire/1100-13220",
"area": {
"net_sqm": 92,
"gross_sqm": 128
},
"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": null,
"logo": "https://example.com/photo.jpg",
"name": "EM\u0130R EMLAK",
"phones": [
{
"type": "PHONE1",
"number": "+90212XXXXXXX",
"extension": null
}
],
"rating": null,
"package": null,
"badge_year": null,
"short_name": "EM\u0130R EMLAK",
"branded_logo": "https://example.com/photo.jpg",
"member_since": null,
"licence_number": null
},
"badges": [
"Ultra Listeleme"
],
"images": [
"https://example.com/photo.jpg",
"https://example.com/photo.jpg"
],
"bedrooms": 3,
"currency": "TRY",
"location": {
"city": "\u0130stanbul",
"county": "Kad\u0131k\u00f6y",
"district": "G\u00f6ztepe"
},
"seasonal": null,
"deed_type": "Kat M\u00fclkiyeti",
"has_video": false,
"is_shared": false,
"created_at": "2026-10-19T08:36:07Z",
"updated_at": "2026-10-24T14:36:15Z",
"building_age": 8,
"listing_type": "sale",
"price_per_sqm": 170703,
"property_type": "Daire",
"property_class": "Konut",
"building_floors": null,
"has_virtual_tour": false,
"listing_type_label": "Sat\u0131l\u0131k",
"identification_number": "1234abcd",
"energy_certificate_number": null
}
],
"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": "EM\u0130R EMLAK",
"branded_logo": null,
"member_since": null,
"licence_number": "3400107"
},
"pagination": {
"page": 1,
"total": 30,
"per_page": 5,
"returned": 5,
"total_pages": 6,
"skipped_project_cards": 0
}
},
"meta": {
"billable": true,
"endpoint_family": "agency"
},
"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": {
"agency_id": [
"The agency_id field is invalid."
]
},
"message": "The request validation failed"
}Not Found
The agency does not exist. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "agency"
},
"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": "agency"
},
"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.