Redfin API: Search properties

Search a region's for-sale listings with price, beds, baths, address, coordinates, MLS number and the agent's description. Requires region. Each row's url feeds /v1/redfin/property →.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

region*string

Redfin region URL or path, e.g. https://www.redfin.com/city/30818/TX/Austin or /zipcode/94110. Copy it from Redfin; don't build it yourself.

Lengthlength <= 500

num_homes?integer

How many listings to return, up to 1,000. There is no paging, so this is the only way to get more. If results_may_be_capped is true, ask for more.

Range1 <= value <= 1000

Default350

curl -X GET "https://example.com/v1/redfin/search?region=%2Fcity%2F30818%2FTX%2FAustin" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "region": "/city/30818/TX/Austin",    "url": "https://www.redfin.com/city/30818/TX/Austin",    "region_id": "30818",    "region_type": "6",    "market": "austin",    "results": [      {        "property_id": "801881",        "listing_id": "184290163",        "url": "https://www.redfin.com/CA/San-Francisco/331-Bartlett-St-94110/home/801881",        "mls_number": "424012345",        "mls_status": "Active",        "price": 1095000,        "price_per_sqft": 712,        "beds": 3,        "baths": 2,        "sqft": 1538,        "lot_size": null,        "year_built": 1900,        "property_type": 6,        "ui_property_type": "PROPERTY_TYPE_HOUSE",        "street": "331 Bartlett St",        "unit": null,        "city": "San Francisco",        "state": "CA",        "zip": "94110",        "country_code": "US",        "neighborhood": "Mission District",        "latitude": 37.7529,        "longitude": -122.4194,        "days_on_market": 14,        "time_on_redfin_ms": 1209600000,        "time_zone": "US/Pacific",        "description": "Beautifully updated Edwardian in the heart of the Mission.",        "listing_tags": {          "property1": null,          "property2": null        },        "key_facts": {          "property1": null,          "property2": null        },        "hoa": 450,        "is_new_construction": false,        "has_3d_tour": true,        "has_video_tour": false,        "photo_count": 42      }    ],    "count": 350,    "requested_num_homes": 350,    "max_num_homes": 1000,    "results_may_be_capped": false,    "result_code": 0,    "error_message": "Success",    "usage_note": "There is no page 2: Redfin ignores page_number and the sort order, so num_homes is the only lever — if results_may_be_capped is true, re-ask with a larger one. These are for-sale listings; sold listings are not offered. Each result's url is the exact value /redfin/property takes."  }}