Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) API page →
Real Estate

Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) API & Scraper

The Property Finder API returns property listings for sale and rent from propertyfinder.ae (United Arab Emirates), propertyfinder.sa (Saudi Arabia), propertyfinder.qa (Qatar), propertyfinder.bh (Bahrain) and propertyfinder.eg (Egypt) as JSON, with the agent's phone and WhatsApp, plus UAE sale and rent transactions, area guides, new projects and the agent and agency directories.

18 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

It reads all five portals logged out; pick one with country=ae, sa, qa, bh or eg. `search` takes the same filters the site offers (location, property type, bedrooms, bathrooms, price, size, plot size, price per area, furnishing, ready or off-plan, rent period, keyword, amenities, listing age, video or 360 tours, deal badges, handover date, payment plan, cheques, a point and radius) with 10 sort orders, 25 listings per page by default and up to 60, pages 1 to 50, and the site's own total: on 2026-11-15 the UAE had 183,708 listings for sale and 165,618 for rent, Egypt 171,316 for sale. Every search call reads the site's current results. `property` returns one listing in full: price and period, price per sqft, size, rooms, the description, every photo, amenities, the permit validation link, the agent and the agency with their phone, WhatsApp and e-mail as published, the agency's licence, the local price trend, the price comparison with the area and mortgage rates. `transactions` returns Dubai Land Department sales and rent contracts by area with a market summary (157,939 sales in Dubai in the last 12 months); transactions are published for the UAE only. `area` and `area_reviews` return the site's area guides and resident reviews; `projects`, `project`, `developers` and `developer` cover new off-plan projects; `agents`, `agent`, `agencies` and `agency` read the agent and agency directories, with each one's live listings.

Reference

What a Property Finder field actually contains

Fields that read differently from how they look. Every row was measured against live Property Finder data on 2026-11-15.

FieldWhat it holds
price, price_periodThe headline price the listing page prints, with its period: sell for sales, yearly / monthly / weekly / daily for rents. On 20 listings across five countries and five categories, 19 of 19 pages that print a price matched the search row and the listing exactly; the 20th page printed no price element and its own data held the same figure.
results vs spotlight vs projectsA search page mixes three kinds of rows. results are the ranked listings that total counts; spotlight are paid listings the site pins on top of page 1 (5 on the first UAE page, none on page 2); projects are new-project cards placed between listings. They come back in separate lists.
sortfeatured is the site's default order and re-ranks between calls, so two pages of a featured search can share listings. newest lists the latest first; pages 1 to 3 of UAE rent and sale searches returned 0 repeated listings, and the order moves by the listings added between two page calls. The price and bedrooms sorts page without gaps (0 repeats over 3 pages).
size, size_unitThe listing's size in the unit of its portal: sqft on propertyfinder.ae, sqm on .sa, .qa, .bh and .eg. Egyptian and Bahraini pages print both (2,368 sqft / 220 sqm) and the field carries the sqm figure. 20 of 20 matched the page.
price_per_areaThe listing's price per sqft (UAE) or sqm. Set on sales; rent listings carry none (0 of 116 rent rows measured).
agent, agency, contactThe agent (name, photo, position, languages, experience, listing count) and the agency (name, address, phone, e-mail, licence, agent count) as the listing publishes them. contact holds the listing's phone and WhatsApp numbers: present on 861 of 861 listings measured. The site publishes no e-mail in contact or on the agent (empty on every row); the agency e-mail is there on every row.
permitUAE listings carry the Dubai Land Department permit validation link and the issuing broker licence (11 of 13 UAE listing pages); the permit number itself is not on the page.
listed_at, available_fromlisted_at is the page's "Listed" date; available_from is "Available from". The source's last-refreshed date is empty on every listing measured and is returned as null.
transactions: price, sold_by, statusEach row is one Dubai Land Department transaction: the price, price per sqft, size, unit number, date, ready or off-plan, sold by developer or individual (sales), new or renewed (rent contracts), with the previous price and the change where the unit sold before.

