Plotted API

The Plotted real estate API and property API. REST + JSON, bearer-token auth, 150M+ U.S. property records with owners, contacts, dwelling attributes, and spatial queries. Base URL: https://api.plotted.to

Quickstart

Three steps. Should take under five minutes.

1. Get a key

Sign up at plotted.to/pricing. The free plan gives you 100 credits — enough to try every endpoint.

2. Hit the API

curl "https://api.plotted.to/v1/parcels?state=FL&mail_zip=34102&limit=5" \
  -H "Authorization: Bearer plt_live_***"

3. Parse the response

{
  "data": [
    {
      "row_id": 8421947823,
      "state": "FL",
      "county": "Collier",
      "owner_name": "NAPLES BAY HOLDINGS LLC",
      "is_trust": false,
      "situs_address": "4421 GULF SHORE BLVD N",
      "mail_zip": "34102",
      "year_built": 2003,
      "bedrooms": 4,
      "lat": 26.142441,
      "lon": -81.795822
      // ...35 more columns
    }
  ],
  "page": { "limit": 5, "next_cursor": "eyJyb3dfaWQiOjg0MjE5NDc4MjN9" },
  "meta": { "credits_used": 1, "credits_remaining": 99999, "latency_ms": 31 }
}

Authentication

Bearer token in the Authorization header. Keys are scoped to your account — never embed them in client-side code. Keys start with plt_live_ (production) or plt_test_ (sandbox, doesn't count against credits).

Authorization: Bearer plt_live_***
Content-Type:  application/json     // for POST endpoints

Credits & rate limits

Every API call costs 1 credit, except:

• 2 credits — /v1/parcels/nearby_address, /v1/parcels/within, /v1/person/search, /v1/people/search, and /v1/companies/search (these run a geocode or a filter-first scan)
• POST /v1/match and POST /v1/match_and_expand — 1 credit per record submitted
• GET /v1/person/reveal — 1 credit, automatically refunded if no contact is on file
• Sandbox keys (plt_test_) — free, but limited to 100 req/min and return synthetic data
• GET /v1/health, GET /v1/suggest (autocomplete), and 4xx responses — free

Rate limits by plan:

When you hit a rate limit you get 429 Too Many Requests with a Retry-After header.

Errors

Errors return a JSON envelope with a stable code string and a human-readable message.

{
  "error": {
    "code": "invalid_parameter",
    "message": "radius_mi must be between 0.01 and 50",
    "param": "radius_mi",
    "request_id": "req_01H8Z3X4..."
  }
}

Pagination

List endpoints accept limit (max 1,000, default 50) and return a page.next_cursor. Pass it back as cursor to get the next page. Cursors are opaque and expire after 60 minutes.

Core endpoints

Filter and list records. All filters AND-combined. Returns paginated.

curl "https://api.plotted.to/v1/parcels?state=FL&is_trust=true&has_contact=true&limit=10" \
  -H "Authorization: Bearer $KEY"

Fetch one record by its stable row_id. Use this for cached deep-links.

Fuzzy trigram search across owner_name and owner1..owner5.

Spatial endpoints

Address → lat/lon, using our own parcel data (no third-party geocoder). Returns the best-confidence match.

Lat/lon → closest parcel within max_dist_m (default 200m).

Radius search around a point. Combines with every /v1/parcels filter.

curl "https://api.plotted.to/v1/parcels/nearby" -G \
  -d "lat=26.142&lon=-81.795&radius_mi=1" \
  -d "is_trust=true&has_contact=true" \
  -H "Authorization: Bearer $KEY"

Response adds distance_mi to each record, sorted ascending.

Same as /nearby, but takes an address string instead of lat/lon — we geocode it for you in the same call.

All neighbors on the same normalized street as the given parcel. Suffix-tolerant (DR ≡ DRIVE ≡ DRV).

All parcels inside a GeoJSON Polygon or MultiPolygon. For drawing arbitrary regions on a map.

{
  "geometry": {
    "type": "Polygon",
    "coordinates": [[[-81.80,26.13],[-81.78,26.13],
                     [-81.78,26.16],[-81.80,26.16],[-81.80,26.13]]]
  },
  "filters": { "is_trust": true },
  "limit": 500
}

Rectangle / map-viewport queries.

Curated views

Pre-filtered to mail_zip ≠ situs_zip. Accepts state, min_distance_mi, and all standard filters.

Pre-filtered to is_trust = true. Accepts state + standard filters.

Pre-filtered to owner-occupied homes — every homeowner record across the dataset, in one call.

Bulk endpoints

Send a list of up to 10,000 addresses. Get back the enriched parcel record for each.

{
  "items": [
    { "address": "4421 Gulf Shore Blvd N", "city": "Naples", "state": "FL" },
    { "address": "100 Bayfront Pl",        "city": "Naples", "state": "FL" }
  ]
}

Response: array of { input, match: parcel|null, confidence: 0–1 }.

Match each input, then return all parcels within radius_mi of each match. Includes filters.

{
  "items": [/* up to 10,000 addresses */],
  "radius_mi": 0.5,
  "filters": { "is_trust": true }
}

Enrichment & company data

Attach people, contacts, professional/LinkedIn profiles, business firmographics, and property overlays to an address, a person, or a company — backed by nationwide professional profiles plus national business and property data.

Everything known at an address: the property, the people who live/own there, and distress & public-record overlays.

One of address_id or address+zip is required.

Resolve a person → identity, addresses, entities controlled, and political giving, plus a LinkedIn professional layer (title, company, industry) when matched by email, phone, or LinkedIn URL.

Provide one key. Name lookups require zip or state.

Search professional profiles nationwide. Provide one anchor — linkedin_url, company, or last — and refine with job title, role, industry, region, or first name.

Example: /v1/person/search?company=Google&title=engineer&limit=25

Business registry (officers, registered agent, addresses) blended with LinkedIn firmographics (website, industry, size, LinkedIn URL, headcount).

One of ein or name is required.

Filter-first prospecting (Apollo / ZoomInfo style) over profiles nationwide. Combine any filters below; multi-value is comma-separated. Contacts are gated — reveal email & phone with /v1/person/reveal.

Example: /v1/people/search?title=vp%20engineering&industry=software&region=CA&has_email=1

Filter-first company search over 49M firmographic profiles.

Spend 1 credit to unlock a profile's email(s) and phone(s) by LinkedIn URL. If no contact is on file, the call returns 404 and the credit is automatically refunded.

Record schema

Every list response contains records with these columns. Nullable unless marked.

Changelog

• v1.0 — 2026-06-11. Public launch. 150,000,000+ records. 51 states.