# AcreLens

> Land intelligence API for AI agents. Structured land suitability reports for any US property — off-grid, rural residential, recreational, and investment modes.

## Docs

- [AcreLens API](https://docs.acrelens.com/index.md): Structured land intelligence for any US property address — built for developers.
- [Quickstart](https://docs.acrelens.com/quickstart.md): Sign up, grab a key, and pull your first land analysis report — five minutes end-to-end.
- [Authentication](https://docs.acrelens.com/authentication.md): Bearer-token API keys, test vs live environments, and rotation.
- [Analysis modes](https://docs.acrelens.com/concepts/analysis-modes.md): Four evaluation lenses — pick the one that matches what your users are trying to decide.
- [Report lifecycle](https://docs.acrelens.com/concepts/report-lifecycle.md): From `202 Accepted` to a completed report — the four states a report passes through and what to expect at each.
- [Quota & billing](https://docs.acrelens.com/concepts/quota-and-billing.md): How AcreLens charges, how free trial reports work, and how to control spend.
- [Idempotency](https://docs.acrelens.com/guides/idempotency.md): Use `Idempotency-Key` to make `POST /v1/analyze` and `POST /v1/batch` safe to retry.
- [Webhooks](https://docs.acrelens.com/guides/webhooks.md): Receive `report.completed`, `report.failed`, and `batch.completed` events with HMAC-SHA256-signed payloads.
- [Batch analysis](https://docs.acrelens.com/guides/batch-analysis.md): Submit up to 50 properties in one call with `POST /v1/batch`.
- [MCP server](https://docs.acrelens.com/guides/mcp-server.md): Use AcreLens directly from Claude (Desktop, Code, or any MCP client) — no glue code required.
- [n8n integration](https://docs.acrelens.com/guides/n8n.md): Run AcreLens land analyses inside any n8n workflow with our verified community node — drag-and-drop on n8n Cloud or self-hosted.
- [Endpoint reference](https://docs.acrelens.com/reference/endpoint-reference.md): Every public REST endpoint, request shape, and response shape.
- [Rate limits](https://docs.acrelens.com/reference/rate-limits.md): Per-second request limits, response headers, and how to handle `429` correctly.
- [Errors](https://docs.acrelens.com/reference/errors.md): Every error code AcreLens can return, the HTTP status it ships with, and how to handle each.
- [Pricing](https://docs.acrelens.com/reference/pricing.md): Per-report pricing, free trial, top-up minimums, and spend controls.


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