Search serves pages 1 to 50 of any query, 25 listings per page by default and up to 60 (at most 3,000 listings); narrow the filters to reach more. Transactions serve the first 500 rows of a query.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/propertyfinder/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "location_ids": "1",
    "category": "buy",
    "sort": "newest"
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "propertyfinder",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 665.7,
    "record_count": 25,
    "bytes": 209279,
    "cache_hit": false,
    "upstream_requests": 1,
    "total": 113129,
    "spotlight_rows": 0,
    "project_cards": 5,
    "charged_credits": 1,
    "version": "1.0.1",
    "request_id": "7ed5780bdd6f4e01",
    "fetched_at": "2026-11-15T22:38:35.222Z"
  },
  "data": {
    "country": "ae",
    "location": null,
    "results": [
      {
        "id": "173780707",
        "listing_ref": "MCC-S-77757-WD",
        "url": "https://www.propertyfinder.ae/en/plp/buy/apartment-for-sale-dubai-jumeirah-village-triangle-district-4-belmont-residences-173780707.html",
        "title": "Brand New | Luxury 1BR | Premium Finishes",
        "description": "Property Highlights:\n\n- Built-Up Area: 829 sq. ft.\n- 1 Bedroom, 2 Bathrooms\n- Unfurnished\n- Ellington - Belmont Residences\n- Secondary Off-Plan Resale\n\nCommunity and Lifestyle Amenities:\n\n- Lap pool with sun loungers\n- Outdoor and indoor fitness areas\n- Yoga area and climbing walls\n- Indoor and outdoor kids' play areas\n- Courtyard and lounge area\n- Library wall and reading nook\n- EV charging station\n- Bicycle parking with maintenance stand\n- 24-hour security and CCTV\n- Landscaped community parks\n- Basketball and tennis courts\n\nLocation and Connectivity:\n\nBelmont Residences sits within Jumeirah",
        "category": "buy",
        "offering_type": "Residential for Sale",
        "property_type": "Apartment",
        "property_type_id": 1,
        "price": 1400000,
        "currency": "AED",
        "price_period": "sell",
        "price_hidden": false,
        "price_per_area": 1688,
        "price_per_area_unit": "sqft",
        "price_per_plot_area": null,
        "bedrooms": "1",
        "bedrooms_count": 1,
        "bathrooms": "2",
        "bathrooms_count": 2,
        "rooms": null,
        "rooms_count": null,
        "size": 829,
        "size_unit": "sqft",
        "plot_size": null,
        "furnished": "NO",
        "completion_status": "off_plan",
        "listed_at": "2026-11-15T22:32:46Z",
        "last_refreshed_at": null,
        "location": {
          "id": "12576",
          "name": "Belmont Residences",
          "full_name": "Belmont Residences, District 4, Jumeirah Village Triangle, Dubai",
          "type": "TOWER",
          "path": "1.74.16200.12576",
          "path_name": "Dubai, Jumeirah Village Triangle, District 4",
          "slug": "jumeirah-village-triangle-district-4-belmont-residences",
          "latitude": 25.0447,
          "longitude": 55.195,
          "insights_url": null
        },
        "location_tree": [
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]",
            "type": "[trimmed-depth]",
            "slug": "[trimmed-depth]",
            "level": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]",
            "type": "[trimmed-depth]",
            "slug": "[trimmed-depth]",
            "level": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]",
            "type": "[trimmed-depth]",
            "slug": "[trimmed-depth]",
            "level": "[trimmed-depth]"
          }
        ],
        "images": [
          {
            "full": "[trimmed-depth]",
            "medium": "[trimmed-depth]",
            "small": "[trimmed-depth]",
            "thumbnail": "[trimmed-depth]",
            "label": "[trimmed-depth]"
          },
          {
            "full": "[trimmed-depth]",
            "medium": "[trimmed-depth]",
            "small": "[trimmed-depth]",
            "thumbnail": "[trimmed-depth]",
            "label": "[trimmed-depth]"
          },
          {
            "full": "[trimmed-depth]",
            "medium": "[trimmed-depth]",
            "small": "[trimmed-depth]",
            "thumbnail": "[trimmed-depth]",
            "label": "[trimmed-depth]"
          }
        ],
        "images_count": 30,
        "video_url": null,
        "view_360_url": null,
        "floor_plans": [],
        "amenities": [
          {
            "code": "[trimmed-depth]",
            "name": "[trimmed-depth]"
          },
          {
            "code": "[trimmed-depth]",
            "name": "[trimmed-depth]"
          },
          {
            "code": "[trimmed-depth]",
            "name": "[trimmed-depth]"
          }
        ],
        "agent": {
          "id": "277471",
          "name": "Hunter Steele Newman",
          "slug": "hunter-steele-newman",
          "profile_url": "https://www.propertyfinder.ae/en/agent/hunter-steele-newman-277471",
          "image": "https://static.shared.propertyfinder.ae/media/images/agent_image/277471/0e880613-335f-4731-91f7-995ee78efb5d/260x200.jpg?v=87d3b5c00fc768898a2c8324a0791a68",
          "email": null,
          "position": null,
          "languages": [
            "[trimmed-depth]"
          ],
          "is_super_agent": true,
          "user_id": 128204,
          "years_of_experience": null,
          "total_properties": null,
          "transactions_count": null,
          "avg_whatsapp_response_time_min": null,
          "rating_breakdown": null
        },
        "agency": {
          "id": "911",
          "name": "McCone Properties",
          "slug": "mccone-properties-1012",
          "profile_url": "https://www.propertyfinder.ae/en/broker/mccone-properties-1012-911",
          "logo": "https://static.shared.propertyfinder.ae/media/images/client_logos/911/8b27ba77-fbed-4146-bdb0-d2156103f6d3/260x200.jpg",
          "address": "Office 305, Building Onyx Tower 2, The Greens, n/a, Dubai,",
          "email": "[redacted-email]",
          "phone": "[redacted-phone]",
          "license_number": null,
          "total_properties": null,
          "total_agents": null,
          "total_super_agents": null,
          "is_exclusive": null
        },
        "contact": {
          "phone": "[redacted-phone]",
          "whatsapp": "[redacted-phone]",
          "whatsapp_link": "https://api.whatsapp.com/send?phone=+97145560345&text=Hello%2C%0AI+would+like+to+get+more+information+about+this+property%3A+%0A+%0AReference%3A+MCC-S-77757-WD%0AType%3A+Apartment%0APrice%3A+1%2C400%2C000+AED+%0ALocation%3A+Belmont+Residences+%0ALink%3A+https%3A%2F%2Fwww.propertyfinder.ae%2Fto%2F173780707%2Fen+%0A+%0AAny+changes+made+to+this+message+will+result+in+the+enquiry+not+being+sent+to+the+agent.",
          "email": null
        },
        "permit": null,
        "listing_level": "standard",
        "payment_methods": [],
        "utilities_price_type": "notSelected",
        "mortgage_cashback": 0,
        "live_viewing": null,
        "travel_time_tags": [],
        "flags": {
          "verified": true,
          "direct_from_developer": false,
          "new_construction": false,
          "available": true,
          "featured": false,
          "premium": false,
          "new_insert": true,
          "community_expert": false,
          "cts": false,
          "has_view_360": false,
          "exclusive": false,
          "broker_project_property": false,
          "smart_ad": false,
          "spotlight_listing": false,
          "claimed_by_agent": false,
          "under_offer_by_competitor": false,
          "pf_exclusive": false,
          "fhm": false,
          "upgraded": false,
          "extended": false,
          "landscaped": false,
          "great_value": false,
          "high_demand": false,
          "luxe": false,
          "price_drop": false
        },
        "ranking": {
          "rank_score": 93.76185607910156,
          "quality_score": 100,
          "rsp": 93.761856,
          "rss": 93.761856,
          "lead_value": 100
        },
        "position": 1
      },
      {
        "id": "173780678",
        "listing_ref": "MCC-S-80869-RN",
        "url": "https://www.propertyfinder.ae/en/plp/buy/apartment-for-sale-dubai-jumeirah-village-circle-district-12-catch-residences-by-igo-173780678.html",
        "title": "Fully Furnished | High Floor | Spacious",
        "description": "Property Highlights:\n\n- Built-Up Area: 1,624 sq. ft.\n- 2 Bedrooms, 3 Bathrooms\n- Fully Furnished\n- High Floor\n- Spacious Layout\n- Vacant, Move in Now\n- IGO - Catch Residences, JVC\n\nCommunity and Lifestyle Amenities:\n\n- Resort-style infinity pool with waterfall feature\n- Miami-style sun deck with cabanas and loungers\n- Dedicated children's swimming pool\n- Fully equipped modern fitness centre\n- Outdoor BBQ and garden deck\n- Indoor games and recreation zone\n- Family entertainment spaces\n- 24/7 security and CCTV monitoring\n- Covered parking\n- Pet-friendly building\n- Landscaped parks and jogging pa",
        "category": "buy",
        "offering_type": "Residential for Sale",
        "property_type": "Apartment",
        "property_type_id": 1,
        "price": 1900000,
        "currency": "AED",
        "price_period": "sell",
        "price_hidden": false,
        "price_per_area": 1169,
        "price_per_area_unit": "sqft",
        "price_per_plot_area": null,
        "bedrooms": "2",
        "bedrooms_count": 2,
        "bathrooms": "3",
        "bathrooms_count": 3,
        "rooms": null,
        "rooms_count": null,
        "size": 1624,
        "size_unit": "sqft",
        "plot_size": null,
        "furnished": "YES",
        "completion_status": "completed",
        "listed_at": "2026-11-15T22:31:14Z",
        "last_refreshed_at": null,
        "location": {
          "id": "11662",
          "name": "Catch Residences By IGO",
          "full_name": "Catch Residences By IGO, District 12, Jumeirah Village Circle, Dubai",
          "type": "TOWER",
          "path": "1.[redacted-phone]",
          "path_name": "Dubai, Jumeirah Village Circle, District 12",
          "slug": "jumeirah-village-circle-district-12-catch-residences-by-igo",
          "latitude": 25.0557,
          "longitude": 55.2205,
          "insights_url": null
        },
        "location_tree": [
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]",
            "type": "[trimmed-depth]",
            "slug": "[trimmed-depth]",
            "level": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]",
            "type": "[trimmed-depth]",
            "slug": "[trimmed-depth]",
            "level": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]",
            "type": "[trimmed-depth]",
            "slug": "[trimmed-depth]",
            "level": "[trimmed-depth]"
          }
        ],
        "images": [
          {
            "full": "[trimmed-depth]",
            "medium": "[trimmed-depth]",
            "small": "[trimmed-depth]",
            "thumbnail": "[trimmed-depth]",
            "label": "[trimmed-depth]"
          },
          {
            "full": "[trimmed-depth]",
            "medium": "[trimmed-depth]",
            "small": "[trimmed-depth]",
            "thumbnail": "[trimmed-depth]",
            "label": "[trimmed-depth]"
          },
          {
            "full": "[trimmed-depth]",
            "medium": "[trimmed-depth]",
            "small": "[trimmed-depth]",
            "thumbnail": "[trimmed-depth]",
            "label": "[trimmed-depth]"
          }
        ],
        "images_count": 28,
        "video_url": null,
        "view_360_url": null,
        "floor_plans": [],
        "amenities": [
          {
            "code": "[trimmed-depth]",
            "name": "[trimmed-depth]"
          },
          {
            "code": "[trimmed-depth]",
            "name": "[trimmed-depth]"
          },
          {
            "code": "[trimmed-depth]",
            "name": "[trimmed-depth]"
          }
        ],
        "agent": {
          "id": "277471",
          "name": "Hunter Steele Newman",
          "slug": "hunter-steele-newman",
          "profile_url": "https://www.propertyfinder.ae/en/agent/hunter-steele-newman-277471",
          "image": "https://static.shared.propertyfinder.ae/media/images/agent_image/277471/0e880613-335f-4731-91f7-995ee78efb5d/260x200.jpg?v=87d3b5c00fc768898a2c8324a0791a68",
          "email": null,
          "position": null,
          "languages": [
            "[trimmed-depth]"
          ],
          "is_super_agent": true,
          "user_id": 128204,
          "years_of_experience": null,
          "total_properties": null,
          "transactions_count": null,
          "avg_whatsapp_response_time_min": null,
          "rating_breakdown": null
        },
        "agency": {
          "id": "911",
          "name": "McCone Properties",
          "slug": "mccone-properties-1012",
          "profile_url": "https://www.propertyfinder.ae/en/broker/mccone-properties-1012-911",
          "logo": "https://static.shared.propertyfinder.ae/media/images/client_logos/911/8b27ba77-fbed-4146-bdb0-d2156103f6d3/260x200.jpg",
          "address": "Office 305, Building Onyx Tower 2, The Greens, n/a, Dubai,",
          "email": "[redacted-email]",
          "phone": "[redacted-phone]",
          "license_number": null,
          "total_properties": null,
          "total_agents": null,
          "total_super_agents": null,
          "is_exclusive": null
        },
        "contact": {
          "phone": "[redacted-phone]",
          "whatsapp": "[redacted-phone]",
          "whatsapp_link": "https://api.whatsapp.com/send?phone=+97145560345&text=Hello%2C%0AI+would+like+to+get+more+information+about+this+property%3A+%0A+%0AReference%3A+MCC-S-80869-RN%0AType%3A+Apartment%0APrice%3A+1%2C900%2C000+AED+%0ALocation%3A+Catch+Residences+By+IGO+%0ALink%3A+https%3A%2F%2Fwww.propertyfinder.ae%2Fto%2F173780678%2Fen+%0A+%0AAny+changes+made+to+this+message+will+result+in+the+enquiry+not+being+sent+to+the+agent.",
          "email": null
        },
        "permit": null,
        "listing_level": "standard",
        "payment_methods": [],
        "utilities_price_type": "notSelected",
        "mortgage_cashback": 0,
        "live_viewing": null,
        "travel_time_tags": [],
        "flags": {
          "verified": true,
          "direct_from_developer": false,
          "new_construction": false,
          "available": true,
          "featured": false,
          "premium": false,
          "new_insert": true,
          "community_expert": false,
          "cts": false,
          "has_view_360": false,
          "exclusive": false,
          "broker_project_property": false,
          "smart_ad": false,
          "spotlight_listing": false,
          "claimed_by_agent": false,
          "under_offer_by_competitor": false,
          "pf_exclusive": false,
          "fhm": false,
          "upgraded": false,
          "extended": false,
          "landscaped": false,
          "great_value": false,
          "high_demand": false,
          "luxe": false,
          "price_drop": false
        },
        "ranking": {
          "rank_score": 93.76264953613281,
          "quality_score": 100,
          "rsp": 93.76265,
          "rss": 93.76265,
          "lead_value": 100
        },
        "position": 2
      },
      {
        "id": "173780534",
        "listing_ref": "MCC-S-52731-VE",
        "url": "https://www.propertyfinder.ae/en/plp/buy/villa-for-sale-dubai-dubai-islands-bay-villas-173780534.html",
        "title": "Semi-detached | Biggest Layout | Best Location",
        "description": "Bay Villas | Dubai Islands\n\nProperty highlights:\n• PLOT - 3,934 SQFT\n• BUA - 4,233 SQFT\n• 4 & 5 Bedroom Contemporary Villas\n• Expansive Living & Dining Areas\n• Large Terraces & Private Garden\n• Maid’s Room\n• Covered Parking\n• High-quality Finishing\n• Prime Location within the Community\n\nExperience elevated waterfront living in Bay Villas, one of the most anticipated villa communities on Dubai Islands. Surrounded by pristine beaches and open sea views, this is where privacy, luxury and future growth come together.\n\nThese modern villas are thoughtfully designed with spacious layouts, floor-to-ce",
        "category": "buy",
        "offering_type": "Residential for Sale",
        "__trimmed": "response capped for page display"
      }
    ],
    "spotlight": [],
    "__trimmed": "response capped for page display"
  },
  "__trimmed": "response capped for page display"
}
Actions

