Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Realtor.com

1 credit per call5 endpoints21 datapoints

Realtor.com API

Realtor.com API for US homes for sale, for rent or sold, listing details, listing agents and nearby schools as JSON. 1 credit per successful call.

Get a free API keyRun it below
Realtor.com
GET/v1/realtor-com/search?status=for_sale&location=Austin%2C+TX&per_page=10&min_beds=3
{
  "success": true,
  "data": {
    "listings": [
      {
        "property_id": "7009647360",
        "listing_id": "3003557193",
        "status": "for_sale",
        "list_price": 505000,
        "list_date": "2026-11-12T12:55:11.000000Z",
        "last_sold_date": "2018-10-24",
        "permalink": "5308-Sendero-Hills-Pkwy_Austin_TX_78724_M70096-47360",
        "url": "https://www.realtor.com/realestateandhomes-detail/5308-Sendero-Hills-Pkwy_Austin_TX_78724_M70096-47360",
        "beds": 3,
        "baths": 3,
        "sqft": 2158,
        "lot_sqft": 11064,
        "year_built": 2007,
        "type": "single_family",
        "address": {
          "line": "5308 Sendero Hills Pkwy",
          "city": "Austin",
          "state_code": "TX",
          "postal_code": "78724"
        },
        "coordinates": {
          "lat": 30.28292,
          "lon": -97.647545
        },
        "primary_photo": "https://ap.rdcpix.com/37ab905f1f158ed85c739b908966eb64l-m1123946771s.jpg",
        "photos": [
          "https://ap.rdcpix.com/37ab905f1f158ed85c739b908966eb64l-m1123946771s.jpg",
          "https://ap.rdcpix.com/37ab905f1f158ed85c739b908966eb64l-m3651844658s.jpg",
          "https://ap.rdcpix.com/37ab905f1f158ed85c739b908966eb64l-m3667901036s.jpg"
        ],
        "advertisers": [
          {
            "name": "Anthea Chlebek",
            "type": "seller",
            "office": "Compass RE Texas"
          }
        ],
        "flags": {
          "new_listing": true
        },
        "unit_data_available": true
      },
      {
        "property_id": "7175088272",
        "listing_id": "3003556799",
        "status": "for_sale",
        "list_price": 489899,
        "list_date": "2026-11-12T12:25:17.000000Z",
        "permalink": "9321-Bentley-Garner-Ln_Austin_TX_78748_M71750-88272",
        "url": "https://www.realtor.com/realestateandhomes-detail/9321-Bentley-Garner-Ln_Austin_TX_78748_M71750-88272",
        "beds": 4,
        "baths": 2,
        "sqft": 2227,
        "lot_sqft": 5706,
        "year_built": 2015,
        "type": "single_family",
        "address": {
          "line": "9321 Bentley Garner Ln",
          "city": "Austin",
          "state_code": "TX",
          "postal_code": "78748"
        },
        "coordinates": {
          "lat": 30.167181,
          "lon": -97.797409
        },
        "primary_photo": "https://ap.rdcpix.com/66b9d164a07769e1087bbb5c4fbf2e72l-m1126874305s.jpg",
        "photos": [
          "https://ap.rdcpix.com/66b9d164a07769e1087bbb5c4fbf2e72l-m1126874305s.jpg",
          "https://ap.rdcpix.com/66b9d164a07769e1087bbb5c4fbf2e72l-m2431806367s.jpg",
          "https://ap.rdcpix.com/66b9d164a07769e1087bbb5c4fbf2e72l-m350468165s.jpg"
        ],
        "advertisers": [
          {
            "name": "Dillar Schwartz",
            "type": "seller",
            "office": "eXp Realty, LLC",
            "broker": "eXp Realty, LLC"
          },
          {
            "name": "Bojan Dragicevic",
            "type": "co_seller",
            "office": "eXp Realty, LLC",
            "broker": "eXp Realty, LLC"
          }
        ],
        "flags": {
          "new_listing": true
        },
        "unit_data_available": true
      },
      {
        "property_id": "7547942527",
        "listing_id": "3003555439",
        "status": "for_sale",
        "list_price": 345000,
        "list_date": "2026-11-12T08:54:54.000000Z",
        "last_sold_date": "1997-03-31",
        "permalink": "10002-Oak-Run-Dr_Austin_TX_78758_M75479-42527",
        "url": "https://www.realtor.com/realestateandhomes-detail/10002-Oak-Run-Dr_Austin_TX_78758_M75479-42527",
        "beds": 3,
        "baths": 2,
        "sqft": 1455,
        "lot_sqft": 8433,
        "year_built": 1972,
        "type": "single_family",
        "address": {
          "line": "10002 Oak Run Dr",
          "city": "Austin",
          "state_code": "TX",
          "postal_code": "78758"
        },
        "coordinates": {
          "lat": 30.376239,
          "lon": -97.707166
        },
        "primary_photo": "https://ap.rdcpix.com/025d083c3ebc358bc8c181ab2d5d13dbl-m1720510087s.jpg",
        "photos": [
          "https://ap.rdcpix.com/025d083c3ebc358bc8c181ab2d5d13dbl-m1720510087s.jpg",
          "https://ap.rdcpix.com/025d083c3ebc358bc8c181ab2d5d13dbl-m501649624s.jpg",
          "https://ap.rdcpix.com/025d083c3ebc358bc8c181ab2d5d13dbl-m481254079s.jpg"
        ],
        "advertisers": [
          {
            "name": "Randy Schmidt",
            "type": "seller",
            "office": "Howard Schmidt Real Estate",
            "broker": "Howard Schmidt Real Estate -  Broker"
          }
        ],
        "flags": {
          "new_listing": true
        },
        "unit_data_available": true
      }
    ],
    "count": 10,
    "total_matching_count": 4497,
    "page": 1,
    "per_page": 10,
    "has_more": true,
    "status": "for_sale",
    "filters_applied": {
      "location": "Austin, TX",
      "sort": "list_date",
      "order": "desc",
      "min_beds": 3
    }
  },
  "meta": {
    "endpoint_family": "search",
    "filtered_out": 0,
    "request_id": "req_49d489ae7d2148248c3e2ace3ffffbb1",
    "credits_charged": 1,
    "credits_remaining": 1817
  }
}
200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#property_idstringlisting_idstringstatusstringlist_priceintegerlist_datestringlast_sold_datestringpermalinkstringurlurlbedsintegerbathsintegersqftintegerlot_sqftintegeryear_builtintegertypestringaddressobjectcoordinatesobjectprimary_photourlphotosstring[]advertisersobject[]flagsobjectunit_data_availableboolean
170096473603003557193for_sale5050002026-11-12T12:55:11.000000Z2018-10-245308-Sendero-Hills-Pkwy_Austin_TX_78724_M70096-47360https://www.realtor.com/realestateandhomes-detail/5308-Sendero-Hills-Pkwy_Austin_TX_78724_M70096-47360332158110642007single_family{4 fields}{2 fields}https://ap.rdcpix.com/37ab905f1f158ed85c739b908966eb64l-m1123946771s.jpg[3 items][1 item]{1 fields}true
271750882723003556799for_sale4898992026-11-12T12:25:17.000000Z—9321-Bentley-Garner-Ln_Austin_TX_78748_M71750-88272https://www.realtor.com/realestateandhomes-detail/9321-Bentley-Garner-Ln_Austin_TX_78748_M71750-8827242222757062015single_family{4 fields}{2 fields}https://ap.rdcpix.com/66b9d164a07769e1087bbb5c4fbf2e72l-m1126874305s.jpg[3 items][2 items]{1 fields}true
375479425273003555439for_sale3450002026-11-12T08:54:54.000000Z1997-03-3110002-Oak-Run-Dr_Austin_TX_78758_M75479-42527https://www.realtor.com/realestateandhomes-detail/10002-Oak-Run-Dr_Austin_TX_78758_M75479-4252732145584331972single_family{4 fields}{2 fields}https://ap.rdcpix.com/025d083c3ebc358bc8c181ab2d5d13dbl-m1720510087s.jpg[3 items][1 item]{1 fields}true

