SpotCheck Developer API

Endpoint

Every response is area-level, never a specific street address. There is no address parameter and there will not be one: this API resolves coordinates, slugs and place names to the surrounding area only. Analysis of one specific property is SpotCheck's paid report product; see the link at the bottom of this page.

Choose exactly one of the three resolution modes below per request.

1. Coordinates (lat + lon)

Live, precise-point resolution. Use this when you already have coordinates.

curl "https://spotcheck.property/api/v1/area-scores?lat=-43.52&lon=172.59"

2. Area slug (slug)

Use a SpotCheck area path in the form <country>/<city> or <country>/<city>/<area>, for example one copied from an /area/... URL or from a previous response's area.slug.

curl "https://spotcheck.property/api/v1/area-scores?slug=nz/christchurch/fendalton"

3. Place name (q)

Free-text name matching against published area and city names. Add country (nz, au, uk, us, ca or ie) to narrow a name that exists in more than one country.

curl "https://spotcheck.property/api/v1/area-scores?q=fendalton&country=nz"

Example response

{
  "area": {
    "name": "Fendalton",
    "city": "Christchurch",
    "country": "nz",
    "unit": "Statistical Area 2 (SA2)",
    "geo_code": "123456",
    "slug": "nz/christchurch/fendalton",
    "centroid": {"lat": -43.52, "lon": 172.59}
  },
  "scores": {"safety": 88, "clean_air": 81, "quiet": 47},
  "approx": {"safety": false, "clean_air": false, "quiet": true},
  "measures": { "...": "one entry per present factor, see below" },
  "scale": {
    "safety": "0-100, higher is safer",
    "clean_air": "0-100, higher is cleaner",
    "quiet": "0-100, higher is quieter (inverse of modelled loudness)"
  },
  "data_updated": "2026-08-01",
  "attribution": "Area scores by SpotCheck (https://spotcheck.property)",
  "page_url": "https://spotcheck.property/area/nz/christchurch/fendalton",
  "report_url": "https://spotcheck.property/?src=api-v1#propertyPanel",
  "notice": "Area-level teaser scores. Per-property analysis is in the paid SpotCheck report."
}

scores, approx, measures and scale each list only the factors SpotCheck has data for at that area — a missing factor means no data, never zero. Each entry in measures carries a self-describing description sentence naming the value, unit, geography, source and period together.

Reading the scores

Every score runs 0 to 100. Higher is always the better outcome for that factor, but which real-world direction that means differs per factor — always check the scale object rather than assuming.

Factor	Scale
safety	0-100, higher is safer
clean_air	0-100, higher is cleaner
quiet	0-100, higher is quieter (inverse of modelled loudness)

quiet is already inverted from raw noise level, so a high quiet score is the calm, good result — a score of 80 means quiet, not noisy.

Rate limit and caching

60 requests per minute per IP address, unauthenticated. Successful responses carry Cache-Control: public, max-age=86400, stale-while-revalidate=604800 and Access-Control-Allow-Origin: *, so they can be cached and called directly from a browser.

Attribution

This is a free service. If you display or quote these scores, please include the attribution string from the response (or a clear credit to SpotCheck with a link to spotcheck.property) rather than presenting the numbers as unsourced.

OpenAPI specification

A full OpenAPI 3.1 description of this endpoint, including every parameter and response field, is published at a stable URL for tools, custom GPTs and API clients to fetch directly.

• OpenAPI spec (YAML)
• Browse area pages