What the Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) API does

ActionDescriptionConcrete use caseKey params
locationsLook up places by name on one Property Finder portal and get the location ids every other action accepts: cities, communities, sub-communities and buildings, with coordinates, review score and the area-guide link.Real-estate investors call locations to look up places by name on one Property Finder portal and get the location ids every other act….query, country, language, page, page_size
searchSearch Property Finder listings on one portal with every filter and sort the site's own search takes, paged with the site's total. `results` are the ranked listings that `total` counts; `spotlight` holds the paid listings the site pins on top of every page, `projects` the new-project cards it mixes in.Brokerage tools call search to search Property Finder listings on one portal with every filter and sort the site's own searc….country, language, category, location, location_ids, ...
propertyEverything one listing page shows: price, price per area, size, rooms, furnishing, completion, the full description, every photo (and the community / building photos), amenities, the permit / RERA number and validation link, the agent and the agency with phone, WhatsApp and e-mail as published, the property and regulatory detail tables, local price trends (1 / 2 / 5 years), the price comparison against the area, similar sold / rented transactions and mortgage rates.Property dashboards call property to get everything one listing page shows.property_id, country, language
price_trendsPrice trend of a community or building for one property type and bedroom count: monthly price per area (sale) or yearly rent, community line and building line, over 1, 2 and 5 years.Lead-generation teams call price_trends to get price trend of a community or building for one property type and bedroom count.location_id, country, language, category, property_type, ...
transactionsUAE (Dubai Land Department data as Property Finder publishes it): sold or rented transactions in a city, community or building with the market summary (average and median price, price per sqft, volume, yield, monthly trend). Filters: property type, bedrooms, price, size, period, seller (developer / individual), completion, new or renewed rent contracts, unit number.Real-estate investors call transactions to get uAE (Dubai Land Department data as Property Finder publishes it).location_id, category, property_type, bedrooms, min_price, ...
areaThe site's area guide for a city, community or building: description, key facts, FAQs, getting around, schools, nearby places (counts and named places), demographics of renters, market insights (average sale price, price per sqft, yield, transaction volume), median prices per property type and bedroom count, price histogram, review summary with the latest reviews, popular buildings, similar communities and photos.Brokerage tools call area to get the site's area guide for a city, community or building.area, country, language
area_reviewsResident reviews of a community or building (the area guide's reviews), paged and sortable, with the score per category (traffic, quiet, parks, family, maintenance, parking, amenities).Property dashboards call area_reviews to get resident reviews of a community or building (the area guide's reviews), paged and sortable, w….location_id, country, language, sort, page, ...
projectsNew (off-plan) projects on one portal, paged as the site's new-projects search shows them: name, developer, location, starting price and price range, bedrooms, property types, handover date, construction and sales phase, payment plans, down payment, amenities. Filters: location, developer, property type, bedrooms, price, handover date, ready / off-plan, post-handover payment plan.Lead-generation teams call projects to get new (off-plan) projects on one portal, paged as the site's new-projects search shows them.country, language, location_id, developer_id, property_type, ...
projectOne new project: description, developer, master plan, location with coordinates, starting price and price range, unit types with sizes and prices, payment plans, handover and construction timeline, amenities, images, brochure, FAQs, agents marketing it, recent sales in the building and similar projects.Real-estate investors call project to get one new project.project, country, language
developersFind property developers (and their projects) by name with the site's new-projects autocomplete.Brokerage tools call developers to find property developers (and their projects) by name with the site's new-projects autocomplete..query, country, language, page_size
developerA developer's page: profile (description, established since, projects online, logo), the developer's projects (first page, paged with `page`) and the per-city project counts.Property dashboards call developer to get a developer's page.developer, country, language, page
agentsSearch the portal's agent directory: by name, area, language, nationality, service, property type, SuperAgent; paged with the site's total.Lead-generation teams call agents to search the portal's agent directory.country, language, name, location_id, spoken_language, ...
agentOne agent's public profile: bio, position, nationality, languages, experience, licence, listing counts by type, rating and review count with the distribution, WhatsApp response time, top locations, claimed transactions and the agency.Real-estate investors call agent to get one agent's public profile.agent_id, country, language
agent_listingsEvery live listing of one agent, paged, with the same filters and sorting as `search`.Brokerage tools call agent_listings to get every live listing of one agent, paged, with the same filters and sorting as `search`..agent_id, country, language, category, location, ...
agenciesSearch the portal's agency (real-estate company) directory by name, area and service; paged with the site's total.Property dashboards call agencies to search the portal's agency (real-estate company) directory by name, area and service; paged w….country, language, name, location_id, service, ...
agencyOne agency's profile: name, licence, phone, e-mail, address, description, logo, listing counts by type, number of agents and SuperAgents, awards, branches.Lead-generation teams call agency to get one agency's profile.agency_id, country, language
agency_agentsEvery agent of one agency, paged with the site's total.Real-estate investors call agency_agents to get every agent of one agency, paged with the site's total..agency_id, country, language, sort, page, ...
agency_listingsEvery live listing of one agency, paged, with the same filters and sorting as `search`.Brokerage tools call agency_listings to get every live listing of one agency, paged, with the same filters and sorting as `search`..agency_id, country, language, category, location, ...
Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/propertyfinder/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"location_ids":"1","category":"buy","sort":"newest"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.propertyfinder.search with {"location_ids":"1","category":"buy","sort":"newest"}.
Use cases

