API Quick Start Guide

This guide gets you from zero to your first REST API call.

1. Create an API key

Sign in to the Land Insights app.
Open Settings → API keys.
Create a key. It’s shown once — copy it right away and keep it somewhere safe.

Keys start with lipk_. You can revoke a key at any time from the same screen.

2. Make your first request

Search for parcels by owner name within a county (identified by its 5-digit FIPS code). Replace the key with your own:

curl -s "https://app-api.landinsights.co/api/public/v1/properties/search/?fips=06037&owner_name=smith" \
  -H "Authorization: Bearer lipk_your_key_here"

A successful response is a paginated JSON result:

{
  "count": 42,
  "next": "https://app-api.landinsights.co/api/public/v1/properties/search/?fips=06037&owner_name=smith&page=2",
  "previous": null,
  "results": [
    { "id": 1234567, "apn": "1234-567-890", "owner_name": "SMITH JANE", "...": "..." }
  ]
}

Every response includes an X-Tokens-Used header showing exactly what the call cost:

X-Tokens-Used: 10

3. Next steps

Authentication — using and managing your key.
Making requests — base URL, pagination, and response headers.
Errors — what error responses look like.
Token costs — what each call costs.
API reference — every endpoint and its options.