# RealtyCrawl

Unified real estate data API. Research inventory: 206 sources. API contract: 67 operations. These counts do not represent verified live coverage.

Dated release snapshot (2026-11-10): 201 active platform entries; 891 callable platform-operation bindings (844 active, 47 documentation-backed beta). Check live capabilities for current availability. Beta evidence is provider_documentation_and_offline_tests, not fresh live source verification; preserve DOCUMENTED_SOURCE_BETA warnings. Research, unavailable and retired capabilities are not callable. One operation template can serve many platform bindings.

- Documentation: https://realtycrawl.dev/docs
- OpenAPI: https://realtycrawl.dev/v1/openapi.json
- Platforms: https://realtycrawl.dev/v1/meta/platforms
- Capabilities: https://realtycrawl.dev/v1/meta/capabilities
- Hosted MCP: https://realtycrawl.dev/mcp
- Agent skill: https://realtycrawl.dev/agent-onboarding/SKILL.md
- MCP source: https://github.com/realtycrawl/realtycrawl-mcp
- Installable skill: https://github.com/realtycrawl/realtycrawl-agent-skills
- API examples: https://github.com/realtycrawl/realtycrawl-api-examples

Authenticate with Authorization: Bearer $REALTYCRAWL_API_KEY. Check capabilities before source requests. Preserve source provenance, currencies, units, nulls, timestamps and partial-result warnings. POST requests accept Idempotency-Key. Use X-Max-Credits to limit a request. Zillow listing searches cost 3 credits per returned listing (default limit 10); other source crawls cost 50 credits per successful platform. Stored observation reads cost 1 credit; metadata and idempotent replays are free. Unified searches reserve 3 times limit for Zillow and 50 credits per other requested platform, then refund unused credits and unsuccessful platforms. Never infer housing eligibility from these records.

Monthly plans: Starter $15 for 2,500 credits/month; Growth $49 for 20,000 credits/month; Pro $299 for 150,000 credits/month. Eligible accounts receive 500 signup credits once. Monthly credits expire at period end without rollover or automatic overage charges. Existing balances remain nonexpiring and usable without subscribing. Expiring credits are spent first. Check checkout availability and manage billing at https://realtycrawl.dev/dashboard/payments.