API overview

Team plan

The API comes with the Team plan; write to us for a key. The API reference is generated from the API’s own code, so it always matches.

The API gives your own tools the same parcel data as the app: the parcel card, site facts, sale and owner history, and county screening against a buy box. Use it to feed a deal pipeline or spreadsheet, or to run a nightly screen for your own alerts.

Base address

https://api.acresift.com/v1

Every request needs an API key except GET /v1/coverage and GET /v1/sources. The reference is also at https://api.acresift.com/docs, and the machine-readable spec at https://api.acresift.com/openapi.json.

What’s in it

Request	What it returns
GET /v1/coverage	How much data is loaded per state and county (public)
GET /v1/sources	Where each kind of data comes from and when it was last pulled (public)
GET /v1/parcels?county=…	A county’s parcels, optionally inside a map box and acre range, a page at a time
GET /v1/parcels/{id}	One parcel: size, owner, mailing address, tax value, last sale, building
GET /v1/parcels/{id}/site	Buildable acres, flood, wetland, slope, road frontage, water, stormwater program
GET /v1/parcels/{id}/sales	Last recorded sale and each tax value change
GET /v1/parcels/{id}/owners	Each change of owner or tax-bill address
POST /v1/screen	Parcels in up to 10 counties that fit a buy box, a page at a time

For-sale listings are not in the API.

A first request

curl https://api.acresift.com/v1/parcels/37105012685 \
  -H "Authorization: Bearer $ACRESIFT_KEY"

Conventions

• JSON in and out. Field names follow the RESO Data Dictionary where it has the concept (LotSizeAcres, TaxAssessedValue, ClosePrice); our own measurements use the same style (BuildableAreaAcres, FloodZonePercent, RoadFrontageFeet).
• Areas in acres and hectares, lengths in feet and metres, money in whole USD. Dates are ISO 8601. Counties are 5-digit Census codes (37105 is Lee County, NC).
• Locations are WGS 84. BoundingBox is [west, south, east, north], the GeoJSON order.
• null means unknown, never zero: FloodZonePercent: null wasn’t measured; 0 means no flood zone.
• Every measured value carries a Provenance object (SourceId, SourceName, AsOf). A parcel’s ParcelKey stays the same while the county keeps the parcel.

Paging

Lists come in ParcelKey order, up to 500 a page (limit, default 100). Pass a page’s next back as cursor for the next page; next is null on the last one.

Errors

Errors use the problem details format (RFC 9457):

{
  "type": "https://acresift.com/docs/api/errors#not_found",
  "title": "Not found",
  "status": 404,
  "detail": "No parcel 37105000000.",
  "instance": "/v1/parcels/37105000000"
}

See Errors for every status.