Using the API v1
Thank you for your interest in our Parcel API! Please direct feedback, bugs and questions to help@regrid.com.
The Parcel API supports searching by location (lat/lon), parcel number (APN), parcel street address, and now the ability to query parcels by polygon. A partial owner name search is still a work in progress and described below. The API does not yet support queries by other attributes. Have a specific need in mind you don't see covered here? Please reach out to our team with details.
General Introduction
Endpoints
All API requests are to the https://app.regrid.com/ domain. You can review our full description of endpoints at Regrid API Endpoints.
Responses
All API requests return a GeoJSON object containing an array of GeoJSON Features, each Feature containing one matched Parcel Record. An empty results set with no error means no Parcel Records could be matched based on the search criteria.
API Billing
Parcel API requests are tracked for billing by how many Parcel Records are returned in a response.
You will get multiple Parcel Records returned per Parcel API request depending on how you search for parcels via our Parcel API. Searches by address, parcel number, owner name, radius and polygon are all examples of Parcel API requests that will return multiple Parcel Records in each response.
The limit parameter will limit the number of Parcel Records returned by a Parcel API request. The default limit is 20 Parcel Records, but can be set to any number from 1 to 1000. The limit parameter is available for any Parcel API request that can return more than one Parcel Record. You can also find additional methods to narrowing your search for parcel records.
The Parcel API usage stats endpoint described also provides real time usage information that can be used for monitoring Parcel Records remaining in your monthly or annual plan. There is no cost to using this endpoint. You are also able to use this endpoint within your workflow to track usage internally.
Authentication
All API requests must include a token parameter. You can find this in Account Settings > API after logging into your account at regrid.com.
API request rates
API request rates are defined in terms of the maximum number of requests allowed per minute. Exceeding the API request rate will result in a 429 error for rate limiting/throttling. The API server will reject any additional requests until the rate limit resets. It is important to adhere to the rate limits to avoid disruption in service and ensure compliance with Regrid's terms of use.
Rates are limited to 10 simultaneous API requests or approximately 200 API requests per minute. Additional capacity is available; please contact our sales team at parcels@regrid.com for details.