Property Search

Search and paginate through properties across states, counties, or cities. The “state” field is required. For best performance and lowest latency, include “state”, “county”, and “address” — ZIP codes and city names vary across data sources. By default, broad searches exclude parcels without assigned addresses; set “includeUnassignedAddress=true” to include them. Pagination: use the “cursor” parameter for efficient pagination at any depth — see the Pagination guide for full details. The legacy “offset” parameter still works but is deprecated.

GET /public/property/search

Property Search

cURL

curl --request GET \
  --url https://app.realie.ai/api/public/property/search/ \
  --header 'Authorization: <api-key>'

200

{
  "properties": [
    {}
  ],
  "metadata": {
    "limit": 123,
    "count": 123,
    "nextCursor": "<string>",
    "offset": 123,
    "deprecationNotice": "<string>"
  }
}

Authorizations

Authorization · string · header · required

Provide your API key directly in the header.

Query Parameters

state · string · required

Two-letter state (required field) (e.g., "CA")

zipCode · string

ZIP code of the property (optional field).

county · string

County where the property is located (optional field).

city · string

City where the property is located (optional field).

transferedSince · string

Days to look back for transfers (e.g., "30") (optional field).

useCode · integer

Numerical use code (e.g., 1002, 1001) (optional field).

address · string

The street address line 1 only (e.g. “123 Main Street”). Do not include city, state, or ZIP in this field. (optional field)

unitNumberStripped · string

The unit number of the property (optional field). Do not include the type of unit. (e.g. “APT 2B” would just be “2B”)

includeUnassignedAddress · boolean · default: false

If true, include parcels that do not yet have an assigned address. By default, broad searches exclude null or blank addresses.

limit · integer · default: 10

Maximum number of results to return. Defaults to 10, maximum is 100.

Required range: 1 <= x <= 100

cursor · string

Opaque pagination token. Pass the value from a previous response's "metadata.nextCursor" to retrieve the next page. Omit on the first request. Constant-time per page regardless of pagination depth — preferred over "offset" for paginating through more than a few hundred results.

offset · integer · default: 0

Deprecated. Number of records to skip. Defaults to 0. Use "cursor" instead — "offset" does not scale beyond a few thousand records and may produce timeout errors on deep pagination. Responses that include the "offset" parameter will return a "Deprecation: true" header along with a "metadata.deprecationNotice" field.

Required range: x >= 0

residential · boolean

If true, only residential properties; if false, only non-residential (optional field).

Response

200

application/json

Properties found successfully

properties · object[]

Array of property features found.

metadata · object

Show child attributes