Piloterr

Redfin Search

GET
/v2/redfin/search

Search for-sale homes on Redfin from a city, neighborhood, or county link. Each listing url includes the market id to pass to the property endpoint.

Credit cost: 1 credit per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

Redfin for-sale link for a city, neighborhood, or county.

Example (city):

https://www.redfin.com/city/16163/WA/Seattle

Example (neighborhood):

https://www.redfin.com/neighborhood/56947/WA/Seattle/Capitol-Hill

Example (county):

https://www.redfin.com/county/118/WA/King-County

JSON: each results[].url includes region_id and region_type from that link. City is region_type 6, neighborhood is 1, county is 5. A home link, zip link, or /filter/ link returns 400.

page?number

Page of the for-sale feed, from 1.

Example:

2

Default: the page already in the link, otherwise 1.

JSON: page 2 rewrites the path to /page-2, sets pagination.page to 2, and sets pagination.next to the next link when the page is full. pagination.total_results and pagination.total_pages stay null. Overrides a page already in the link.

return_page_source?boolean

Optional. Default false.

false returns results and pagination. true returns {"result": ""} and omits the parsed listings.

Default"false"

Response Body

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/redfin/search?query=string'
Example Response
{  "results": [    {      "hoa": 825,      "url": "https://www.redfin.com/WA/Seattle/1120-8th-Ave-98101/unit-1603/home/14602?region_id=16163&region_type=6",      "zip": "98101",      "beds": 2,      "city": "Seattle",      "sqft": 1050,      "unit": "#1603",      "baths": 2,      "price": 526500,      "state": "WA",      "mls_id": "2573739",      "status": "Active",      "street": "1120 8th Ave #1603",      "remarks": "Live in the heart of First Hill with convenience, comfort, and city access at your doorstep. This spacious, freshly painted, condo is filled with natural light! The expansive living area is anchored by a cozy fireplace and a wall of floor-to-ceiling windows that open to a private juliet balcony, providing views during the day, and sparkling city lights at night. The primary suite boasts a large closet and private bath, while the spacious second bedroom provides the flexibility of a guest room, home office, or both. Enjoy the added comfort of A/C and in-unit washer/dryer, and the convenience of an oversized parking space in a secure garage and an additional storage unit. Seneca 8 amenities i",      "latitude": 47.6092374,      "lot_size": null,      "is_redfin": true,      "key_facts": [        "Secure garage",        "Cozy fireplace",        "In-unit washer dryer"      ],      "longitude": -122.3293587,      "agent_name": "Kiley Lazarus",      "listing_id": 224286680,      "open_house": null,      "year_built": 1970,      "broker_name": "Redfin",      "has_3d_tour": true,      "hoa_display": "$825",      "photo_count": 30,      "property_id": 14602,      "listing_tags": [        "PRIVATE JULIET BALCONY",        "COZY FIREPLACE",        "FLOOR-TO-CEILING WINDOWS",        "IN-UNIT WASHER DRYER",        "OVERSIZED PARKING SPACE",        "SECURE GARAGE"      ],      "neighborhood": "First Hill",      "price_display": "$526,500",      "property_type": "condo",      "price_per_sqft": 501,      "is_early_access": false,      "has_virtual_tour": true,      "price_per_sqft_display": "$501",      "has_interactive_floorplan": false    }  ],  "pagination": {    "next": "https://www.redfin.com/city/16163/WA/Seattle/page-2",    "page": 1,    "per_page": 40,    "total_pages": null,    "total_results": null  }}