# RealtyCrawl

> Source-linked real estate observations through REST, MCP, and agent skills.

- [Build with RealtyCrawl](https://docs.realtycrawl.dev/introduction.md): Source-linked real estate observations through one API.
- [Your first request](https://docs.realtycrawl.dev/quickstart.md)
- [Authentication and credits](https://docs.realtycrawl.dev/authentication.md)
- [Coverage and evidence](https://docs.realtycrawl.dev/coverage.md)
- [Response schema](https://docs.realtycrawl.dev/response-schema.md)
- [Pagination](https://docs.realtycrawl.dev/pagination.md)
- [Errors and retries](https://docs.realtycrawl.dev/errors.md)
- [Connect with MCP](https://docs.realtycrawl.dev/mcp-guide.md)
- [Agent skills](https://docs.realtycrawl.dev/agent-skills.md)
- [API examples](https://docs.realtycrawl.dev/examples.md)
- [API reference](https://docs.realtycrawl.dev/api-reference.md): Explore the contract and verify live availability before execution.
- [List platform research and availability states](https://docs.realtycrawl.dev/api-reference/listPlatforms.md): Proposed interface. Enable only for documented and verified source/country capabilities. Platform registry
- [Describe source and country capabilities](https://docs.realtycrawl.dev/api-reference/listCapabilities.md): Proposed interface. Enable only for documented and verified source/country capabilities. Per-provider contracts
- [List schema versions](https://docs.realtycrawl.dev/api-reference/listSchemas.md): Proposed interface. Enable only for documented and verified source/country capabilities. Canonical contract
- [Search selected listing platforms](https://docs.realtycrawl.dev/api-reference/searchListings.md): Verified for the platforms listed in x-live-verified-platforms. Consult /v1/meta/capabilities for current enablement and accepted selectors. Sale searches only. Stored listing, media and history observations expire after 24 hours; they do not trigger a fresh crawl.
- [Resolve a listing URL or source ID](https://docs.realtycrawl.dev/api-reference/resolveListing.md): Verified for the platforms listed in x-live-verified-platforms. Consult /v1/meta/capabilities for current enablement and accepted selectors. Sale searches only. Stored listing, media and history observations expire after 24 hours; they do not trigger a fresh crawl.
- [Get Listing](https://docs.realtycrawl.dev/api-reference/getListing.md): Verified for the platforms listed in x-live-verified-platforms. Consult /v1/meta/capabilities for current enablement and accepted selectors. Sale searches only. Stored listing, media and history observations expire after 24 hours; they do not trigger a fresh crawl.
- [Get Listing Media](https://docs.realtycrawl.dev/api-reference/getListingMedia.md): Verified for the platforms listed in x-live-verified-platforms. Consult /v1/meta/capabilities for current enablement and accepted selectors. Sale searches only. Stored listing, media and history observations expire after 24 hours; they do not trigger a fresh crawl.
- [Get Listing History](https://docs.realtycrawl.dev/api-reference/getListingHistory.md): Verified for the platforms listed in x-live-verified-platforms. Consult /v1/meta/capabilities for current enablement and accepted selectors. Sale searches only. Stored listing, media and history observations expire after 24 hours; they do not trigger a fresh crawl.
- [Get Listing Open Houses](https://docs.realtycrawl.dev/api-reference/getListingOpenHouses.md): Proposed interface. Enable only for documented and verified source/country capabilities. Licensed feeds / source-published schedules
- [Get Similar Listings](https://docs.realtycrawl.dev/api-reference/getSimilarListings.md): Proposed interface. Enable only for documented and verified source/country capabilities. Separate source recommendation contract required
- [Search one platform](https://docs.realtycrawl.dev/api-reference/searchPlatformListings.md): Verified for the platforms listed in x-live-verified-platforms. Consult /v1/meta/capabilities for current enablement and accepted selectors. Sale searches only. Stored listing, media and history observations expire after 24 hours; they do not trigger a fresh crawl.
- [Get listing by platform native ID](https://docs.realtycrawl.dev/api-reference/getPlatformListing.md): Proposed interface. Enable only for documented and verified source/country capabilities. Requires native-ID lookup or explicit URL resolver
- [Resolve physical property identity](https://docs.realtycrawl.dev/api-reference/resolveProperty.md): Proposed interface. Enable only for documented and verified source/country capabilities. Address/parcel providers; ambiguous results retained
- [Get Property](https://docs.realtycrawl.dev/api-reference/getProperty.md): Proposed interface. Enable only for documented and verified source/country capabilities. Property identity and records
- [Get Property Listings](https://docs.realtycrawl.dev/api-reference/getPropertyListings.md): Proposed interface. Enable only for documented and verified source/country capabilities. Explicitly matched source advertisements
- [Get Property Records](https://docs.realtycrawl.dev/api-reference/getPropertyRecords.md): Proposed interface. Enable only for documented and verified source/country capabilities. ATTOM / RentCast / licensed records
- [Get Property Transactions](https://docs.realtycrawl.dev/api-reference/getPropertyTransactions.md): Proposed interface. Enable only for documented and verified source/country capabilities. Recorded or licensed transactions
- [Get Property Tax Assessments](https://docs.realtycrawl.dev/api-reference/getPropertyTaxAssessments.md): Proposed interface. Enable only for documented and verified source/country capabilities. Specific assessment endpoint entitlement
- [Get Property Valuations](https://docs.realtycrawl.dev/api-reference/getPropertyValuations.md): Proposed interface. Enable only for documented and verified source/country capabilities. RentCast / HouseCanary / licensed AVM
- [Get Property Comparables](https://docs.realtycrawl.dev/api-reference/getPropertyComparables.md): Proposed interface. Enable only for documented and verified source/country capabilities. RentCast valuation comparables or licensed comps
- [Get a building](https://docs.realtycrawl.dev/api-reference/getBuilding.md): Proposed interface. Enable only for documented and verified source/country capabilities. StreetEasy / Apartments / Zillow detail subject to contract
- [Get advertised units and floor plans](https://docs.realtycrawl.dev/api-reference/getBuildingUnits.md): Proposed interface. Enable only for documented and verified source/country capabilities. Unit expansion; completeness explicitly scoped
- [Search developments](https://docs.realtycrawl.dev/api-reference/searchDevelopments.md): Proposed interface. Enable only for documented and verified source/country capabilities. Dedicated source search contract; no blanket platform support
- [Get development](https://docs.realtycrawl.dev/api-reference/getDevelopment.md): Proposed interface. Enable only for documented and verified source/country capabilities. Dedicated source detail contract
- [Search agents](https://docs.realtycrawl.dev/api-reference/searchAgents.md): Proposed interface. Enable only for documented and verified source/country capabilities. Dedicated source search contract; no blanket platform support
- [Get agent](https://docs.realtycrawl.dev/api-reference/getAgent.md): Proposed interface. Enable only for documented and verified source/country capabilities. Dedicated source detail contract
- [Get professional listing portfolio](https://docs.realtycrawl.dev/api-reference/getAgentListings.md): Proposed interface. Enable only for documented and verified source/country capabilities. Source portfolio pagination contract
- [Search agencies](https://docs.realtycrawl.dev/api-reference/searchAgencies.md): Proposed interface. Enable only for documented and verified source/country capabilities. Dedicated source search contract; no blanket platform support
- [Get agency](https://docs.realtycrawl.dev/api-reference/getAgency.md): Proposed interface. Enable only for documented and verified source/country capabilities. Dedicated source detail contract
- [Get professional listing portfolio](https://docs.realtycrawl.dev/api-reference/getAgencyListings.md): Proposed interface. Enable only for documented and verified source/country capabilities. Source portfolio pagination contract
- [Search auctions](https://docs.realtycrawl.dev/api-reference/searchAuctions.md): Proposed interface. Enable only for documented and verified source/country capabilities. Dedicated source search contract; no blanket platform support
- [Get auction](https://docs.realtycrawl.dev/api-reference/getAuction.md): Proposed interface. Enable only for documented and verified source/country capabilities. Dedicated source detail contract
- [Search markets](https://docs.realtycrawl.dev/api-reference/searchMarkets.md): Proposed interface. Enable only for documented and verified source/country capabilities. Dedicated source search contract; no blanket platform support
- [Read a named source market series](https://docs.realtycrawl.dev/api-reference/getMarketSeries.md): Proposed interface. Enable only for documented and verified source/country capabilities. RentCast / PropertyData / official market datasets
- [Search property-focused accommodation](https://docs.realtycrawl.dev/api-reference/searchStays.md): Proposed interface. Enable only for documented and verified source/country capabilities. Airbnb/Vrbo actors or approved Booking/Rapid read APIs
- [Get accommodation details](https://docs.realtycrawl.dev/api-reference/getStay.md): Proposed interface. Enable only for documented and verified source/country capabilities. Source detail contract
- [Get a dated guest-specific price quote](https://docs.realtycrawl.dev/api-reference/getStayQuote.md): Proposed interface. Enable only for documented and verified source/country capabilities. Booking/Rapid pricing or independently verified scraper quote
- [Read calendar observations](https://docs.realtycrawl.dev/api-reference/getStayAvailability.md): Proposed interface. Enable only for documented and verified source/country capabilities. Specific calendar contract; unavailable does not mean booked
- [Read paginated accommodation reviews](https://docs.realtycrawl.dev/api-reference/getStayReviews.md): Proposed interface. Enable only for documented and verified source/country capabilities. Airbnb review actor; Booking review dataset
- [Find source-compatible locations](https://docs.realtycrawl.dev/api-reference/searchLocations.md): Proposed interface. Enable only for documented and verified source/country capabilities. Official geography/autocomplete source contract
- [Request asynchronous read collection](https://docs.realtycrawl.dev/api-reference/createReadJob.md): Proposed interface. Enable only for documented and verified source/country capabilities. Apify/Bright Data async collection semantics
- [Get read collection status](https://docs.realtycrawl.dev/api-reference/getReadJob.md): Proposed interface. Enable only for documented and verified source/country capabilities. Proposed job contract
- [Read completed collection results](https://docs.realtycrawl.dev/api-reference/getReadJobResults.md): Proposed interface. Enable only for documented and verified source/country capabilities. Proposed job contract

## OpenAPI Specs

- [openapi](/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.