> ## Documentation Index > Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt > Use this file to discover all available pages before exploring further. # Scrape Redfin real-estate listings > Searches Redfin for `location` (a city/state or ZIP) and returns the listings as JSON: `price`, `beds`, `baths`, `sqFt`, `lotSize`, address, coordinates, `propertyType`, `mlsStatus`, `mlsId`, `daysOnMarket`, `pricePerSqFt` and a clean `url`. Filter with `status` (for_sale / sold), `min_price`/`max_price`, `beds`, `baths` and `property_type`, sort with `sort`, and collect up to `max_results` across pages. Use `mode=detail` with a listing `url` for one home in full (agents, public records, tax, price history, Redfin Estimate). ## OpenAPI ````yaml /api-reference/openapi.json post /realestate/redfin openapi: 3.1.0 info: title: ScrapeUnblocker API description: >- Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate every request with the `x-scrapeunblocker-key` header. Three endpoints are documented here: page-source extraction, Google SERP scraping, and image fetch. All other paths exist for internal operations and are intentionally hidden from this spec. version: 3.0.0 servers: - url: https://api.scrapeunblocker.com description: Production security: [] paths: /realestate/redfin: post: tags: - Plugins summary: Scrape Redfin real-estate listings description: >- Searches Redfin for `location` (a city/state or ZIP) and returns the listings as JSON: `price`, `beds`, `baths`, `sqFt`, `lotSize`, address, coordinates, `propertyType`, `mlsStatus`, `mlsId`, `daysOnMarket`, `pricePerSqFt` and a clean `url`. Filter with `status` (for_sale / sold), `min_price`/`max_price`, `beds`, `baths` and `property_type`, sort with `sort`, and collect up to `max_results` across pages. Use `mode=detail` with a listing `url` for one home in full (agents, public records, tax, price history, Redfin Estimate). operationId: redfin_endpoint_realestate_redfin_post parameters: - name: mode in: query required: false schema: type: string description: '''search'' (listings for a location) or ''detail'' (one home by url).' default: search title: Mode description: '''search'' (listings for a location) or ''detail'' (one home by url).' - name: location in: query required: false schema: anyOf: - type: string - type: 'null' description: >- City/state or ZIP to search, e.g. 'Austin, TX' or '78704'. Search mode. title: Location description: >- City/state or ZIP to search, e.g. 'Austin, TX' or '78704'. Search mode. - name: url in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Redfin URL. Required for detail mode (a listing URL); optional in search mode (a city/zip page URL). title: Url description: >- Redfin URL. Required for detail mode (a listing URL); optional in search mode (a city/zip page URL). - name: status in: query required: false schema: type: string description: 'Listing status: for_sale, sold.' default: for_sale title: Status description: 'Listing status: for_sale, sold.' - name: max_results in: query required: false schema: type: integer maximum: 1750 minimum: 1 description: How many listings to collect across pages (~350 per page). default: 350 title: Max Results description: How many listings to collect across pages (~350 per page). - name: sort in: query required: false schema: type: string description: >- Ordering: recommended, newest, price_asc, price_desc, sqft, price_per_sqft. default: recommended title: Sort description: >- Ordering: recommended, newest, price_asc, price_desc, sqft, price_per_sqft. - name: property_type in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Property type filter: houses, condos, townhomes, multi_family, land, manufactured, other. Omit for all. title: Property Type description: >- Property type filter: houses, condos, townhomes, multi_family, land, manufactured, other. Omit for all. - name: min_price in: query required: false schema: anyOf: - type: integer minimum: 0 - type: 'null' description: Minimum price. title: Min Price description: Minimum price. - name: max_price in: query required: false schema: anyOf: - type: integer minimum: 0 - type: 'null' description: Maximum price. title: Max Price description: Maximum price. - name: beds in: query required: false schema: anyOf: - type: integer minimum: 0 - type: 'null' description: Minimum bedrooms. title: Beds description: Minimum bedrooms. - name: baths in: query required: false schema: anyOf: - type: integer minimum: 0 - type: 'null' description: Minimum bathrooms. title: Baths description: Minimum bathrooms. - name: sold_within_days in: query required: false schema: type: integer maximum: 1825 minimum: 1 description: 'For status=sold: look back this many days (default 90).' default: 90 title: Sold Within Days description: 'For status=sold: look back this many days (default 90).' - name: proxy_country in: query required: false schema: anyOf: - type: string - type: 'null' description: Exit-IP country (ISO-2). Defaults to a US exit for Redfin. title: Proxy Country description: Exit-IP country (ISO-2). Defaults to a US exit for Redfin. responses: '200': description: >- JSON with a `homes` array plus region and totals (search), or a `home` object (detail). content: application/json: schema: {} '400': description: Invalid parameters. '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '502': description: Blocked by Redfin, or the location could not be resolved. '504': description: Fetch timed out. security: - ScrapeUnblockerKey: [] components: schemas: HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: ScrapeUnblockerKey: type: apiKey in: header name: x-scrapeunblocker-key description: Your ScrapeUnblocker API key. Apply on every request. ````