--- title: "Aqarmap API: JSON data, 9 endpoints, 1 credit per call" description: "Aqarmap API for Egyptian homes for sale or rent, listing valuations, compounds, location stats and agents as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/aqarmap --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Aqarmap 1 credit per call 9 endpoints 37 datapoints # Aqarmap API Aqarmap API for Egyptian homes for sale or rent, listing valuations, compounds, location stats and agents as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below Aqarmap GET /v1/aqarmap/search?section=rent&location=36&property\_type=1&rooms=3&price\_min=10000&price\_max=30000&limit=10 ``` { "success": true, "data": { "listings": [ { "id": "7378235", "slug": "for-rent-cairo-el-maadi-hadayek-el-maadi", "url": "https://aqarmap.com.eg/en/listing/7378235/", "reference_id": 7378235, "title": "شقه للايجار بحدايق المعادي ( تقسيم المساحه ) ١٢٠ م ( ٣ غرف منها غرفه مفتوحه علي الريسيبشن / ريسيبشن", "description": "شقه للايجار بحدايق المعادي ( تقسيم المساحه )\r\n١٢٠ م ( ٣ غرف منها غرفه مفتوحه علي الريسيبشن / ريسيبشن / مطبخ / ٢حمام ) \r\nدور اول \r\nغاز / مياه / كهربا\r\nتشطيب لوكس\r\nمطلوب ١٢ الف نهائي \r\nشهر ايجار وشهر تأمين لو سنه", "section": { "id": 2, "key": "rent", "title": "For rent" }, "property_type": { "id": 1, "name": "Apartment", "plural_name": "Apartments", "slug": "apartment" }, "price": { "amount": 12000, "currency": "EGP" }, "area": { "value": 120, "unit": "sqm" }, "address": "المعادى", "location": { "id": 1200, "name": "Hadayek El Maadi", "slug": "cairo/el-maadi/hadayek-el-maadi", "full_path": "Greater Cairo / Maadi / Hadayek El Maadi", "parent": { "id": 36, "name": "Maadi", "slug": "cairo/el-maadi", "full_path": "Greater Cairo / Maadi" } }, "rooms": 3, "baths": 2, "floor": 1, "year_built": 2006, "finish_type": "LUX", "finish_type_label": "Lux", "payment_method": { "id": 1, "key": "from_owner_cash", "label": "From owner cash" }, "payment_plans": [ { "price": 12000, "total_down_payment": 0, "total_remaining_amount": 12000, "duration": 30 } ], "property_view": { "id": 11 }, "is_price_negotiable": false, "is_resale": false, "is_primary": false, "is_mortgage": false, "is_featured": false, "main_photo": { "id": 47581197, "caption": "1.jpg", "order": 1, "thumb_url": "https://img-0.aqarmap.com.eg/new-aqarmap-media/search-thumb-webp/2610/6ae54e99c0f3b772230979.jpg", "small_url": "https://img-0.aqarmap.com.eg/new-aqarmap-media/small/2610/6ae54e99c0f3b772230979.jpg", "large_url": "https://img-0.aqarmap.com.eg/new-aqarmap-media/large/2610/6ae54e99c0f3b772230979.jpg" }, "photos": [ { "id": 47581197, "caption": "1.jpg", "order": 1, "thumb_url": "https://img-0.aqarmap.com.eg/new-aqarmap-media/search-thumb-webp/2610/6ae54e99c0f3b772230979.jpg", "small_url": "https://img-0.aqarmap.com.eg/new-aqarmap-media/small/2610/6ae54e99c0f3b772230979.jpg", "large_url": "https://img-0.aqarmap.com.eg/new-aqarmap-media/large/2610/6ae54e99c0f3b772230979.jpg" } ], "photo_count": 1, "published_at": "2026-11-03T01:20:30+02:00", "updated_at": "2026-11-03T01:20:30+02:00", "latitude": 29.969, "longitude": 31.251, "featured_type": "not_featured", "has_video": false, "similar_listings_count": 0, "seller": { "id": 156320, "name": "capo ", "role": "broker" } }, { "id": "7374536", "slug": "for-rent-cairo-el-maadi-zahraa-el-maadi-eighth-neighborhood", "url": "https://aqarmap.com.eg/en/listing/7374536/", "reference_id": 7374536, "title": " For rent in Eighth Neighborhood", "description": "Residential For rent in Eighth Neighborhood with size 180 M² View Main Street", "section": { "id": 2, "key": "rent", "title": "For rent" }, "property_type": { "id": 24, "name": "Residential", "plural_name": "Residential", "slug": "skny" }, "price": { "amount": 25000, "currency": "EGP" }, "area": { "value": 180, "unit": "sqm" }, "address": "Eighth Neighborhood, Zahraa El Maadi", "location": { "id": 988, "name": "Eighth Neighborhood", "slug": "cairo/el-maadi/zahraa-el-maadi/eighth-neighborhood", "full_path": "Greater Cairo / Maadi / Zahraa El Maadi / Eighth Neighborhood", "parent": { "id": 400, "name": "Zahraa El Maadi", "slug": "cairo/el-maadi/zahraa-el-maadi", "full_path": "Greater Cairo / Maadi / Zahraa El Maadi" } }, "rooms": 3, "baths": 2, "amenities": [ "BALCONY" ], "payment_method": { "id": 1, "key": "from_owner_cash", "label": "From owner cash" }, "payment_plans": [ { "price": 25000, "total_down_payment": 0, "total_remaining_amount": 25000, "duration": 30 } ], "property_view": { "id": 2 }, "is_price_negotiable": false, "is_resale": false, "is_primary": false, "is_mortgage": false, "is_featured": false, "main_photo": { "id": 47560729, "caption": "1001443713.jpg", "order": 1, "thumb_url": "https://img-4.aqarmap.com.eg/new-aqarmap-media/search-thumb-webp/2610/6ae35d999b439513609793.jpg", "small_url": "https://img-4.aqarmap.com.eg/new-aqarmap-media/small/2610/6ae35d999b439513609793.jpg", "large_url": "https://img-4.aqarmap.com.eg/new-aqarmap-media/large/2610/6ae35d999b439513609793.jpg" }, "photos": [ { "id": 47560729, "caption": "1001443713.jpg", "order": 1, "thumb_url": "https://img-4.aqarmap.com.eg/new-aqarmap-media/search-thumb-webp/2610/6ae35d999b439513609793.jpg", "small_url": "https://img-4.aqarmap.com.eg/new-aqarmap-media/small/2610/6ae35d999b439513609793.jpg", "large_url": "https://img-4.aqarmap.com.eg/new-aqarmap-media/large/2610/6ae35d999b439513609793.jpg" }, { "id": 47560730, "caption": "1001443714.jpg", "order": 2, "thumb_url": "https://img-0.aqarmap.com.eg/new-aqarmap-media/search-thumb-webp/2610/6ae35d9a29177541703348.jpg", "small_url": "https://img-0.aqarmap.com.eg/new-aqarmap-media/small/2610/6ae35d9a29177541703348.jpg", "large_url": "https://img-0.aqarmap.com.eg/new-aqarmap-media/large/2610/6ae35d9a29177541703348.jpg" }, { "id": 47560731, "caption": "1001443710.jpg", "order": 3, "thumb_url": "https://img-4.aqarmap.com.eg/new-aqarmap-media/search-thumb-webp/2610/6ae35d9a5245b159514315.jpg", "small_url": "https://img-4.aqarmap.com.eg/new-aqarmap-media/small/2610/6ae35d9a5245b159514315.jpg", "large_url": "https://img-4.aqarmap.com.eg/new-aqarmap-media/large/2610/6ae35d9a5245b159514315.jpg" } ], "photo_count": 8, "published_at": "2026-10-29T18:00:41+03:00", "updated_at": "2026-10-29T18:00:41+03:00", "latitude": 29.97, "longitude": 31.327, "featured_type": "not_featured", "has_video": false, "similar_listings_count": 0, "seller": { "id": 5154292, "name": "Future square", "role": "broker", "logo": { "id": 32781042, "thumb_url": "https://img-1.aqarmap.com.eg/new-aqarmap-media/search-thumb/2510/68ed7e9e72c95922915619.png", "small_url": "https://img-1.aqarmap.com.eg/new-aqarmap-media/small/2510/68ed7e9e72c95922915619.png", "large_url": "https://img-1.aqarmap.com.eg/new-aqarmap-media/large/2510/68ed7e9e72c95922915619.png" } } }, { "id": "7372982", "slug": "for-rent-cairo-el-maadi-compounds-tabarak-city", "url": "https://aqarmap.com.eg/en/listing/7372982/", "reference_id": 7372982, "title": "شقة 222م ألترا سوبر لوكس للإيجار بكمبوند مدينة تبارك سيتي بالمعادي", "description": "المساحة: 222 متر مربع\r\n الدور: الخامس العلوي\r\n الحالة: بحالة الجديدة\r\n\r\n مواصفات الشقة\r\n\r\n* ريسبشن واسع جداً مكوّن من 4 قطع، مع بلكونة بإطلالة على الطريق الدائري. \r\n* 3 غرف نوم، منها غرفة ماستر. \r\n* 3 حمامات. \r\n* مطبخ مستقل. \r\n\r\n تشطيب ألتر…", "section": { "id": 2, "key": "rent", "title": "For rent" }, "property_type": { "id": 1, "name": "Apartment", "plural_name": "Apartments", "slug": "apartment" }, "price": { "amount": 25000, "currency": "EGP" }, "area": { "value": 222, "unit": "sqm" }, "address": "المعادي", "location": { "id": 973, "name": "Tabarak City", "slug": "cairo/el-maadi/compounds/tabarak-city", "full_path": "Greater Cairo / Maadi / Compounds in Maadi / Tabarak City", "parent": { "id": 399, "name": "Compounds in Maadi", "slug": "cairo/el-maadi/compounds", "full_path": "Greater Cairo / Maadi / Compounds in Maadi" } }, "rooms": 3, "baths": 3, "floor": 5, "year_built": 2000, "finish_type": "EXTRA_SUPER_LUX", "finish_type_label": "Extra super lux", "payment_method": { "id": 1, "key": "from_owner_cash", "label": "From owner cash" }, "payment_plans": [ { "price": 25000, "total_down_payment": 0, "total_remaining_amount": 25000, "duration": 30 } ], "property_view": { "id": 2 }, "is_price_negotiable": false, "is_resale": false, "is_primary": false, "is_mortgage": false, "is_featured": false, "main_photo": { "id": 47552216, "caption": "Screenshot_40.png", "order": 1, "thumb_url": "https://img-1.aqarmap.com.eg/new-aqarmap-media/search-thumb-webp/2610/6ae23fcd266e1722095066.png", "small_url": "https://img-1.aqarmap.com.eg/new-aqarmap-media/small/2610/6ae23fcd266e1722095066.png", "large_url": "https://img-1.aqarmap.com.eg/new-aqarmap-media/large/2610/6ae23fcd266e1722095066.png" }, "photos": [ { "id": 47552216, "caption": "Screenshot_40.png", "order": 1, "thumb_url": "https://img-1.aqarmap.com.eg/new-aqarmap-media/search-thumb-webp/2610/6ae23fcd266e1722095066.png", "small_url": "https://img-1.aqarmap.com.eg/new-aqarmap-media/small/2610/6ae23fcd266e1722095066.png", "large_url": "https://img-1.aqarmap.com.eg/new-aqarmap-media/large/2610/6ae23fcd266e1722095066.png" }, { "id": 47552217, "caption": "Screenshot_41.png", "order": 2, "thumb_url": "https://img-2.aqarmap.com.eg/new-aqarmap-media/search-thumb-webp/2610/6ae23fcd99f91450108067.png", "small_url": "https://img-2.aqarmap.com.eg/new-aqarmap-media/small/2610/6ae23fcd99f91450108067.png", "large_url": "https://img-2.aqarmap.com.eg/new-aqarmap-media/large/2610/6ae23fcd99f91450108067.png" }, { "id": 47552218, "caption": "Screenshot_42.png", "order": 3, "thumb_url": "https://img-4.aqarmap.com.eg/new-aqarmap-media/search-thumb-webp/2610/6ae23fcdcab41779347389.png", "small_url": "https://img-4.aqarmap.com.eg/new-aqarmap-media/small/2610/6ae23fcdcab41779347389.png", "large_url": "https://img-4.aqarmap.com.eg/new-aqarmap-media/large/2610/6ae23fcdcab41779347389.png" } ], "photo_count": 4, "published_at": "2026-10-28T21:39:27+03:00", "updated_at": "2026-10-28T21:39:27+03:00", "latitude": 29.981, "longitude": 31.333, "featured_type": "not_featured", "has_video": false, "similar_listings_count": 0, "seller": { "id": 5917325, "name": "Omnia Omran", "role": "owner" } } ] }, "meta": { "duration_ms": 1183, "endpoint_family": "search", "pagination": { "page": 1, "limit": 10, "total": 57, "total_pages": 6, "has_more": true, "next_page": 2, "truncated": false }, "filtered_out": 0, "request_id": "req_6e11d42d35cc416c88b226e5ce27e0a0", "credits_charged": 1, "credits_remaining": 1893 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | id string | slug string | url url | reference\_id integer | title string | description string | section object | property\_type object | price object | area object | address string | location object | rooms integer | baths integer | floor number | year\_built number | finish\_type string | finish\_type\_label string | payment\_method object | payment\_plans object\[\] | property\_view object | is\_price\_negotiable boolean | is\_resale boolean | is\_primary boolean | is\_mortgage boolean | is\_featured boolean | main\_photo object | photos object\[\] | photo\_count integer | published\_at string | updated\_at string | latitude number | longitude number | featured\_type string | has\_video boolean | similar\_listings\_count integer | seller object | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 7378235 | for-rent-cairo-el-maadi-hadayek-el-maadi | https://aqarmap.com.eg/en/listing/7378235/ | 7378235 | شقه للايجار بحدايق المعادي ( تقسيم المساحه ) ١٢٠ م ( ٣ غرف منها غرفه مفتوحه علي الريسيبشن / ريسيبشن | شقه للايجار بحدايق المعادي ( تقسيم المساحه ) ١٢٠ م ( ٣ غرف منها غرفه مفتوحه علي الريسيبشن / ريسيبشن / مطبخ / ٢حمام ) دور اول غاز / مياه / كهربا تشطيب لوكس مطلوب ١٢ الف نهائي شهر ايجار وشهر تأمين لو سنه | {3 fields} | {4 fields} | {2 fields} | {2 fields} | المعادى | {5 fields} | 3 | 2 | 1 | 2006 | LUX | Lux | {3 fields} | \[1 item\] | {1 fields} | false | false | false | false | false | {6 fields} | \[1 item\] | 1 | 2026-11-03T01:20:30+02:00 | 2026-11-03T01:20:30+02:00 | 29.969 | 31.251 | not\_featured | false | 0 | {3 fields} | | 2 | 7374536 | for-rent-cairo-el-maadi-zahraa-el-maadi-eighth-neighborhood | https://aqarmap.com.eg/en/listing/7374536/ | 7374536 | For rent in Eighth Neighborhood | Residential For rent in Eighth Neighborhood with size 180 M² View Main Street | {3 fields} | {4 fields} | {2 fields} | {2 fields} | Eighth Neighborhood, Zahraa El Maadi | {5 fields} | 3 | 2 | — | — | — | — | {3 fields} | \[1 item\] | {1 fields} | false | false | false | false | false | {6 fields} | \[3 items\] | 8 | 2026-10-29T18:00:41+03:00 | 2026-10-29T18:00:41+03:00 | 29.97 | 31.327 | not\_featured | false | 0 | {4 fields} | | 3 | 7372982 | for-rent-cairo-el-maadi-compounds-tabarak-city | https://aqarmap.com.eg/en/listing/7372982/ | 7372982 | شقة 222م ألترا سوبر لوكس للإيجار بكمبوند مدينة تبارك سيتي بالمعادي | المساحة: 222 متر مربع الدور: الخامس العلوي الحالة: بحالة الجديدة مواصفات الشقة \* ريسبشن واسع جداً مكوّن من 4 قطع، مع بلكونة بإطلالة على الطريق الدائري. \* 3 غرف نوم، منها غرفة ماستر. \* 3 حمامات. \* مطبخ مستقل. تشطيب ألتر… | {3 fields} | {4 fields} | {2 fields} | {2 fields} | المعادي | {5 fields} | 3 | 3 | 5 | 2000 | EXTRA\_SUPER\_LUX | Extra super lux | {3 fields} | \[1 item\] | {1 fields} | false | false | false | false | false | {6 fields} | \[3 items\] | 4 | 2026-10-28T21:39:27+03:00 | 2026-10-28T21:39:27+03:00 | 29.981 | 31.333 | not\_featured | false | 0 | {3 fields} | Recorded from our API · 3 items shown · 37 datapoints per item GET /v1/aqarmap/search?section=rent&location=36&property\_type=1&rooms=3&price\_min=10000&price\_max=30000&limit=10 37 datapoints ### Identity - id string - slug string - reference\_id integer - title string - property\_type object - finish\_type string - finish\_type\_label string - featured\_type string ### Contact - url url - seller object ### Location - area object - address string - location object - latitude number - longitude number ### Reputation - main\_photo object - photos object\[\] - photo\_count integer ### Price - price object - is\_price\_negotiable boolean ### Other - description string - section object - rooms integer - baths integer - floor number - year\_built number - payment\_method object - payment\_plans object\[\] - property\_view object - is\_resale boolean - is\_primary boolean - is\_mortgage boolean - is\_featured boolean - published\_at string - updated\_at string - has\_video boolean - similar\_listings\_count integer Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/aqarmap/search?section=rent&location=36&property_type=1&rooms=3&price_min=10000&price_max=30000&limit=10" \ -H "X-API-Key: $API_KEY" ``` Aqarmap · 9 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/aqarmap/agent`](https://perceptlayer.com/apis/aqarmap/agent) | `listing_id` +1 optional | 1 credit | | [GET `/v1/aqarmap/agents`](https://perceptlayer.com/apis/aqarmap/agents) | none +5 optional | 1 credit | | [GET `/v1/aqarmap/compounds`](https://perceptlayer.com/apis/aqarmap/compounds) | `q` +1 optional | 1 credit | | [GET `/v1/aqarmap/listing`](https://perceptlayer.com/apis/aqarmap/listing) | `id` +1 optional | 1 credit | | [GET `/v1/aqarmap/listing-children`](https://perceptlayer.com/apis/aqarmap/listing-children) | `listing_id` +1 optional | 1 credit | | [GET `/v1/aqarmap/listing-valuation`](https://perceptlayer.com/apis/aqarmap/listing-valuation) | `listing_id` +1 optional | 1 credit | | [GET `/v1/aqarmap/location-stats`](https://perceptlayer.com/apis/aqarmap/location-stats) | `location` +1 optional | 1 credit | | [GET `/v1/aqarmap/locations`](https://perceptlayer.com/apis/aqarmap/locations) | `q` +1 optional | 1 credit | | [GET `/v1/aqarmap/search`](https://perceptlayer.com/apis/aqarmap/search) | none +18 optional | 1 credit | Overview ## About the Aqarmap API ## What you can get The Aqarmap API returns Aqarmap property data for Egypt as JSON through 9 endpoints. Most take a `lang` of en or ar. - **Search:** `search` takes a `section` (sale or rent), `location`, `property_type`, `rooms`, `baths`, `price_min`, `price_max`, `area_min`, `area_max`, `finish_type` (SEMI\_FINISHED, SUPER\_LUX or WITHOUT\_FINISH), `payment_method` (1, 2 or 3), `owner_only`, `has_video`, `keyword`, `sort` (date-desc, price-asc or price-desc), `page` and `limit`. - **Listings:** `listing` takes an `id`; `listing-children`, `listing-valuation` and `agent` take a `listing_id`. - **Agents:** `agents` takes a `location`, `section` (sale or rent), `property_type` and `limit`. - **Locations and compounds:** `locations` and `compounds` take `q`; `location-stats` takes a `location`, with `property_type`. The recorded `search` ( `section=rent`, `location=36`, `property_type=1`, `rooms=3`, `price_min=10000`, `price_max=30000`, `limit=10`) returns `listings`, each with `id`, `slug`, `url`, `title`, `section`, `property_type`, `price` ( `amount`, `currency`), `area`, `location`, `rooms`, `baths`, `floor`, `finish_type_label`, `payment_method`, `payment_plans`, `is_resale`, `is_mortgage`, `photo_count`, `published_at`, `latitude`, `longitude` and `seller`. Its `meta.pagination` gives `total` (57), `total_pages`, `has_more` and `next_page`. ## How a call works Search three-room apartments to rent in Maadi: `GET /v1/aqarmap/search?section=rent&location=36&property_type=1&rooms=3&price_min=10000&price_max=30000&limit=10` with your key in the `X-API-Key` header. Find a `location` ID with `locations`; each listing's `location` also carries its `id` and its `parent` `id`. A listing's `id` goes to `listing`, and as `listing_id` to `listing-valuation`, `listing-children` and `agent`. Every successful call costs 1 credit; failed calls cost nothing. Real estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) [Batdongsan.com.vn](https://perceptlayer.com/apis/batdongsan) Use cases ### Track asking rents and sale prices in Egyptian pounds by Cairo district `Use the Aqarmap API to track asking rents and sale prices in Egyptian pounds by Cairo district` ### Check a listing's price against \`listing-valuation\` `` Use the Aqarmap API to check a listing's price against `listing-valuation` `` ### Pull area-level figures with \`location-stats\` for a market report `` Use the Aqarmap API to pull area-level figures with `location-stats` for a market report `` ### Compare finishing levels and payment plans across new and resale homes `Use the Aqarmap API to compare finishing levels and payment plans across new and resale homes` FAQ ## Questions **Do I need an Aqarmap account?** No. You call this Aqarmap API with your Perceptlayer key in the \`X-API-Key\` header, with no Aqarmap login. **How much does the Aqarmap API cost?** Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Can I get results in Arabic?** Yes. Pass \`lang=ar\` to \`search\`, \`listing\`, \`agent\`, \`agents\`, \`locations\` and the other endpoints that take it; \`lang=en\` returns English. **Should I build an Aqarmap scraper instead?** You can, but an Aqarmap scraper is code you maintain: page changes break it, requests get blocked, and Aqarmap's terms govern how you collect data. The Aqarmap API gives you 9 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the Aqarmap API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)