Recorded from our API · 3 items shown · 21 datapoints per itemGET /v1/realtor-com/search?status=for_sale&location=Austin%2C+TX&per_page=10&min_beds=3

21 datapoints

Identity

  • property_idstring
  • listing_idstring
  • statusstring
  • typestring

Contact

  • permalinkstring
  • urlurl

Location

  • addressobject

Reputation

  • primary_photourl
  • photosstring[]

Price

  • list_priceinteger

Other

  • list_datestring
  • last_sold_datestring
  • bedsinteger
  • bathsinteger
  • sqftinteger
  • lot_sqftinteger
  • year_builtinteger
  • coordinatesobject
  • advertisersobject[]
  • flagsobject
  • unit_data_availableboolean

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/realtor-com/search?status=for_sale&location=Austin%2C+TX&per_page=10&min_beds=3" \
  -H "X-API-Key: $API_KEY"

Realtor.com · 5 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/realtor-com/agent
property_id
1 credit
GET/v1/realtor-com/autocomplete
query+2 optional
1 credit
GET/v1/realtor-com/listing
property_id
1 credit
GET/v1/realtor-com/schools
property_id+2 optional
1 credit
GET/v1/realtor-com/search
status+18 optional
1 credit

Overview

What you can get

The Realtor.com API returns Realtor.com property data as JSON through 5 endpoints.

  • Search: search takes a status (for_sale, for_rent or sold) and a location, or latitude, longitude and radius_mi, with type[] (repeatable), sort (list_date, list_price or sold_date), order (asc or desc), sold_within_days, page, per_page, min_price, max_price, min_beds, max_beds, min_baths, max_baths, min_sqft and max_sqft.
  • Listings: listing takes a property_id.
  • Agents: agent takes a property_id.
  • Schools: schools takes a property_id, with radius_mi and limit_per_level.
  • Autocomplete: autocomplete takes a query, with limit and area_types[] (repeatable).