Who uses this API and why

  • Track asking prices and rents per community in Dubai, Abu Dhabi, Riyadh, Doha, Manama and Cairo.
  • Compare asking prices with Dubai Land Department transactions for the same building.
  • Build a lead list of agents and agencies with their phone, WhatsApp, licence and live listing counts.
  • Monitor new listings and price drops with sort=newest and the price_drop badge.
  • Collect off-plan projects with developer, payment plans, handover dates and starting prices.
FAQ

Questions developers ask before integrating

Is there a Property Finder API?

Yes. The propertyfinder API on ReefAPI returns the listings, full listing pages with the agent's contact, UAE transactions, area guides, new projects and agent and agency directories of all five Property Finder portals (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) as JSON, read logged out, no Property Finder account needed.

Which countries are covered?

The United Arab Emirates (propertyfinder.ae), Saudi Arabia, Qatar, Bahrain and Egypt. Pass country=ae, sa, qa, bh or eg. On 2026-11-15: UAE 183,708 for sale and 165,618 for rent, Egypt 171,316 and 50,570, Qatar 12,370 and 34,897, Bahrain 9,264 and 15,865, Saudi Arabia 3,461 and 1,156. Transaction history is published for the UAE only.

Which filters does search take?

Location (a name or ids), property type, bedrooms, bathrooms, price, size, plot size, price per area, furnishing, ready or off-plan, rent period, keyword, full-text search, amenities, listed within 1 to 90 days, video / 360 / floor plan / live viewing, great value / high demand / price drop badges, handover dates, post-handover payment plan, upgraded / extended / landscaped, mortgage cashback, number of cheques, and a point with a radius. Each was checked against the unfiltered total on 2026-11-15: UAE listings for sale 183,708, in Dubai Marina 3,978, villas 34,574, 2 bedrooms 40,091, with a private pool 22,334, listed in the last day 1,968.

