Skip to content

API overview

Planned

The API is planned for the Builder plan and isn’t live yet. The paths, fields and limits here show the intended shape and may change before launch. The API reference is generated from a sample specification.

The API gives your own tools the same data as the app: a parcel’s card, its site measurements, and whole-county screening against a buy box. Typical uses are pulling Acresift data into a deal pipeline or spreadsheet, and running a nightly screen that feeds your own alerts.

Base address

https://api.acresift.com/v1

Every request needs an API key except GET /v1/coverage, which is public.

What’s in it

Request What it returns
GET /v1/coverage What data is loaded in each state, the same as the coverage map
GET /v1/parcels/{id} One parcel: size, owner, mailing address, values, last sale
GET /v1/parcels/{id}/site Buildable acres, flood, wetland, slope, frontage, water, stormwater, zoning
POST /v1/screen The parcels in one or more counties that fit a buy box, a page at a time

A first request

Terminal window
curl https://api.acresift.com/v1/parcels/37105-9654-29-5146-00 \
-H "Authorization: Bearer $ACRESIFT_KEY"

Conventions

  • Requests and responses are JSON.
  • Areas are in acres, lengths in feet, money in whole US dollars, dates as YYYY-MM-DD.
  • null means unknown, never zero. A parcel with floodPct: null hasn’t been measured; one with floodPct: 0 has no flood zone.
  • Errors return a status code and { "error": "short_code", "message": "What went wrong" }.
  • Lists are paged. Pass the next value from one page as cursor to get the next.