# Zillow homes for sale: `POST /v1/zillow/search`

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

One Zillow search page (~40 listings).

Each listing carries price, address, beds/baths, size, status,
coordinates, photo and the detail URL. Pass a location name or a Zillow
search URL.

Request body (JSON):

- `location` (string | null; optional): US location name, e.g. 'Chicago, IL'. Needed unless url is given.
- `url` (string (uri) | null; optional; min length 1, max length 2083): A zillow.com search page URL; overrides location.
- `limit` (integer; optional; default 40; min 1, max 200): Maximum listings to return.

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)