ReefAPI

ReefAPI Real Estate API

The Real Estate API from ReefAPI — 57 operation(s) for real estate.

GitHub OpenAPI

Operations 57

POST /enrich-property/v1/snapshot address OR listing_url → one normalized property snapshot: status, price… #
POST /enrich-property/v1/resolve address → ranked candidate listings[] (id + source + match_confidence) so the… #
POST /enrich-property/v1/batch snapshot up to 10 addresses/listing-URLs in one call (standard mode… #
POST /enrich-property/v1/coverage Static capability map: which countries/sources are supported, per-country… #
POST /funda/v1/detail Full record for a single listing by its Funda detail URL or path… #
POST /funda/v1/area Area resolver — map a free-text Dutch place name to Funda's search area-slug… #
POST /hemnet/v1/sold Recently-SOLD property prices (slutpriser) by location, with the same filters… #
POST /hemnet/v1/detail Full record for a single listing by its Hemnet listing URL, slug or id… #
POST /hemnet/v1/location Location resolver / autocomplete — map a free-text Swedish place name to Hemnet… #
POST /idealista/v1/detail Full record for a single listing by its Idealista id (the number in an… #
POST /idealista/v1/geography Resolve a free-text place name to the Idealista location slug + a ready-to-use… #
POST /immobiliare/v1/detail Full record for a single listing by its Immobiliare id (from a search result's… #
POST /immobiliare/v1/geography Location autocomplete — resolve a free-text Italian place name to Immobiliare's… #
POST /japan-re/v1/detail Full detail for one SUUMO listing — rent/deposit/key-money or sale price… #
POST /japan-re/v1/areas List Japan's 47 prefectures with their romaji slug, kanji name and SUUMO… #
POST /japan-re/v1/listings/detail Legacy name for `detail`, kept so older integrations keep working. #
POST /onthemarket/v1/property_detail Full property record: price (+qualifier), beds/baths, description, key… #
POST /realtor/v1/detail Full property record by property_id: RealEstimate value (+ range), price… #
POST /realtor/v1/estimates Multi-source home-value estimates (AVMs) for a property — Realtor.com surfaces… #
POST /realtor/v1/sold Recently-sold homes by location (or map bounds), with the same structured… #
POST /realtor/v1/comps Comparable homes near a property — synthesized from recently-sold and active… #
POST /realtor/v1/autocomplete Location autocomplete — suggest Realtor.com cities, ZIPs, neighborhoods… #
POST /redfin/v1/listing_detail Everything Redfin holds on one address: the live listing when the home is on… #
POST /redfin/v1/similar Comparable/similar listings near a property, with the comp price band #
POST /redfin/v1/autocomplete Resolve free text to Redfin places / agents / schools / buildings (ids + types) #
POST /redfin/v1/market_stats Derived market snapshot for an area: median list price, $/sqft, days on market… #
POST /rightmove/v1/property_detail Full property record: price (+£/sqft), description, key features, tenure &… #
POST /rightmove/v1/agent estate-agent branch profile (+ that branch's live listings via BRANCH^id) #
POST /rightmove/v1/similar listings similar to a property (same area + price/bedroom band) #
POST /rightmove/v1/sold_prices sold/transaction history: by location (search) or per-property… #
POST /zillow/v1/new_listings New US inventory straight from Zillow's own published feed — the listings that… #
POST /zillow/v1/search_by_coordinates Search listings inside exact map bounds (returns more than the standard… #
POST /zillow/v1/search_by_url Run any copied Zillow URL: a search URL replays that exact search (with its… #
POST /zillow/v1/property_detail Full property record: Zestimate (+history), price & tax history, schools… #
POST /zillow/v1/comps Comparable homes near a property (synthesized similar-listing search, scored by… #
POST /zillow/v1/sold Recently-sold listings (last 12 months) by location or map bounds, with the… #
POST /zillow/v1/agent Listing agent + broker attribution for one property (agentInfo) #
POST /zillow/v1/agent_profile An agent's full portfolio: profile info + their for-sale/sold listings + reviews #
POST /zillow/v1/agents_by_location Real-estate agent directory for a location, with review summaries #
POST /zillow/v1/autocomplete Location autocomplete — suggest Zillow regions and addresses for a free-text… #
POST /zillow/v1/walk_transit_bike Zillow Walk Score, Transit Score and Bike Score for a property — walkability… #
POST /zillow/v1/home_value_chart Zillow home-value history — the Zestimate value-over-time series for a property… #

Documentation

📖
Documentation
https://reefapi.com/docs
📖
APIReference
https://reefapi.com/apis
📖
Quickstart
https://reefapi.com/docs#quickstart

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/reefapi/refs/heads/main/openapi/reefapi-real-estate-api-openapi.yml

Other Resources

🔗
DeveloperPortal
https://reefapi.com/docs
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/reefapi/refs/heads/main/data-model/reefapi-data-model.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/reefapi/refs/heads/main/errors/reefapi-problem-types.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/reefapi/refs/heads/main/conventions/reefapi-conventions.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/reefapi-real-estate-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

reefapi-real-estate-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Reef Real Estate API
  version: 1.0.0
  description: Unified data-API gateway. Call POST /{engine}/v1/{action} with an x-api-key header; every response is the { ok, data, meta, error } envelope.
servers:
- url: https://api.reefapi.com
security:
- ApiKeyAuth: []
tags:
- name: Real Estate
paths:
  /enrich-property/v1/snapshot:
    post:
      operationId: enrich_property_snapshot
      summary: 'address OR listing_url → one normalized property snapshot: status, price…'
      tags:
      - Real Estate
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                address:
                  type: string
                listing_url:
                  type: string
                country:
                  type: string
                mode:
                  type: string
            example:
              listing_url: https://www.zillow.com/homedetails/x/117892026_zpid/
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /enrich-property/v1/resolve:
    post:
      operationId: enrich_property_resolve
      summary: address → ranked candidate listings[] (id + source + match_confidence) so the…
      tags:
      - Real Estate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                address:
                  type: string
                country:
                  type: string
                limit:
                  type: string
              required:
              - address
            example:
              address: 137 Mellison Road, Tooting, London, SW17
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /enrich-property/v1/batch:
    post:
      operationId: enrich_property_batch
      summary: snapshot up to 10 addresses/listing-URLs in one call (standard mode…
      tags:
      - Real Estate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                items:
                  type: string
                country:
                  type: string
              required:
              - items
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /enrich-property/v1/coverage:
    post:
      operationId: enrich_property_coverage
      summary: 'Static capability map: which countries/sources are supported, per-country…'
      tags:
      - Real Estate
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties: {}
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /funda/v1/search:
    post:
      operationId: funda_search
      summary: Search Funda.nl property listings by area (for sale or for rent), with…
      tags:
      - Real Estate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                area:
                  type: string
                contract:
                  type: string
                home_type:
                  type: string
                sort:
                  type: string
                page:
                  type: string
                price_min:
                  type: string
                price_max:
                  type: string
                rooms_min:
                  type: string
                rooms_max:
                  type: string
                surface_min:
                  type: string
                surface_max:
                  type: string
                plot_min:
                  type: string
                plot_max:
                  type: string
              required:
              - area
            example:
              area: amsterdam
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /funda/v1/detail:
    post:
      operationId: funda_detail
      summary: Full record for a single listing by its Funda detail URL or path…
      tags:
      - Real Estate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                url:
                  type: string
              required:
              - url
            example:
              url: https://www.funda.nl/detail/koop/amsterdam/appartement-albert-cuypstraat-94-3/44570149/
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /funda/v1/area:
    post:
      operationId: funda_area
      summary: Area resolver — map a free-text Dutch place name to Funda's search area-slug…
      tags:
      - Real Estate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
              required:
              - query
            example:
              query: Den Haag
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /hemnet/v1/search:
    post:
      operationId: hemnet_search
      summary: Search Hemnet.se for-sale property listings by location, with structured…
      tags:
      - Real Estate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                location:
                  type: string
                home_type:
                  type: string
                sort:
                  type: string
                page:
                  type: string
                price_min:
                  type: string
                price_max:
                  type: string
                rooms_min:
                  type: string
                rooms_max:
                  type: string
                living_area_min:
                  type: string
                living_area_max:
                  type: string
                land_area_min:
                  type: string
                land_area_max:
                  type: string
                price_per_m2_min:
                  type: string
                price_per_m2_max:
                  type: string
                year_min:
                  type: string
                year_max:
                  type: string
                keywords:
                  type: string
              required:
              - location
            example:
              location: Stockholm
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /hemnet/v1/sold:
    post:
      operationId: hemnet_sold
      summary: Recently-SOLD property prices (slutpriser) by location, with the same filters…
      tags:
      - Real Estate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                location:
                  type: string
                home_type:
                  type: string
                sort:
                  type: string
                page:
                  type: string
                price_min:
                  type: string
                price_max:
                  type: string
                rooms_min:
                  type: string
                rooms_max:
                  type: string
                living_area_min:
                  type: string
                living_area_max:
                  type: string
                land_area_min:
                  type: string
                land_area_max:
                  type: string
                price_per_m2_min:
                  type: string
                price_per_m2_max:
                  type: string
                year_min:
                  type: string
                year_max:
                  type: string
                keywords:
                  type: string
              required:
              - location
            example:
              location: Malmö
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /hemnet/v1/detail:
    post:
      operationId: hemnet_detail
      summary: Full record for a single listing by its Hemnet listing URL, slug or id…
      tags:
      - Real Estate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                url:
                  type: string
              required:
              - url
            example:
              url: https://www.hemnet.se/bostad/lagenhet-3rum-segevang-malmo-kommun-kronetorpsgatan-52a-21744904
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /hemnet/v1/location:
    post:
      operationId: hemnet_location
      summary: Location resolver / autocomplete — map a free-text Swedish place name to Hemnet…
      tags:
      - Real Estate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
              required:
              - query
            example:
              query: Göteborg
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /idealista/v1/search:
    post:
      operationId: idealista_search
      summary: Search Idealista property listings by location (Spain, Italy or Portugal; for…
      tags:
      - Real Estate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                location:
                  type: string
                country:
                  type: string
                contract:
                  type: string
                sort:
                  type: string
                home_type:
                  type: string
                page:
                  type: string
                price_min:
                  type: string
                price_max:
                  type: string
                rooms_min:
                  type: string
                surface_min:
                  type: string
              required:
              - location
            example:
              location: Madrid
              country: es
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /idealista/v1/detail:
    post:
      operationId: idealista_detail
      summary: Full record for a single listing by its Idealista id (the number in an…
      tags:
      - Real Estate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: string
                country:
                  type: string
              required:
              - id
            example:
              id: '109592362'
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /idealista/v1/geography:
    post:
      operationId: idealista_geography
      summary: Resolve a free-text place name to the Idealista location slug + a ready-to-use…
      tags:
      - Real Estate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                country:
                  type: string
                contract:
                  type: string
              required:
              - query
            example:
              query: Madrid
              country: es
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /immobiliare/v1/search:
    post:
      operationId: immobiliare_search
      summary: Search Immobiliare.it property listings by location (for sale or for rent)…
      tags:
      - Real Estate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                location:
                  type: string
                contract:
                  type: string
                category:
                  type: string
                sort:
                  type: string
                home_type:
                  type: string
                page:
                  type: string
                price_min:
                  type: string
                price_max:
                  type: string
                rooms_min:
                  type: string
                rooms_max:
                  type: string
                surface_min:
                  type: string
                surface_max:
                  type: string
                baths_min:
                  type: string
              required:
              - location
            example:
              location: Roma
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /immobiliare/v1/detail:
    post:
      operationId: immobiliare_detail
      summary: Full record for a single listing by its Immobiliare id (from a search result's…
      tags:
      - Real Estate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: string
                location:
                  type: string
              required:
              - id
            example:
              id: '130988676'
              location: Roma
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /immobiliare/v1/geography:
    post:
      operationId: immobiliare_geography
      summary: Location autocomplete — resolve a free-text Italian place name to Immobiliare's…
      tags:
      - Real Estate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
              required:
              - query
            example:
              query: Roma
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /japan-re/v1/search:
    post:
      operationId: japan_re_search
      summary: Search SUUMO property listings in any of Japan's 47 prefectures — rentals or…
      tags:
      - Real Estate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                prefecture:
                  type: string
                listing_type:
                  type: string
                page:
                  type: string
                max_pages:
                  type: string
                max_price_man:
                  type: string
                min_area_m2:
                  type: string
                max_walk_minutes:
                  type: string
                building_age:
                  type: string
                keyword:
                  type: string
              required:
              - prefecture
            example:
              prefecture: tokyo
              listing_type: rent
              max_pages: 1
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /japan-re/v1/detail:
    post:
      operationId: japan_re_detail
      summary: Full detail for one SUUMO listing — rent/deposit/key-money or sale price…
      tags:
      - Real Estate
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                listing_id:
                  type: string
                url:
                  type: string
                listing_type:
                  type: string
            example:
              listing_id: 000109252250
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /japan-re/v1/areas:
    post:
      operationId: japan_re_areas
      summary: List Japan's 47 prefectures with their romaji slug, kanji name and SUUMO…
      tags:
      - Real Estate
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /japan-re/v1/listings/search:
    post:
      operationId: japan_re_listings_search
      summary: Legacy name for `search`, kept so older integrations keep working.
      tags:
      - Real Estate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                prefecture:
                  type: string
                listing_type:
                  type: string
                page:
                  type: string
                max_pages:
                  type: string
                max_price_man:
                  type: string
                min_area_m2:
                  type: string
                max_walk_minutes:
                  type: string
                building_age:
                  type: string
                keyword:
                  type: string
              required:
              - prefecture
            example:
              prefecture: tokyo
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /japan-re/v1/listings/detail:
    post:
      operationId: japan_re_listings_detail
      summary: Legacy name for `detail`, kept so older integrations keep working.
      tags:
      - Real Estate
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                listing_id:
                  type: string
                url:
                  type: string
                listing_type:
                  type: string
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /onthemarket/v1/location_search:
    post:
      operationId: onthemarket_location_search
      summary: Resolve a text location (town, postcode, borough, area) to OnTheMarket location…
      tags:
      - Real Estate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                channel:
                  type: string
                limit:
                  type: string
              required:
              - query
            example:
              query: London
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /onthemarket/v1/search:
    post:
      operationId: onthemarket_search
      summary: Search UK property listings by location (for sale / to rent) with structured…
      tags:
      - Real Estate
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                location:
                  type: string
                location_id:
                  type: string
                channel:
                  type: string
                for_rent:
                  type: string
                price_min:
                  type: string
                price_max:
                  type: string
                beds_min:
                  type: string
                beds_max:
                  type: string
                property_type:
                  type: string
                radius:
                  type: string
                added_within_days:
                  type: string
                sort:
                  type: string
                keywords:
                  type: string
                retirement_only:
                  type: string
                shared_ownership_only:
                  type: string
                auction_only:
                  type: string
                new_homes_only:
                  type: string
                include_under_offer:
                  type: string
                include_sponsored:
                  type: string
                page:
                  type: string
                max_pages:
                  type: string
                filters:
                  type: string
            example:
              location: London
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /onthemarket/v1/property_detail:
    post:
      operationId: onthemarket_property_detail
      summary: 'Full property record: price (+qualifier), beds/baths, description, key…'
      tags:
      - Real Estate
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                property_id:
                  type: string
                url:
                  type: string
            example:
              property_id: '19555795'
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /realtor/v1/search:
    post:
      operationId: realtor_search
      summary: Search Realtor.com listings by location (for sale / for rent / recently sold)…
      tags:
      - Real Estate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                location:
                  type: string
                status:
                  type: string
                sort:
                  type: string
                limit:
                  type: string
                offset:
                  type: string
                map_bounds:
                  type: string
                price_min:
                  type: string
                price_max:
                  type: string
                beds_min:
                  type: string
                beds_max:
                  type: string
                baths_min:
                  type: string
                home_type:
                  type: string
                sqft_min:
                  type: string
                sqft_max:
                  type: string
                lot_min:
                  type: string
                lot_max:
                  type: string
                year_built_min:
                  type: string
                year_built_max:
                  type: string
                max_hoa:
                  type: string
                days_on_max:
                  type: string
                keywords:
                  type: string
              required:
              - location
            example:
              location: Austin, TX
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /realtor/v1/detail:
    post:
      operationId: realtor_detail
      summary: 'Full property record by property_id: RealEstimate value (+ range), price…'
      tags:
      - Real Estate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                property_id:
                  type: string
              required:
              - property_id
            example:
              property_id: '7211899596'
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /realtor/v1/estimates:
    post:
      operationId: realtor_estimates
      summary: Multi-source home-value estimates (AVMs) for a property — Realtor.com surfaces…
      tags:
      - Real Estate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                property_id:
                  type: string
              required:
              - property_id
            example:
              property_id: '7211899596'
      responses:
        '200':
          description: Result envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          description: Missing or invalid x-api-key
        '429':
          description: Rate limited or quota exhausted
  /realtor/v1/sold:
    post:
      operationId: realtor_sold
      summary: Recently-sold homes by location (or map bounds), with the same structured…
      tags:
      - Real Estate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                location:
                  type: string
                sort:
                  type: string
                limit:
                  type: string
                offset:
                  type: string
                map_bounds:
                  type: string
                price_min:
                  type: string
                price_max:
                  type: string
                beds_min:
                  type: string
                beds_max:
       

# --- truncated at 32 KB (63 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/reefapi/refs/heads/main/openapi/reefapi-real-estate-api-openapi.yml