API Reference

All endpoints return JSON and support CORS. No API key is required for basic use. Base URL: https://lotlyze.com

GET /api/v1/lookup

Resolve any address, BBL, or BIN to canonical identifiers.

Parameters

Name	Type	Required	Description
`query`	string	Yes	Address, 10-digit BBL, hyphenated BBL, or 7-digit BIN

Example

curl

curl "https://lotlyze.com/api/v1/lookup?query=250+Broadway+Manhattan"

JavaScript

const res = await fetch(
  "https://lotlyze.com/api/v1/lookup?query=250+Broadway+Manhattan"
);
const { bbl, bin, label } = await res.json();

Response

{
  "type": "address",
  "bbl": "1000477501",
  "bin": "1001074",
  "label": "250 Broadway, Manhattan, NY 10007",
  "source": "geosearch"
}

GET /api/v1/acris

Fetch ACRIS deed and document records for a property.

Parameters

Name	Type	Required	Description
`bbl`	string	Yes	10-digit Borough-Block-Lot

Example

curl

curl "https://lotlyze.com/api/v1/acris?bbl=1000477501"

Response

{
  "bbl": "1000477501",
  "records": [
    {
      "id": "2023012700123456",
      "date": "2023-01-27",
      "type": "DEED",
      "description": "DEED",
      "party1": "SELLER NAME",
      "party2": "BUYER NAME",
      "amount": 4500000,
      "formattedAmount": "$4,500,000"
    }
  ]
}

GET /api/v1/dob

Fetch DOB permits, job filings, violations, and complaints for a building.

Parameters

Name	Type	Required	Description
`bin`	string	Yes	7-digit Building ID Number

Example

curl

curl "https://lotlyze.com/api/v1/dob?bin=1001074"

GET /api/v1/summary

Full property summary: ACRIS + all DOB data in a single request. Resolves BBL to BIN automatically.

Parameters

Name	Type	Required	Description
`bbl`	string	Yes	10-digit Borough-Block-Lot

Example

curl

curl "https://lotlyze.com/api/v1/summary?bbl=1000477501"

Python

import httpx

data = httpx.get(
    "https://lotlyze.com/api/v1/summary",
    params={"bbl": "1000477501"}
).json()

print(data["acris"][0]["date"])   # most recent deed date
print(len(data["dob"]["violations"]))

POST /api/v1/bulk Developer only

Look up up to 50 BBLs in a single request. Returns ACRIS + DOB data for each. Requires a Developer API key in the Authorization header.

Parameters (POST body JSON)

Name	Type	Required	Description
`bbls`	string[]	Yes	Array of BBLs (10-digit or hyphenated). Max 50.

Example

curl

curl -X POST "https://lotlyze.com/api/v1/bulk" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bbls": ["3016070023", "1004770001", "4015670023"]}'

Rate limits & tiers

Tier	Price	Lookups / day	Bulk endpoint	API key
Free	$0	5 / day (IP)	No	No
Pro	$9 / mo	100 / day	No	Yes
Developer	$19 / mo	10,000 / day	Yes (50 BBLs/req)	Yes

Include your API key in the Authorization: Bearer <key> header. Keys are provisioned automatically on upgrade — visit your account.