{"id":"d987ac66-ed1f-4f18-a3fe-ca86ad03e099","slug":"realtor-com-api","name":"realtor.com API","description":"Realtor.com API providing access to real estate property listings, detailed property data, agent and brokerage profiles, location autocomplete, and market analytics. Supports filtering by price, location, property type, bedrooms, bathrooms, and listing status across for-sale and for-rent markets.","front_facing_description":"Search millions of real estate listings on Realtor.com, view detailed property information, find qualified agents in your area, and access market analytics to understand pricing trends. Get location suggestions and property insights all in one place to help you make informed decisions about buying, selling, or investing in real estate.","source_url":"https://realtor.com","is_authenticated":false,"canonical_scraper_id":"8fac95fb-f5aa-42ec-8b47-f4c2de511855","apis":[{"method":"GET","endpoint_name":"search_properties","description":"Search for real estate properties by location (city/state or ZIP code) with support for status, price, beds, baths, and property type filters. Returns paginated results sorted by the specified field. Pagination is offset-based with limit and offset parameters. Each property summary includes basic details; use get_property_details for full information including history and schools.","input_params":{"limit":{"type":"integer","required":false,"description":"Number of results to return per page.","default":20,"domain":{"kind":"open","example":5,"pattern":"^\\d+$","generator":{"type":"static","value":"5"}}},"offset":{"type":"integer","required":false,"description":"Pagination offset (number of results to skip).","default":0,"domain":{"kind":"open","example":0,"pattern":"^\\d+$","generator":{"type":"static","value":"0"}}},"status":{"type":"string","required":false,"description":"JSON array of listing statuses to filter by. Accepted values include 'for_sale' and 'for_rent'. Example: '[\"for_sale\"]'.","default":"[\"for_sale\"]","domain":{"kind":"open","example":"[\"for_sale\"]","pattern":"^\\[.+\\]$","generator":{"type":"static","value":"[\"for_sale\"]"}}},"beds_min":{"type":"integer","required":false,"description":"Minimum number of bedrooms filter.","domain":{"kind":"open","example":2,"pattern":"^\\d+$","generator":{"type":"static","value":"2"}}},"location":{"type":"string","required":true,"description":"Location to search. Accepts 'City, ST' format (e.g. 'Austin, TX') or a 5-digit ZIP code (e.g. '78701').","domain":{"kind":"open","example":"Austin, TX","pattern":"^.+$","generator":{"type":"static","value":"Austin, TX"}}},"baths_min":{"type":"number","required":false,"description":"Minimum number of bathrooms filter.","domain":{"kind":"open","example":1,"pattern":"^[\\d.]+$","generator":{"type":"static","value":"1"}}},"max_price":{"type":"integer","required":false,"description":"Maximum listing price filter.","domain":{"kind":"open","example":500000,"pattern":"^\\d+$","generator":{"type":"static","value":"500000"}}},"min_price":{"type":"integer","required":false,"description":"Minimum listing price filter.","domain":{"kind":"open","example":100000,"pattern":"^\\d+$","generator":{"type":"static","value":"100000"}}},"sort_field":{"type":"string","required":false,"description":"Field to sort results by.","default":"list_date","enum":"SortField","closed":true,"domain":{"kind":"enum","values":["list_date","list_price"],"generator":{"type":"enum_pick","strategy":"first"},"source_selector":"sort dropdown"}},"property_type":{"type":"string","required":false,"description":"JSON array of property types to filter by. Accepted values include 'single_family', 'condos', 'multi_family', 'mobile', 'land', 'farm', 'townhomes'. Example: '[\"single_family\", \"condos\"]'.","domain":{"kind":"open","example":"[\"single_family\"]","pattern":"^\\[.+\\]$","generator":{"type":"static","value":"[\"single_family\"]"}}},"sort_direction":{"type":"string","required":false,"description":"Sort direction.","default":"desc","enum":"SortDirection","closed":true,"domain":{"kind":"enum","values":["asc","desc"],"generator":{"type":"enum_pick","strategy":"first"},"source_selector":"sort direction toggle"}}},"return_schema":{"type":"object","fields":{"count":"integer, number of properties returned in this response","total":"integer, total number of matching properties available","properties":"array of property summary objects with property_id, list_price, list_date, status, description, location, and photos"},"sample":{"data":{"count":5,"total":7299,"properties":[{"href":"https://www.realtor.com/realestateandhomes-detail/14909-Fitzhugh-Rd-Unit-B_Austin_TX_78736_M78938-42560","photos":[{"href":"http://ap.rdcpix.com/example.jpg"}],"status":"for_sale","location":{"address":{"city":"Austin","line":"14909 Fitzhugh Rd Unit B","state_code":"TX","postal_code":"78736"}},"list_date":"2026-06-10T03:04:39.000000Z","list_price":2690000,"listing_id":"2996872196","description":{"beds":3,"sqft":3400,"type":"farm","lot_sqft":552428,"baths_consolidated":"3.5"},"property_id":"7893842560"}]},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.properties","op":"array_min_len","value":1},{"path":"$.data.total","op":"not_null"},{"path":"$.data.count","op":"not_null"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_property_details","description":"Retrieve comprehensive details for a specific property including full description text, photos, price history, tax history, and nearby schools. Requires a property_id obtained from search_properties results.","input_params":{"property_id":{"type":"string","required":true,"description":"Unique property ID from search_properties results (e.g. '7893842560').","domain":{"kind":"derived","path":"$.data.properties[0].property_id","generator":{"type":"derived"},"from_endpoint":"search_properties"}}},"return_schema":{"type":"object","fields":{"photos":"array of photo objects with href URLs","status":"string, current listing status","schools":"object containing schools array with name, rating, and grades","location":"object containing address with line, city, state_code, postal_code","list_date":"string, ISO datetime when listed","list_price":"integer, current listing price","listing_id":"string, listing identifier","description":"object containing beds, baths_consolidated, sqft, lot_sqft, type, text, year_built","property_id":"string, unique property identifier","tax_history":"array of tax records with tax amount, year, and assessment total","property_history":"array of historical events with date, event_name, price"},"sample":{"data":{"photos":[{"href":"http://ap.rdcpix.com/example.jpg"}],"status":"for_sale","schools":{"schools":[{"name":"Dripping Springs Elementary School","grades":["K","1","2","3","4","5"],"rating":8}]},"location":{"address":{"city":"Austin","line":"123 Main St Unit B","state_code":"TX","postal_code":"78736"}},"list_date":"2026-06-10T03:04:39Z","list_price":2690000,"listing_id":"2996872196","description":{"beds":3,"sqft":3400,"text":"From the moment you arrive...","type":"farm","lot_sqft":552428,"year_built":1974,"baths_consolidated":"3.5"},"property_id":"7893842560","tax_history":[{"tax":8871,"year":2025,"assessment":{"total":542500}}],"property_history":[{"date":"2026-06-10","price":2690000,"event_name":"Listed","price_sqft":791.17,"price_change":0}]},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.property_id","op":"not_null"},{"path":"$.data.list_price","op":"not_null"},{"path":"$.data.description","op":"not_null"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"search_agents","description":"Search for real estate agents matched to a specific postal code. Returns agent profiles with experience, brokerage, and transaction history. Results include qualification status and a list of matched realtors.","input_params":{"postal_code":{"type":"string","required":true,"description":"5-digit US postal code to search for agents (e.g. '10001').","domain":{"kind":"open","example":"10001","pattern":"^\\d{5}$","generator":{"type":"static","value":"10001"}}}},"return_schema":{"type":"object","fields":{"realtors":"array of agent objects with name, license_number, brokerage_name, years_experience, sold_count","is_qualified":"boolean, whether qualified agents are available in the area","geodecoded_address":"object with city and state_code for the postal code"},"sample":{"data":{"realtors":[{"name":"Evelyn Garcia","sold_count":11,"brokerage_name":"Re/Max In The City","license_number":"10401285414","years_experience":9}],"is_qualified":true,"geodecoded_address":{"city":"New York","state_code":"NY"}},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.realtors","op":"not_null"},{"path":"$.data.geodecoded_address","op":"not_null"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_location_suggestions","description":"Get location autocomplete suggestions for a partial search input. Returns matching cities, postal codes, counties, and states with geographic coordinates and identifiers. Useful for validating or discovering location inputs for other endpoints.","input_params":{"input":{"type":"string","required":true,"description":"Partial location string to autocomplete (e.g. 'Aus').","domain":{"kind":"open","example":"Austin","pattern":"^.+$","generator":{"type":"static","value":"Austin"}}}},"return_schema":{"type":"object","fields":{"hits":"array of location match objects with area_type, city, state_code, centroid coordinates, and slug_id","meta":"object with es_total_hits count and version"},"sample":{"data":{"hits":[{"_id":"city:tx_austin","city":"Austin","_score":24.0157,"geo_id":"426c3033-22a7-50c7-ba07-1f2bb51db2d1","country":"USA","slug_id":"Austin_TX","centroid":{"lat":30.2986219,"lon":-97.7541339},"area_type":"city","state_code":"TX"}],"meta":{"es_took":7,"version":"v1.23.03a74505","es_total_hits":102}},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.hits","op":"array_min_len","value":1},{"path":"$.data.meta","op":"not_null"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_market_analytics","description":"Retrieve market analytics including median listing price for a given location. Provides a high-level snapshot of the local housing market for investment analysis or comparison.","input_params":{"location":{"type":"string","required":true,"description":"Location to get analytics for. Accepts 'City, ST' format (e.g. 'Austin, TX') or a 5-digit ZIP code.","domain":{"kind":"open","example":"Austin, TX","pattern":"^.+$","generator":{"type":"static","value":"Austin, TX"}}}},"return_schema":{"type":"object","fields":{"location":"string, the queried location","median_listing_price":"integer, median listing price in the area"},"sample":{"data":{"location":"Austin, TX","median_listing_price":550000},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.location","op":"not_null"},{"path":"$.data.median_listing_price","op":"not_null"}],"empty_is_valid":false,"recipe_version":1}}],"sample_inputs":{"search_agents":{"postal_code":"10001"},"search_properties":{"limit":"5","offset":"0","status":"[\"for_sale\"]","beds_min":"2","location":"Austin, TX","baths_min":"1","max_price":"500000","min_price":"100000","sort_field":"list_date","property_type":"[\"single_family\"]","sort_direction":"asc"},"get_agent_listings":{},"get_market_analytics":{"location":"Austin, TX"},"get_property_details":{"property_id":"7646622743"},"get_location_suggestions":{"input":"Austin"}},"prefill_inputs":{"search_properties":{"limit":"5","offset":"0","status":"[\"for_sale\"]","beds_min":"2","location":"Austin, TX","baths_min":"1","max_price":"500000","min_price":"100000","sort_field":"list_date","property_type":"[\"single_family\"]","sort_direction":"asc"},"search_agents":{"postal_code":"10001"},"get_location_suggestions":{"input":"Austin"},"get_market_analytics":{"location":"Austin, TX"}},"last_verified_at":"2026-10-28T22:02:53.739995+00:00","endpoint_health":[{"endpoint_name":"search_properties","status":"healthy","last_checked_at":"2026-10-28T22:02:53.739995+00:00","last_verified_at":"2026-10-28T22:02:53.739995+00:00","recent_runs":[{"at":"2026-10-28T22:02:53.739995+00:00","status":"healthy"},{"at":"2026-10-21T21:04:25.406847+00:00","status":"healthy"},{"at":"2026-10-14T20:04:25.196521+00:00","status":"healthy"},{"at":"2026-10-07T20:01:53.306249+00:00","status":"healthy"},{"at":"2026-09-30T20:00:53.105807+00:00","status":"healthy"}]},{"endpoint_name":"search_agents","status":"healthy","last_checked_at":"2026-10-28T22:02:53.739995+00:00","last_verified_at":"2026-10-28T22:02:53.739995+00:00","recent_runs":[{"at":"2026-10-28T22:02:53.739995+00:00","status":"healthy"},{"at":"2026-10-21T21:04:25.406847+00:00","status":"healthy"},{"at":"2026-10-14T20:04:25.196521+00:00","status":"healthy"},{"at":"2026-10-07T20:01:53.306249+00:00","status":"healthy"},{"at":"2026-09-30T20:00:53.105807+00:00","status":"healthy"}]},{"endpoint_name":"get_property_details","status":"healthy","last_checked_at":"2026-10-28T22:02:53.739995+00:00","last_verified_at":"2026-10-28T22:02:53.739995+00:00","recent_runs":[{"at":"2026-10-28T22:02:53.739995+00:00","status":"healthy"},{"at":"2026-10-21T21:04:25.406847+00:00","status":"healthy"},{"at":"2026-10-14T20:04:25.196521+00:00","status":"healthy"},{"at":"2026-10-07T20:01:53.306249+00:00","status":"healthy"},{"at":"2026-09-30T20:00:53.105807+00:00","status":"healthy"}]},{"endpoint_name":"get_location_suggestions","status":"healthy","last_checked_at":"2026-10-28T22:02:53.739995+00:00","last_verified_at":"2026-10-28T22:02:53.739995+00:00","recent_runs":[{"at":"2026-10-28T22:02:53.739995+00:00","status":"healthy"},{"at":"2026-10-21T21:04:25.406847+00:00","status":"healthy"},{"at":"2026-10-14T20:04:25.196521+00:00","status":"healthy"},{"at":"2026-10-07T20:01:53.306249+00:00","status":"healthy"},{"at":"2026-09-30T20:00:53.105807+00:00","status":"healthy"}]},{"endpoint_name":"get_market_analytics","status":"healthy","last_checked_at":"2026-10-28T22:02:53.739995+00:00","last_verified_at":"2026-10-28T22:02:53.739995+00:00","recent_runs":[{"at":"2026-10-28T22:02:53.739995+00:00","status":"healthy"},{"at":"2026-10-21T21:04:25.406847+00:00","status":"healthy"},{"at":"2026-10-14T20:04:25.196521+00:00","status":"healthy"},{"at":"2026-10-07T20:01:53.306249+00:00","status":"healthy"},{"at":"2026-09-30T20:00:53.105807+00:00","status":"healthy"}]}],"sdk_usage_example":null,"sdk_delivery_state":"absent","summary":"Comprehensive real estate data from Realtor.com including property listings, detailed property information, agent matching, location autocomplete, and market analytics.","updated_at":"2026-08-26T14:23:59.960622+00:00","user_variants":[],"latest_version":7,"user_status":null,"user_scraper_id":null,"contributes_to_marketplace":true,"pinned_version":null,"seo_content":{"faqs":[{"a":"Realtor.com does not offer a public developer API for listing data. The Move, Inc. / News Corp ecosystem that operates Realtor.com does not publish documented REST endpoints for third-party developer access to its listings database.","q":"Does Realtor.com have an official developer API?"},{"a":"The `get_property_details` endpoint adds several fields not present in `search_properties` results: `tax_history` (annual tax amounts and assessment totals), `property_history` (dated events including past sales and price changes), `schools` (nearby school names, ratings, and grade ranges), and an expanded `description` object that includes `sqft`, `lot_sqft`, `year_built`, and free-text description. The search endpoint returns summary-level fields only.","q":"What does `get_property_details` return beyond what appears in search results?"},{"a":"The endpoint accepts `status` filtering via a JSON array (e.g. `for_sale`, `for_rent`) and numeric filters for `min_price`, `max_price`, `beds_min`, and `baths_min`. The endpoint description references sort field support. There is no explicit property type filter exposed in the current parameter set. You can fork this API on Parse and revise it to add a property type filter if that field is available in the underlying data.","q":"Can I filter `search_properties` results by property type or sort field?"},{"a":"The `status` filter in `search_properties` accepts both `for_sale` and `for_rent` values, so both active sale listings and rentals are within scope. The `get_market_analytics` endpoint returns a single `median_listing_price` figure and does not currently expose a separate median rent metric. You can fork the API on Parse and revise it to add a rental-specific analytics endpoint.","q":"Does the API cover rental listings or only properties for sale?"},{"a":"The `search_properties` and `search_agents` endpoints accept US city/state combinations and 5-digit ZIP codes, so coverage is US-only. International property markets are not covered by the current endpoints. You can fork this API on Parse and revise it to add support for international real estate sources if needed.","q":"Is property coverage limited to specific US regions?"}],"keywords":["realtor.com API","real estate listings API","property search API by ZIP code","property details tax history API","real estate agent search API","median listing price API","location autocomplete real estate API","for sale for rent listings API","property price history API","school ratings property API","US housing market data API","property beds baths filter API","realtor agent brokerage API","home listing data developer API"],"use_cases":["Build a property search app filtering Realtor.com listings by price range, bedroom count, and rental vs. sale status","Display school ratings and tax history on individual property detail pages using `get_property_details` response fields","Match home buyers with local agents by postal code using the `search_agents` endpoint's brokerage and experience data","Power a location autocomplete input field with city, county, and ZIP suggestions from `get_location_suggestions`","Show median listing prices by city or ZIP for a market comparison dashboard using `get_market_analytics`","Track historical price changes and prior sale events for a specific property using the `property_history` array","Aggregate tax assessment records across a portfolio of properties by batching `get_property_details` requests"],"meta_title":"Realtor.com API – Property Listings & Market Data","generated_at":"2026-05-21T20:43:56.939670+00:00","lead_paragraph":"This API exposes 5 endpoints covering Realtor.com's property listings, detailed records, agent matching, and market analytics. Use `search_properties` to query active listings by city, state, or ZIP code with filters for price, beds, baths, and status, then pass a `property_id` to `get_property_details` to retrieve tax history, price history, school ratings, and full descriptions for any individual listing.","schema_version":2,"meta_description":"Access Realtor.com property listings, detailed property info, agent search, location autocomplete, and market analytics via a single REST API.","primary_category":"real_estate","long_description_md":"## Property Search and Details\n\nThe `search_properties` endpoint accepts a required `location` parameter in either `City, ST` or 5-digit ZIP format, and supports optional filters including `min_price`, `max_price`, `beds_min`, `baths_min`, and a `status` array that accepts values like `for_sale` and `for_rent`. Results are paginated via `limit` and `offset`, and each returned property object includes `property_id`, `list_price`, `list_date`, `status`, `description`, `location`, and `photos`.\n\nPassing a `property_id` from search results to `get_property_details` returns a richer record: the `description` object adds `beds`, `baths_consolidated`, `sqft`, `lot_sqft`, `type`, `text`, and `year_built`. The response also includes `tax_history` (an array of annual tax amounts and assessment totals), `property_history` (dated events such as price changes and prior sales), and a `schools` object with name, rating, and grade ranges for nearby institutions.\n\n## Agent Search and Location Utilities\n\nThe `search_agents` endpoint takes a 5-digit `postal_code` and returns agent profiles through the `upnest_automatch_agents_by_zip_code` object, which includes each agent's name, license number, brokerage name, and years of experience. The `get_location_suggestions` endpoint accepts a partial string and returns ranked `hits` — each with `area_type`, `city`, `state_code`, `postal_code`, `centroid` coordinates, and a `slug_id` — making it suitable for driving search autocomplete UI.\n\n## Market Analytics\n\nThe `get_market_analytics` endpoint accepts a city/state or ZIP code and returns `median_listing_price` for that area. This is a single aggregate figure per location query, useful for quick price benchmarking or trend dashboards when combined with search data from `search_properties`.","generated_with_model":"global.anthropic.claude-sonnet-4-6","secondary_categories":["maps_geo","finance"]},"primary_category":"real_estate","secondary_categories":["maps_geo","finance"],"access_requirements":[]}