# Redfin homes for sale: `POST /v1/redfin/search`

Cost: 2 credits (2 per page (an empty page and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/redfin-search

One page of active Redfin listings (up to 350).

Pass a city, zipcode or neighborhood page. Each listing carries price,
address, beds/baths, size, year built, property type, coordinates,
status, MLS id and the Redfin detail URL.

Request body (JSON):

- `url` (string (uri); required; min length 1, max length 2083): A redfin.com city, zipcode or neighborhood page URL.
- `limit` (integer; optional; default 40; min 1, max 350): Maximum listings to return (Redfin caps one page at 350).

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)