# RealtyCrawl

> Real-estate data API: Zillow homes for sale, sold and for rent across the US, plus property details with full price and tax history, and Zillow's Zestimate. Typed rows with the same core fields for every source.

Base URL: https://api.realtycrawl.com/v1. Auth: `Authorization: Bearer <key>` (keys start with `rc_`). OpenAPI: https://realtycrawl.com/openapi.json.

## Get started

- [Introduction](https://realtycrawl.com/docs/index.md): RealtyCrawl is a real-estate data API. Search homes for sale, sold homes and rentals, and get property facts with full price and tax history, as typed JSON.
- [Quickstart](https://realtycrawl.com/docs/quickstart.md): Make your first RealtyCrawl call, poll a pending job, and read the rows.
- [Authentication](https://realtycrawl.com/docs/authentication.md): Send your API key as a Bearer token on every call. Keys start with rc_.

## API reference

- [How every call works](https://realtycrawl.com/docs/api/overview.md): Jobs and polling, credits, paging with cursors, field notes, rate limits and the response envelope, the same on every RealtyCrawl route.
- [Inputs and types](https://realtycrawl.com/docs/api/inputs.md): The shared location, filter, paging and lookup inputs, and the Money, Address and Location types used in every row.
- [Errors](https://realtycrawl.com/docs/api/errors.md): Every RealtyCrawl error code, what it means and what to do. Calls that fail are never charged.
- [Zillow](https://realtycrawl.com/docs/sources/zillow.md): Zillow homes for sale, sold homes, rentals, property details with full price and tax history, and the Zestimate, through RealtyCrawl.
- [Zillow homes for sale](https://realtycrawl.com/docs/api/zillow-listings.md): Homes for sale in an area on Zillow, one page at a time. Costs 1 credit.
- [Zillow sold homes](https://realtycrawl.com/docs/api/zillow-sold.md): Homes sold in an area on Zillow, with sale price, sale date and how the price is known. Costs 1 credit.
- [Zillow rentals](https://realtycrawl.com/docs/api/zillow-rentals.md): Homes and apartment buildings for rent in an area on Zillow. Costs 1 credit.
- [Zillow property details](https://realtycrawl.com/docs/api/zillow-property.md): Facts about one home on Zillow: size, type, year built, listing agent, last sale, county tax record, and the full price and tax history, including for sold and off-market homes. Costs 2 credits.
- [Zillow estimate](https://realtycrawl.com/docs/api/zillow-estimate.md): Zillow's Zestimate and Rent Zestimate for one home, labeled as Zillow's. Costs 1 credit.
- [Get a job](https://realtycrawl.com/docs/api/jobs-get.md): Poll a call that returned 202. Long-poll with wait=20. Polling is free.
- [Usage](https://realtycrawl.com/docs/api/usage.md): Your plan, credits used and left, and credits by endpoint. Free to call.
- [Status](https://realtycrawl.com/docs/api/status.md): Live health of each source and route, from real jobs and canary searches. No key needed.

## Guides

- [MCP server](https://realtycrawl.com/docs/guides/mcp.md): Connect Claude, Cursor, VS Code or any MCP client to RealtyCrawl's hosted MCP server and look up homes for sale, sold homes, rentals and property history with your API key.