APIs / Real estate / Aqarmap

1 credit per call9 endpoints37 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.

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 OKJSONX-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.

#idstringslugstringurlurlreference_idintegertitlestringdescriptionstringsectionobjectproperty_typeobjectpriceobjectareaobjectaddressstringlocationobjectroomsintegerbathsintegerfloornumberyear_builtnumberfinish_typestringfinish_type_labelstringpayment_methodobjectpayment_plansobject[]property_viewobjectis_price_negotiablebooleanis_resalebooleanis_primarybooleanis_mortgagebooleanis_featuredbooleanmain_photoobjectphotosobject[]photo_countintegerpublished_atstringupdated_atstringlatitudenumberlongitudenumberfeatured_typestringhas_videobooleansimilar_listings_countintegersellerobject
17378235for-rent-cairo-el-maadi-hadayek-el-maadihttps://aqarmap.com.eg/en/listing/7378235/7378235شقه للايجار بحدايق المعادي ( تقسيم المساحه ) ١٢٠ م ( ٣ غرف منها غرفه مفتوحه علي الريسيبشن / ريسيبشنشقه للايجار بحدايق المعادي ( تقسيم المساحه ) ١٢٠ م ( ٣ غرف منها غرفه مفتوحه علي الريسيبشن / ريسيبشن / مطبخ / ٢حمام ) دور اول غاز / مياه / كهربا تشطيب لوكس مطلوب ١٢ الف نهائي شهر ايجار وشهر تأمين لو سنه{3 fields}{4 fields}{2 fields}{2 fields}المعادى{5 fields}3212006LUXLux{3 fields}[1 item]{1 fields}falsefalsefalsefalsefalse{6 fields}[1 item]12026-11-03T01:20:30+02:002026-11-03T01:20:30+02:0029.96931.251not_featuredfalse0{3 fields}
27374536for-rent-cairo-el-maadi-zahraa-el-maadi-eighth-neighborhoodhttps://aqarmap.com.eg/en/listing/7374536/7374536 For rent in Eighth NeighborhoodResidential 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}32————{3 fields}[1 item]{1 fields}falsefalsefalsefalsefalse{6 fields}[3 items]82026-10-29T18:00:41+03:002026-10-29T18:00:41+03:0029.9731.327not_featuredfalse0{4 fields}
37372982for-rent-cairo-el-maadi-compounds-tabarak-cityhttps://aqarmap.com.eg/en/listing/7372982/7372982شقة 222م ألترا سوبر لوكس للإيجار بكمبوند مدينة تبارك سيتي بالمعاديالمساحة: 222 متر مربع الدور: الخامس العلوي الحالة: بحالة الجديدة مواصفات الشقة * ريسبشن واسع جداً مكوّن من 4 قطع، مع بلكونة بإطلالة على الطريق الدائري. * 3 غرف نوم، منها غرفة ماستر. * 3 حمامات. * مطبخ مستقل. تشطيب ألتر…{3 fields}{4 fields}{2 fields}{2 fields}المعادي{5 fields}3352000EXTRA_SUPER_LUXExtra super lux{3 fields}[1 item]{1 fields}falsefalsefalsefalsefalse{6 fields}[3 items]42026-10-28T21:39:27+03:002026-10-28T21:39:27+03:0029.98131.333not_featuredfalse0{3 fields}

Recorded from our API · 3 items shown · 37 datapoints per itemGET /v1/aqarmap/search?section=rent&location=36&property_type=1&rooms=3&price_min=10000&price_max=30000&limit=10

37 datapoints

Identity

  • idstring
  • slugstring
  • reference_idinteger
  • titlestring
  • property_typeobject
  • finish_typestring
  • finish_type_labelstring
  • featured_typestring

Contact

  • urlurl
  • sellerobject

Location

  • areaobject
  • addressstring
  • locationobject
  • latitudenumber
  • longitudenumber

Reputation

  • main_photoobject
  • photosobject[]
  • photo_countinteger

Price

  • priceobject
  • is_price_negotiableboolean

Other

  • descriptionstring
  • sectionobject
  • roomsinteger
  • bathsinteger
  • floornumber
  • year_builtnumber
  • payment_methodobject
  • payment_plansobject[]
  • property_viewobject
  • is_resaleboolean
  • is_primaryboolean
  • is_mortgageboolean
  • is_featuredboolean
  • published_atstring
  • updated_atstring
  • has_videoboolean
  • similar_listings_countinteger

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/aqarmap/agent
listing_id+1 optional
1 credit
GET/v1/aqarmap/agents
none+5 optional
1 credit
GET/v1/aqarmap/compounds
q+1 optional
1 credit
GET/v1/aqarmap/listing
id+1 optional
1 credit
GET/v1/aqarmap/listing-children
listing_id+1 optional
1 credit
GET/v1/aqarmap/listing-valuation
listing_id+1 optional
1 credit
GET/v1/aqarmap/location-stats
location+1 optional
1 credit
GET/v1/aqarmap/locations
q+1 optional
1 credit
GET/v1/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 estateJSONRESTMCP

More real estate APIs

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.