The recorded search for homes for sale in Austin, TX with min_beds=3 and per_page=10 returns listings, each with property_id, listing_id, status, list_price, list_date, last_sold_date, beds, baths, sqft, lot_sqft, year_built, type, address, coordinates, photos and advertisers. It also returns total_matching_count (4,497), count, page, per_page and has_more.

How a call works

Search a city: GET /v1/realtor-com/search?status=for_sale&location=Austin, TX&per_page=10&min_beds=3 with your key in the X-API-Key header. Each listing carries a property_id, the parameter listing, agent and schools all take. Check has_more before asking for the next page. Every successful call costs 1 credit; failed calls cost nothing.

Real estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

Use cases

Track list prices and new listings in a US city or radius

Use the Realtor.com API to track list prices and new listings in a US city or radius

Pull recent sales for comparables with `status=sold` and `sold_within_days`

Use the Realtor.com API to pull recent sales for comparables with `status=sold` and `sold_within_days`

Add nearby schools to a listing with `schools`

Use the Realtor.com API to add nearby schools to a listing with `schools`

Find the listing agent and office for a property with `agent`

Use the Realtor.com API to find the listing agent and office for a property with `agent`

FAQ

Questions

Do I need a Realtor.com account?

No. You call this Realtor.com API with your Perceptlayer key in the `X-API-Key` header, with no Realtor.com login.

How much does the Realtor.com API cost?

Each successful call costs one credit, and each search page is one call. New accounts get free credits to start, and credit packs bring the price down as you scale.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Can I search around a point instead of a place name?

Yes. Pass `latitude`, `longitude` and `radius_mi` to `search` in place of `location`.

Should I build a Realtor.com scraper instead?

You can, but a Realtor.com scraper is code you maintain: page changes break it, requests get blocked, and Realtor.com's terms govern how you collect data. The Realtor.com API gives you 5 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the Realtor.com API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs