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/v1Every 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
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. nullmeans unknown, never zero. A parcel withfloodPct: nullhasn’t been measured; one withfloodPct: 0has no flood zone.- Errors return a status code and
{ "error": "short_code", "message": "What went wrong" }. - Lists are paged. Pass the
nextvalue from one page ascursorto get the next.