For AI agents: llms.txt.

Address lookup

Request example

POST/api/v1/address
Scope
dossier
Formats
JSON · SSE
Sandbox
Free fixtures

Authorization

Authorizationheaderrequired

Send Bearer $DEEPSEARCH_API_KEY with the dossier scope. The free sandbox uses the published test key.

Body parameters

addressstringrequired

A street address with the building number, street and town, 6 to 200 characters, for example 350 5th Ave, New York, NY 10118. Names, phone numbers, email addresses and URLs are rejected with invalid_address.

formatenum

json collects the result; sse streams progress and result events.

jsonsse

Default: json

sandboxboolean

Return deterministic, unmetered fixtures.

Default: false

Response

JSON responses preserve the operation result and include request metadata, usage, and collected events. SSE delivers progress and result events as they arrive.

Sources & coverage

Submit a street address and get a property & place report for it: the location and how precisely it matched on public map data, the building, value estimates and sale history from public listings, flood and natural-hazard risk (US), nearby schools (US), nearby places and walkability, neighbourhood statistics (US), sold prices and street crime (England & Wales), and the businesses and registered companies at the address. The report describes the place, never the people: it never names or identifies anyone who lives at, owns, rents or occupies an address, and its written overview is filtered for statements about residents. Coverage varies by country, and a section without public data is left out, which does not mean the information does not exist. Public information only; not an FCRA report. Access requires an API key or an OAuth grant; agent wallets and per-call payments cannot run it.

Usage & caching

Every address report is a fresh build and uses usage. Nothing is cached, so nobody can learn that someone else looked an address up, and a repeated request runs again. Retry with the same Idempotency-Key to replay a completed JSON response without a second charge.

Examples illustrate the contract. Test request runs the selected deployment; sandbox fixtures are unmetered.

Skip to content