# ParcelAPI

> Pay-per-record HTTP API for public US property parcel records and building permit records, built for AI agents and developers. 1 credit = 1 record returned. Prepaid credits, no subscriptions, no accounts. Free trial: 1,000 credits (one per IP per 30 days).

API base: https://api.parcelapi.net
Auth (REST): header `X-API-Key: <key>`
MCP: https://api.parcelapi.net/mcp (Streamable HTTP, header `Authorization: Bearer <key>`)
MCP server card: https://api.parcelapi.net/.well-known/mcp.json
OpenAPI spec: https://api.parcelapi.net/openapi.json
Interactive docs: https://api.parcelapi.net/docs
Contact: support@parcelapi.net

## Get started
- Free trial key (1,000 credits, shown once): `POST /v1/keys/trial`
- Query parcels: `POST /v1/parcels/query` {state (required), county, city, address (prefix), limit 1-1000, offset 0-10000}
- Query permits: `POST /v1/permits/query` {state (required), city, county, address, permit_type, issued_after, issued_before (YYYY-MM-DD), limit, offset}
- Balance: `GET /v1/credits`
- Packs: `GET /v1/credits/packs`
- Top up: `POST /v1/credits/topup` {pack} -> checkout_url
- New key purchase: `POST /v1/credits/purchase` {pack} -> checkout_url; then `POST /v1/keys/claim?session_id=cs_...`
- Area not loaded: 202 fetch_queued (free); poll `GET /v1/fetch/{job_id}`

## MCP tools
query_parcels, query_permits, get_credit_balance, list_credit_packs, buy_credits, claim_api_key, get_fetch_job. Same billing and limits as REST. Setup: https://parcelapi.net/mcp

## Pricing (USD, one-time via Stripe; credits never expire)
- starter: 10,000 credits, $5
- growth: 100,000 credits, $40
- scale: 1,000,000 credits, $300
- enterprise: 10,000,000 credits, $2,000
An empty search costs 1 credit; a timed-out search costs 0.

## Coverage
Over 100 million parcel records. Parcel data for parts or all of 29 states: AL, AR, CA, CT, FL, IL, IN, MA, MD, ME, MI, MN, MO, MS, MT, NC, ND, NJ, NV, NY, OH, OR, PA, SC, TX, UT, WA, WI, WV. Coverage varies by county. No owner names or personal contact data. Some areas are restricted (403).
- Permits: 32 cleared open-data feeds, loaded on demand (first query for an area returns 202 fetch_queued): Arlington TX, Austin TX, Baton Rouge (East Baton Rouge Parish) LA, Birmingham AL, Boston MA, Buffalo NY, Cincinnati OH, Columbus OH, Hartford CT, Jersey City NJ, Long Beach CA, Miami FL, Milwaukee WI, Minneapolis MN, New Orleans LA, New York City NY, Newark NJ, Pittsburgh PA, Providence RI, Sacramento County CA, San Antonio TX, San Diego (city) CA, San Diego County CA, San Francisco CA, San Jose CA, Seattle WA, Spokane County WA, St. Paul MN, Tacoma WA, Wake County NC, Washington DC, Worcester MA. Applicant/contractor personal data is stripped; attribution is returned per source.
- Rate limits: 120 requests/min per IP; per key 120/min (paid keys) or 60/min (trial keys); trial key requests 3/hour per IP. Over the limit: 429.

## Errors
401 invalid key, 402 insufficient_credits, 403 restricted/disabled, 422 bad input, 429 rate limit, 503 query_timeout (not charged).

## Policies
- Terms: https://parcelapi.net/terms
- Privacy: https://parcelapi.net/privacy
- Refunds (14 days): https://parcelapi.net/refund