# Zillow API

> A REST API for U.S. real estate data. Look up properties by URL, address, or zpid; search listings; extract multi-unit buildings; run async batches; get results via signed webhooks. Built for AI agents and SaaS products.

Auth is `Authorization: Bearer zk_…`. Errors return `{ error: { code, message, request_id } }`. Async endpoints return `{ data: { job_id, status } }` with a `202` and notify completion via signed HMAC-SHA256 webhooks.

## Start here
- [Welcome](https://zillapi.com/): Overview and entry points
- [Quickstart](https://zillapi.com/quickstart/): First call in 60 seconds, all four languages
- [Authentication](https://zillapi.com/authentication/): Keys, rotation, revocation

## Core concepts
- [Errors](https://zillapi.com/errors/): Stable error codes + HTTP status mapping
- [Rate limits & quotas](https://zillapi.com/rate-limits/): Per-minute caps + monthly quota by plan
- [Pagination](https://zillapi.com/pagination/): `limit`/`offset`/`has_more`
- [Output formats](https://zillapi.com/output-formats/): JSON, CSV, NDJSON
- [Field projection](https://zillapi.com/field-projection/): `?fields=zpid,address.streetAddress`
- [Async jobs](https://zillapi.com/async-jobs/): Polling vs webhooks
- [Webhooks](https://zillapi.com/webhooks-guide/): HMAC-SHA256 signature, retries, examples

## API reference
- [Properties](https://zillapi.com/api/properties/): Single lookups + 9 sub-resources (photos, price-history, tax-history, schools, nearby, agent, zestimate, open-houses, facts) + bulk batch
- [Buildings](https://zillapi.com/api/buildings/): Multi-unit extraction (apartments, condos)
- [Listings](https://zillapi.com/api/listings/): Status presets + REST GET wrapper with bbox
- [Search](https://zillapi.com/api/search/): Structured filters + chained search→detail
- [Jobs](https://zillapi.com/api/jobs/): List, inspect, results
- [Webhooks API](https://zillapi.com/api/webhooks/): Manage subscriptions
- [Account](https://zillapi.com/api/account/): `/v1/me`, `/v1/usage`

## Recipes
- [Get full property by zpid](https://zillapi.com/recipes/full-property/): Cache-first sub-resource fan-out
- [Search → details (chained)](https://zillapi.com/recipes/search-then-detail/): One job, two stages
- [Verify a webhook signature](https://zillapi.com/recipes/verify-webhook/): Node, Python, Go

## Machine-readable
- [OpenAPI 3.1 spec](https://zillapi.com/openapi.json): Full spec, every endpoint
- [llms-full.txt](https://zillapi.com/llms-full.txt): Every doc page concatenated for context windows

## For AI agents
- [For AI agents & LLMs](https://zillapi.com/ai-agents/): Tooling, conventions, function-calling templates