docs / enrich-property

Property Snapshot API

base /enrich-property/v14 endpoints

post/enrich-property/v1/snapshot5 credits

address OR listing_url → one normalized property snapshot: status, price, sold-history, core facts, valuation (where available), per-field provenance + a match block (how the address was resolved + match_confidence).

Parameter		Allowed / range	Description
address	optional	—	Free-text property address (street + city + state/postcode). Provide this OR listing_url. For the most reliable match include the unit/apt and the postcode. Supported countries: US, UK, Japan.
listing_url	optional	—	A copied listing URL — routed to the right source automatically (zillow.com, redfin.com, realtor.com, rightmove.co.uk, suumo.jp). Provide this OR address.
country	optional	US · GB · JP	Optional ISO country hint to skip auto-detection (US/GB/JP). Recommended when an address is ambiguous (e.g. a bare ZIP/outcode).
mode = standard	optional	standard · rich · cross_validated	Depth of the snapshot. rich adds area market_context; cross_validated (US) reconciles facts across all 3 US sources.

Try in playground →

post/enrich-property/v1/resolve2 credits

address → ranked candidate listings[] (id + source + match_confidence) so the customer picks the exact property (apartment-unit / stale-listing disambiguation). The false-match-reducing flow — call this when a snapshot returns low confidence.

Parameter		Allowed / range	Description
address	optional	—	Free-text property address (street + city + state/postcode). Provide this OR listing_url. For the most reliable match include the unit/apt and the postcode. Supported countries: US, UK, Japan.
country	optional	US · GB · JP	Optional ISO country hint to skip auto-detection (US/GB/JP). Recommended when an address is ambiguous (e.g. a bare ZIP/outcode).
limit = 10	optional	1–25	Max candidate listings to return (resolve action).

Try in playground →

post/enrich-property/v1/batch5 credits

snapshot up to 10 addresses/listing-URLs in one call (standard mode, cache-first, per-item ok/error).

Parameter		Allowed / range	Description
items	required	—	Up to 10 addresses and/or listing URLs (array). Each is snapshotted independently; per-item ok/error.
country	optional	US · GB · JP	Optional ISO country hint to skip auto-detection (US/GB/JP). Recommended when an address is ambiguous (e.g. a bare ZIP/outcode).

Try in playground →

post/enrich-property/v1/coveragefree

Static capability map: which countries/sources are supported, per-country source set, and the documented gaps (UK has no AVM; JP only 4 prefectures). No sub-calls.

Try in playground →

Example request · snapshot

curl -X POST https://api.reefapi.com/enrich-property/v1/snapshot \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"listing_url":"https://www.zillow.com/homedetails/x/117892026_zpid/"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}