redfin_search
Read-onlyIdempotent
Retrieve parsed property listings from a Redfin search URL, including address, price, beds/baths, square footage, and URL. Build datasets of matching properties for analysis.
Instructions
Retrieve parsed Redfin search results for a search-results URL.
Returns a structured list of properties — address, price, beds/baths,
square footage, URL — from a Redfin search-results page (with its filters
encoded in the URL).
When to use:
- Collecting listings for an area or filter set from a Redfin search URL
- Building datasets of properties matching search criteria
When NOT to use:
- A single property (use 'redfin_for_sale' / 'redfin_for_rent')
Args:
params (RedfinSearchParams): url (required, full Redfin search URL with
filters) plus optional tld, country_code, and output_format.
Returns:
str: JSON (default) or CSV containing the structured search results.
Raises:
ToolError: If the API key is missing, the rate limit is exceeded, or
the request fails.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |