# Top Villas Realty

> Public property listings, community guides and market reports. Read and search without browser automation using GET requests; no account or API key is needed for public content.

## How to search and read

- [Agent guide](<https://realty.thetopvillas.com/for-agents.md>): Search parameters, examples, coverage, pagination, units, timestamps and access boundaries.
- [Search options](<https://realty.thetopvillas.com/api/public/search/options>): Supported cities, ZIP codes, property types and community IDs.
- [Search listings](<https://realty.thetopvillas.com/api/public/search>): JSON search using the documented URL parameters.
- [Search pages](<https://realty.thetopvillas.com/search.md>): Markdown results with listing links and pagination.

## Public content

- [Home and community guides](<https://realty.thetopvillas.com/index.md>): Follow community and editorial links.
- [Market reports](<https://realty.thetopvillas.com/market-report.md>): Published reports; Markdown includes their public sections.

Request text/markdown with the Accept header, or append .md to a public page path. Use /index.md for the homepage. Keep query strings after the suffix. Cite canonical browser URLs. JSON and Markdown show public information regardless of cookies; member-only content and unpublished drafts are excluded. See the guide for source attribution and freshness semantics.