--- title: "Realtor.com API: JSON data, 5 endpoints, 1 credit per call" description: "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." url: https://perceptlayer.com/apis/realtor-com --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Realtor.com 1 credit per call 5 endpoints 21 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 key](https://perceptlayer.com/signup) Run 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 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | property\_id string | listing\_id string | status string | list\_price integer | list\_date string | last\_sold\_date string | permalink string | url url | beds integer | baths integer | sqft integer | lot\_sqft integer | year\_built integer | type string | address object | coordinates object | primary\_photo url | photos string\[\] | advertisers object\[\] | flags object | unit\_data\_available boolean | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 7009647360 | 3003557193 | for\_sale | 505000 | 2026-11-12T12:55:11.000000Z | 2018-10-24 | 5308-Sendero-Hills-Pkwy\_Austin\_TX\_78724\_M70096-47360 | https://www.realtor.com/realestateandhomes-detail/5308-Sendero-Hills-Pkwy\_Austin\_TX\_78724\_M70096-47360 | 3 | 3 | 2158 | 11064 | 2007 | single\_family | {4 fields} | {2 fields} | https://ap.rdcpix.com/37ab905f1f158ed85c739b908966eb64l-m1123946771s.jpg | \[3 items\] | \[1 item\] | {1 fields} | true | | 2 | 7175088272 | 3003556799 | for\_sale | 489899 | 2026-11-12T12:25:17.000000Z | — | 9321-Bentley-Garner-Ln\_Austin\_TX\_78748\_M71750-88272 | https://www.realtor.com/realestateandhomes-detail/9321-Bentley-Garner-Ln\_Austin\_TX\_78748\_M71750-88272 | 4 | 2 | 2227 | 5706 | 2015 | single\_family | {4 fields} | {2 fields} | https://ap.rdcpix.com/66b9d164a07769e1087bbb5c4fbf2e72l-m1126874305s.jpg | \[3 items\] | \[2 items\] | {1 fields} | true | | 3 | 7547942527 | 3003555439 | for\_sale | 345000 | 2026-11-12T08:54:54.000000Z | 1997-03-31 | 10002-Oak-Run-Dr\_Austin\_TX\_78758\_M75479-42527 | https://www.realtor.com/realestateandhomes-detail/10002-Oak-Run-Dr\_Austin\_TX\_78758\_M75479-42527 | 3 | 2 | 1455 | 8433 | 1972 | single\_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 item GET /v1/realtor-com/search?status=for\_sale&location=Austin%2C+TX&per\_page=10&min\_beds=3 21 datapoints ### Identity - property\_id string - listing\_id string - status string - type string ### Contact - permalink string - url url ### Location - address object ### Reputation - primary\_photo url - photos string\[\] ### Price - list\_price integer ### Other - list\_date string - last\_sold\_date string - beds integer - baths integer - sqft integer - lot\_sqft integer - year\_built integer - coordinates object - advertisers object\[\] - flags object - unit\_data\_available boolean Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/realtor-com/agent`](https://perceptlayer.com/apis/realtor-com/agent) | `property_id` | 1 credit | | [GET `/v1/realtor-com/autocomplete`](https://perceptlayer.com/apis/realtor-com/autocomplete) | `query` +2 optional | 1 credit | | [GET `/v1/realtor-com/listing`](https://perceptlayer.com/apis/realtor-com/listing) | `property_id` | 1 credit | | [GET `/v1/realtor-com/schools`](https://perceptlayer.com/apis/realtor-com/schools) | `property_id` +2 optional | 1 credit | | [GET `/v1/realtor-com/search`](https://perceptlayer.com/apis/realtor-com/search) | `status` +18 optional | 1 credit | Overview ## About the Realtor.com API ## 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 estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)