Do I get the agent's phone number?

Yes, as the listing publishes it: the listing's phone and WhatsApp numbers (861 of 861 listings measured), the agency's phone and e-mail, and the agent's profile. agents and agent return the agent directory with nationality, languages, experience, rating, review count and listing counts.

Where do the transactions come from?

From Property Finder's transaction pages, which publish Dubai Land Department data: sales and rent contracts by city, community or building, with price, size, unit number, date, developer, seller type and the market summary. Dubai had 157,939 sales in the last 12 months and 681,929 rent contracts on 2026-11-15. Saudi Arabia, Qatar, Bahrain and Egypt publish no transactions on Property Finder.

How deep can I page?

Search serves pages 1 to 50 of any query, 25 listings per page by default and up to 60, so up to 3,000 listings per query. Past page 50 the site answers from a different index that ignores the sort and the location filter, so the API stops there and says so. Transactions serve the first 500 rows of a query; agents and agencies page to the end of the directory (17,613 UAE agents, 881 pages of 20).

Which sort order should I page with?

One of the fixed orders. The price and bedrooms sorts page without gaps (0 repeated listings over 3 pages on 2026-11-15), and newest returned 0 repeats over pages 1 to 3 of UAE rent and sale searches, moving only by the listings added between two page calls. featured, the site's default, re-ranks between calls, so its pages can share listings.

Does it cover new projects and developers?

Yes. projects lists new off-plan projects with developer, starting price, price range, bedrooms, handover date, construction and sales phase and payment plans (2,995 in the UAE, 1,504 in Egypt on 2026-11-15); project returns one project with its units, payment plans, timeline, amenities and recent building sales; developer returns a developer's profile and projects. developers finds developers by name; the site publishes no full developer directory.

Can I get area guides and reviews?

Yes. area returns the site's guide for a city, community or building: description, key facts, FAQs, getting around, schools, nearby places, renter demographics, median prices by type and bedrooms, market insights and the latest reviews. area_reviews pages a community's or building's resident reviews with seven category scores and four sort orders.

What is the Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) API?

Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) API is a ReefAPI endpoint group for listings for sale and rent with every site filter, full listings with the agent's phone and whatsapp, uae transactions, area guides, new projects and agent directories. It returns live JSON through POST requests under /propertyfinder/v1.

Is the Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) login or account?

No login to Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) data?

The page example is captured from a live locations call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) API use?

Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

docs / propertyfinder

Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt)

Listings for sale and rent with every site filter, full listings with the agent's phone and WhatsApp, UAE transactions, area guides, new projects and agent directories.

base /propertyfinder/v118 endpoints
post/propertyfinder/v1/locations1 credit

Look up places by name on one Property Finder portal and get the location ids every other action accepts: cities, communities, sub-communities and buildings, with coordinates, review score and the area-guide link.

ParameterAllowed / rangeDescription
queryrequired—Place or building name.
country = aeoptionalae · sa · qa · bh · egWhich Property Finder portal: ae (propertyfinder.ae, default), sa, qa, bh, eg.
language = enoptionalen · arLanguage of the texts the site returns.
page = 1optional1–10000Result page (1-based).
page_size = 10optional1–50Rows per page, 1-50.
Try in playground →
post/propertyfinder/v1/property1 credit

Everything one listing page shows: price, price per area, size, rooms, furnishing, completion, the full description, every photo (and the community / building photos), amenities, the permit / RERA number and validation link, the agent and the agency with phone, WhatsApp and e-mail as published, the property and regulatory detail tables, local price trends (1 / 2 / 5 years), the price comparison against the area, similar sold / rented transactions and mortgage rates.

ParameterAllowed / rangeDescription
property_idrequired—Listing id (e.g. 170616251) or any Property Finder listing link (its domain picks the country).
country = aeoptionalae · sa · qa · bh · egWhich Property Finder portal: ae (propertyfinder.ae, default), sa, qa, bh, eg.
language = enoptionalen · arLanguage of the texts the site returns.
Try in playground →
post/propertyfinder/v1/transactions1 credit

UAE (Dubai Land Department data as Property Finder publishes it): sold or rented transactions in a city, community or building with the market summary (average and median price, price per sqft, volume, yield, monthly trend). Filters: property type, bedrooms, price, size, period, seller (developer / individual), completion, new or renewed rent contracts, unit number.

ParameterAllowed / rangeDescription
location_idrequired—Location id (Dubai = 1, Dubai Marina = 50; any id from `locations`).
category = soldoptionalsold · rentedSales or rent contracts.
property_typeoptionalapartment · villa · townhouse · penthouse · compound · duplex · full_floor · half_floor · whole_building · land · bulk_sale_unit · bungalow · hotel_apartment · bulk_rent_unit · office · retail · warehouse · shop · showroom · factory · labor_camp · staff_accommodation · business_centre · coworking · farmProperty type (name or id).
bedroomsoptional—Bedrooms: studio or 1-7.
min_priceoptional0–Minimum price (AED).
max_priceoptional0–Maximum price (AED).
min_areaoptional0–Minimum size (sqft).
max_areaoptional0–Maximum size (sqft).
period = 1yoptional1m · 3m · 6m · 1y · 3yTime window (default 1y, the site's default).
sold_byoptionaldeveloper · individualSales only: who sold.
completion_statusoptionalready · off_planReady or off-plan.
contract_statusoptionalnew · renewedRent contracts only: new or renewed.
unit_numberoptional—Unit number as registered (e.g. M1-413).
page = 1optional1–10000Result page (1-based).
page_size = 20optional1–50Rows per page, 1-50. The source serves the first 500 rows of any query (page × page_size ≤ 500).
language = enoptionalen · arLanguage of the texts the site returns.
country = aeoptionalae · sa · qa · bh · egWhich Property Finder portal: ae (propertyfinder.ae, default), sa, qa, bh, eg.
Try in playground →
post/propertyfinder/v1/area3 credits

The site's area guide for a city, community or building: description, key facts, FAQs, getting around, schools, nearby places (counts and named places), demographics of renters, market insights (average sale price, price per sqft, yield, transaction volume), median prices per property type and bedroom count, price histogram, review summary with the latest reviews, popular buildings, similar communities and photos.

ParameterAllowed / rangeDescription
arearequired—Area-guide path '<city>/<slug>' (e.g. dubai/dubai-marina), a city slug (dubai), or an area-insights link.
country = aeoptionalae · sa · qa · bh · egWhich Property Finder portal: ae (propertyfinder.ae, default), sa, qa, bh, eg.
language = enoptionalen · arLanguage of the texts the site returns.
Try in playground →
post/propertyfinder/v1/area_reviews1 credit

Resident reviews of a community or building (the area guide's reviews), paged and sortable, with the score per category (traffic, quiet, parks, family, maintenance, parking, amenities).

ParameterAllowed / rangeDescription
location_idrequired—Community or building location id (from `locations`).
country = aeoptionalae · sa · qa · bh · egWhich Property Finder portal: ae (propertyfinder.ae, default), sa, qa, bh, eg.
language = enoptionalen · arLanguage of the texts the site returns.
sort = newestoptionalnewest · oldest · rating_highest · rating_lowestOrder.
page = 1optional1–10000Result page (1-based).
page_size = 20optional1–50Reviews per page, 1-50.
Try in playground →
post/propertyfinder/v1/projects1 credit

New (off-plan) projects on one portal, paged as the site's new-projects search shows them: name, developer, location, starting price and price range, bedrooms, property types, handover date, construction and sales phase, payment plans, down payment, amenities. Filters: location, developer, property type, bedrooms, price, handover date, ready / off-plan, post-handover payment plan.

ParameterAllowed / rangeDescription
country = aeoptionalae · sa · qa · bh · egWhich Property Finder portal: ae (propertyfinder.ae, default), sa, qa, bh, eg.
language = enoptionalen · arLanguage of the texts the site returns.
location_idoptional—Location id(s) from `locations`.
developer_idoptional—Developer id(s) (uuid, from `developers` or a project's developer.id).
property_typeoptionalapartment · villa · townhouse · penthouse · compound · duplex · full_floor · half_floor · whole_building · land · bulk_sale_unit · bungalow · hotel_apartment · bulk_rent_unit · office · retail · warehouse · shop · showroom · factory · labor_camp · staff_accommodation · business_centre · coworking · farmProperty type(s).
bedroomsoptional—Bedrooms: studio, 1-7, 7+.
min_priceoptional0–Minimum starting price.
max_priceoptional0–Maximum starting price.
completion_statusoptionalready · off_planReady or off-plan.
delivery_date_fromoptional—Handover on/after this date (YYYY-MM-DD).
post_handover_payment_planoptional—Only projects with a post-handover payment plan.
sort = featuredoptionalfeatured · price_asc · price_desc · delivery_date_asc · delivery_date_desc · newestOrder.
page = 1optional1–10000Result page (1-based).
Try in playground →
post/propertyfinder/v1/project1 credit

One new project: description, developer, master plan, location with coordinates, starting price and price range, unit types with sizes and prices, payment plans, handover and construction timeline, amenities, images, brochure, FAQs, agents marketing it, recent sales in the building and similar projects.

ParameterAllowed / rangeDescription
projectrequired—Project path '<developer-slug>/<project-slug>' (a project's `slug`) or its new-projects link.
country = aeoptionalae · sa · qa · bh · egWhich Property Finder portal: ae (propertyfinder.ae, default), sa, qa, bh, eg.
language = enoptionalen · arLanguage of the texts the site returns.
Try in playground →
post/propertyfinder/v1/developers1 credit

Find property developers (and their projects) by name with the site's new-projects autocomplete.

ParameterAllowed / rangeDescription
queryrequired—Developer or project name (2+ characters).
country = aeoptionalae · sa · qa · bh · egWhich Property Finder portal: ae (propertyfinder.ae, default), sa, qa, bh, eg.
language = enoptionalen · arLanguage of the texts the site returns.
page_size = 10optional1–15Matches per group (developers, projects), 1-15 — the site's own maximum (16 answers 'max bucket size 15').
Try in playground →
post/propertyfinder/v1/developer1 credit

A developer's page: profile (description, established since, projects online, logo), the developer's projects (first page, paged with `page`) and the per-city project counts.

ParameterAllowed / rangeDescription
developerrequired—Developer slug (e.g. emaar-properties) or its new-projects/dev link.
country = aeoptionalae · sa · qa · bh · egWhich Property Finder portal: ae (propertyfinder.ae, default), sa, qa, bh, eg.
language = enoptionalen · arLanguage of the texts the site returns.
page = 1optional1–10000Result page (1-based).
Try in playground →
post/propertyfinder/v1/agents1 credit

Search the portal's agent directory: by name, area, language, nationality, service, property type, SuperAgent; paged with the site's total.

ParameterAllowed / rangeDescription
country = aeoptionalae · sa · qa · bh · egWhich Property Finder portal: ae (propertyfinder.ae, default), sa, qa, bh, eg.
language = enoptionalen · arLanguage of the texts the site returns.
nameoptional—Agent name (or part of it).
location_idoptional—Location id the agent works in (from `locations`).
spoken_languageoptional—Spoken language id(s) as the site numbers them: 1 English, 2 Arabic, 3 French, 5 German, 6 Russian, 7 Hindi, 8 Urdu, 21 Mandarin …
nationalityoptional—Nationality ISO code (e.g. GB, IN, EG).
serviceoptionalbuy · rent · commercial_buy · commercial_rentService the agent offers.
property_typeoptionalapartment · villa · townhouse · penthouse · compound · duplex · full_floor · half_floor · whole_building · land · bulk_sale_unit · bungalow · hotel_apartment · bulk_rent_unit · office · retail · warehouse · shop · showroom · factory · labor_camp · staff_accommodation · business_centre · coworking · farmProperty type the agent lists.
super_agentoptional—Only SuperAgents.
agency_idoptional—Only agents of this agency.
sort = featuredoptionalfeatured · most_for_sale · most_for_rentOrder.
page = 1optional1–10000Result page (1-based).
page_size = 20optional1–100Agents per page, 1-100.
Try in playground →
post/propertyfinder/v1/agent1 credit

One agent's public profile: bio, position, nationality, languages, experience, licence, listing counts by type, rating and review count with the distribution, WhatsApp response time, top locations, claimed transactions and the agency.

ParameterAllowed / rangeDescription
agent_idrequired—Agent id (e.g. 303271) or an agent profile link.
country = aeoptionalae · sa · qa · bh · egWhich Property Finder portal: ae (propertyfinder.ae, default), sa, qa, bh, eg.
language = enoptionalen · arLanguage of the texts the site returns.
Try in playground →
post/propertyfinder/v1/agent_listings1 credit

Every live listing of one agent, paged, with the same filters and sorting as `search`.

ParameterAllowed / rangeDescription
agent_idrequired—Agent id.
country = aeoptionalae · sa · qa · bh · egWhich Property Finder portal: ae (propertyfinder.ae, default), sa, qa, bh, eg.
language = enoptionalen · arLanguage of the texts the site returns.
category = buyoptionalbuy · rent · commercial_buy · commercial_rentWhat to search: buy (default), rent, commercial_buy, commercial_rent.
locationoptional—Place name (city, community, sub-community or building). The engine resolves it with the site's own location search and uses the best match; the match is echoed in `location`.
location_idsoptional—One or more Property Finder location ids (from `locations`), comma-separated.
property_typeoptionalapartment · villa · townhouse · penthouse · compound · duplex · full_floor · half_floor · whole_building · land · bulk_sale_unit · bungalow · hotel_apartment · bulk_rent_unit · office · retail · warehouse · shop · showroom · factory · labor_camp · staff_accommodation · business_centre · coworking · farmOne or more property types (names below or numeric type ids), comma-separated.
bedroomsoptional—Bedroom counts, comma-separated: studio, 1-7, 7+ (any of them matches).
bathroomsoptional—Bathroom counts, comma-separated: 1-7, 7+.
min_priceoptional0–Minimum price (local currency).
max_priceoptional0–Maximum price (local currency).
min_areaoptional0–Minimum size in the portal's area unit (sqft on .ae/.qa/.bh, sqm on .sa/.eg).
max_areaoptional0–Maximum size in the portal's area unit.
min_plot_sizeoptional0–Minimum plot size.
max_plot_sizeoptional0–Maximum plot size.
min_price_per_areaoptional0–Minimum price per area unit.
max_price_per_areaoptional0–Maximum price per area unit.
furnishedoptionalfurnished · unfurnished · partly_furnishedFurnishing.
completion_statusoptionalready · off_planReady or off-plan.
price_periodoptionalyearly · monthly · weekly · dailyRent: only listings priced per this period.
keywordsoptional—Keyword the listing must mention (the site's keyword box).
textoptional—Free-text search across the listing (the site's full-text query).
listed_withinoptional1d · 7d · 15d · 30d · 90dOnly listings added in the last 1d / 7d / 15d / 30d / 90d (or the day count).
amenitiesoptionalAC · MR · BA · SP · SS · SY · CS · CP · VW · BL · PA · ST · PG · PP · PY · PJ · BW · WC · BK · MS · PR · CO · BRAmenities, comma-separated, all must match: two-letter codes (AC, BA, PP, PA, …) or their names (private pool, pets allowed, …).
mortgage_cashbackoptional—Only listings with a mortgage cashback offer.
virtual_viewingsoptionalfloor_plan · 360_tours · video · liveOnly listings with this kind of virtual viewing.
deal_badgesoptionalgreat_value · high_demand · price_dropOnly listings carrying this badge.
delivery_date_fromoptional—Off-plan handover on/after this date (YYYY-MM-DD).
delivery_date_tooptional—Off-plan handover on/before this date (YYYY-MM-DD).
post_handover_payment_planoptional—Only off-plan listings with a post-handover payment plan.
upgradedoptional—Only listings marked upgraded.
extendedoptional—Only listings marked extended.
landscapedoptional—Only listings marked landscaped.
min_chequesoptional1–12Rent: minimum number of cheques accepted.
max_chequesoptional1–12Rent: maximum number of cheques accepted.
latitudeoptional-90–90Search around a point: latitude (with longitude + radius_km).
longitudeoptional-180–180Search around a point: longitude.
radius_kmoptional0.1–50Search around a point: radius in km (default 2).
sort = featuredoptionalfeatured · newest · price_asc · price_desc · bedrooms_asc · bedrooms_desc · delivery_date_asc · delivery_date_desc · price_per_area_asc · price_per_area_descSort order. featured re-ranks between calls; newest shifts by the listings added between two page calls; price / bedrooms sorts page without gaps (0 overlaps over 3 pages, measured).
page = 1optional1–50Result page, 1-50: the site's search serves its first 50 pages of any query (up to 3000 listings at page_size 60); narrow the filters to reach more.
page_size = 25optional1–60Listings per page, 1-60 (the site's own maximum).
Try in playground →
post/propertyfinder/v1/agencies1 credit

Search the portal's agency (real-estate company) directory by name, area and service; paged with the site's total.

ParameterAllowed / rangeDescription
country = aeoptionalae · sa · qa · bh · egWhich Property Finder portal: ae (propertyfinder.ae, default), sa, qa, bh, eg.
language = enoptionalen · arLanguage of the texts the site returns.
nameoptional—Agency name (or part of it).
location_idoptional—Location id (from `locations`).
serviceoptionalbuy · rent · commercial_buy · commercial_rentService offered.
sort = featuredoptionalfeatured · nameOrder.
page = 1optional1–10000Result page (1-based).
page_size = 20optional1–100Agencies per page, 1-100.
Try in playground →
post/propertyfinder/v1/agency1 credit

One agency's profile: name, licence, phone, e-mail, address, description, logo, listing counts by type, number of agents and SuperAgents, awards, branches.

ParameterAllowed / rangeDescription
agency_idrequired—Agency id (e.g. 10438) or a broker profile link.
country = aeoptionalae · sa · qa · bh · egWhich Property Finder portal: ae (propertyfinder.ae, default), sa, qa, bh, eg.
language = enoptionalen · arLanguage of the texts the site returns.
Try in playground →
post/propertyfinder/v1/agency_agents1 credit

Every agent of one agency, paged with the site's total.

ParameterAllowed / rangeDescription
agency_idrequired—Agency id.
country = aeoptionalae · sa · qa · bh · egWhich Property Finder portal: ae (propertyfinder.ae, default), sa, qa, bh, eg.
language = enoptionalen · arLanguage of the texts the site returns.
sort = featuredoptionalfeatured · most_for_sale · most_for_rentOrder.
page = 1optional1–10000Result page (1-based).
page_size = 20optional1–100Agents per page, 1-100.
Try in playground →
post/propertyfinder/v1/agency_listings1 credit

Every live listing of one agency, paged, with the same filters and sorting as `search`.

ParameterAllowed / rangeDescription
agency_idrequired—Agency id.
country = aeoptionalae · sa · qa · bh · egWhich Property Finder portal: ae (propertyfinder.ae, default), sa, qa, bh, eg.
language = enoptionalen · arLanguage of the texts the site returns.
category = buyoptionalbuy · rent · commercial_buy · commercial_rentWhat to search: buy (default), rent, commercial_buy, commercial_rent.
locationoptional—Place name (city, community, sub-community or building). The engine resolves it with the site's own location search and uses the best match; the match is echoed in `location`.
location_idsoptional—One or more Property Finder location ids (from `locations`), comma-separated.
property_typeoptionalapartment · villa · townhouse · penthouse · compound · duplex · full_floor · half_floor · whole_building · land · bulk_sale_unit · bungalow · hotel_apartment · bulk_rent_unit · office · retail · warehouse · shop · showroom · factory · labor_camp · staff_accommodation · business_centre · coworking · farmOne or more property types (names below or numeric type ids), comma-separated.
bedroomsoptional—Bedroom counts, comma-separated: studio, 1-7, 7+ (any of them matches).
bathroomsoptional—Bathroom counts, comma-separated: 1-7, 7+.
min_priceoptional0–Minimum price (local currency).
max_priceoptional0–Maximum price (local currency).
min_areaoptional0–Minimum size in the portal's area unit (sqft on .ae/.qa/.bh, sqm on .sa/.eg).
max_areaoptional0–Maximum size in the portal's area unit.
min_plot_sizeoptional0–Minimum plot size.
max_plot_sizeoptional0–Maximum plot size.
min_price_per_areaoptional0–Minimum price per area unit.
max_price_per_areaoptional0–Maximum price per area unit.
furnishedoptionalfurnished · unfurnished · partly_furnishedFurnishing.
completion_statusoptionalready · off_planReady or off-plan.
price_periodoptionalyearly · monthly · weekly · dailyRent: only listings priced per this period.
keywordsoptional—Keyword the listing must mention (the site's keyword box).
textoptional—Free-text search across the listing (the site's full-text query).
listed_withinoptional1d · 7d · 15d · 30d · 90dOnly listings added in the last 1d / 7d / 15d / 30d / 90d (or the day count).
amenitiesoptionalAC · MR · BA · SP · SS · SY · CS · CP · VW · BL · PA · ST · PG · PP · PY · PJ · BW · WC · BK · MS · PR · CO · BRAmenities, comma-separated, all must match: two-letter codes (AC, BA, PP, PA, …) or their names (private pool, pets allowed, …).
mortgage_cashbackoptional—Only listings with a mortgage cashback offer.
virtual_viewingsoptionalfloor_plan · 360_tours · video · liveOnly listings with this kind of virtual viewing.
deal_badgesoptionalgreat_value · high_demand · price_dropOnly listings carrying this badge.
delivery_date_fromoptional—Off-plan handover on/after this date (YYYY-MM-DD).
delivery_date_tooptional—Off-plan handover on/before this date (YYYY-MM-DD).
post_handover_payment_planoptional—Only off-plan listings with a post-handover payment plan.
upgradedoptional—Only listings marked upgraded.
extendedoptional—Only listings marked extended.
landscapedoptional—Only listings marked landscaped.
min_chequesoptional1–12Rent: minimum number of cheques accepted.
max_chequesoptional1–12Rent: maximum number of cheques accepted.
latitudeoptional-90–90Search around a point: latitude (with longitude + radius_km).
longitudeoptional-180–180Search around a point: longitude.
radius_kmoptional0.1–50Search around a point: radius in km (default 2).
sort = featuredoptionalfeatured · newest · price_asc · price_desc · bedrooms_asc · bedrooms_desc · delivery_date_asc · delivery_date_desc · price_per_area_asc · price_per_area_descSort order. featured re-ranks between calls; newest shifts by the listings added between two page calls; price / bedrooms sorts page without gaps (0 overlaps over 3 pages, measured).
page = 1optional1–50Result page, 1-50: the site's search serves its first 50 pages of any query (up to 3000 listings at page_size 60); narrow the filters to reach more.
page_size = 25optional1–60Listings per page, 1-60 (the site's own maximum).
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.

Comparing scraping APIs?ReefAPI vs Bright Data