Overview

Land Insights Public API v1

Programmatic access to Land Insights property, market, and comp data. Endpoints are versioned at /api/public/v1/; only additive changes will be made within v1. Each endpoint declares its token cost in the description — empty results are not billed.

Every response includes an X-Tokens-Used header reporting the exact number of tokens billed for that request (0 on empty results or errors).

Errors

Every 4xx/5xx response uses a single envelope:

{"error": {"code": "validation_error", "message": "...", "request_id": "..."}}

Validation errors add an error.details object mapping each rejected field to its messages. Every response (success or error) includes an X-Request-Id header, mirrored into request_id — quote it in support requests.

code	status	meaning
`unauthorized`	401	missing or invalid credentials
`forbidden`	403	authenticated but not permitted
`subscription_required`	402	a Pro subscription is required
`tier_upgrade_required`	402	API tier lacks direct REST access
`usage_limit_exceeded`	402	usage cap reached — resets next billing period
`payment_required`	402	unpaid API add-on invoice — settle to restore access
`validation_error`	400	invalid request parameters
`not_found`	404	resource does not exist
`method_not_allowed`	405	HTTP method not supported
`rate_limited`	429	too many requests — back off and retry
`internal_error`	500	unexpected server error

Information

OpenAPI version: 3.0.3

Authentication

publicApiBearer

Bearer token issued by the Land Insights Public API. Direct REST clients use a long-lived lipk_… Personal Access Token (scope api:direct); MCP clients use a short-lived auth-code-issued token (scope api:mcp).

Security scheme type: http

Overview

Land Insights Public API v1

Errors

Operations

Authentication

publicApiBearer