Try any of 3860 endpoints — live.
Pick an endpoint, load a working example, tweak the params, and send — no signup to try. Results render the way the data deserves; raw JSON, headers & code are one tab away.
Search realestate.co.nz listings: homes for sale (default) or for rent, rural, commercial or business. Filter by region, district or suburb (names or ids), price, bedrooms, bathrooms, land and floor area, car parks, property type, sale method (auction, tender, deadline sale, negotiation, asking price …), keyword, open homes, new builds, pets and furnishing for rentals, agent or agency. Every row carries the listing URL, address and coordinates, the price exactly as shown plus the figure in it, sale method and auction/tender/deadline date, bedrooms, bathrooms, land and floor area, photos, open homes, and the listing agents (name, phone, mobile, email) with their agency.
What to search: homes for sale (default) or for rent, rural, commercial sale or lease, businesses. `purpose`=sale|rent also works.
Region name or id (Auckland = 35, Wellington, Canterbury, Waikato, Bay of Plenty …). One or several. `locations` lists every region, district and suburb with ids.
District name or id (Auckland City, North Shore City, Wellington City, Christchurch City …). One or several.
Suburb name, id or fq_slug. One or several. A name used by several suburbs (e.g. Hillcrest) is chosen by the region/district you also give, otherwise the request lists the candidates. The narrowest level wins: region=Auckland + suburb=Ponsonby searches Ponsonby.
Also include the suburbs the site lists as neighbours of the given suburb(s).
Lowest price, NZD (per week for residential rent). The site filters on the agent's search price, so listings shown as Auction / Negotiation can match. (0–)
Highest price, NZD (per week for residential rent). (0–)
Fewest bedrooms. (0–20)
Most bedrooms. (0–20)
Fewest bathrooms. (0–20)
Most bathrooms. (0–20)
Smallest land area in square metres (1 ha = 10000). (0–)
Largest land area in square metres. (0–)
Smallest floor area in square metres. (0–)
Largest floor area in square metres. (0–)
Fewest car parks. (1–20)
One or several property types. Residential sale: house, apartment, townhouse, unit, section, lifestyle_property, lifestyle_section, home_and_income, studio, retirement_living, multiple_properties, carpark, boat_shed. Rent: house, apartment, unit, townhouse, studio, lifestyle_property, holiday_rental, section, retirement_living, carpark, boat_shed. Rural, commercial and business categories have their own types (the error for an unknown type lists them).
How it is being sold, one or several: price_shown (any listing that shows a price), negotiation, auction, tender, poa, offers, deadline_sale, asking_price, enquiries_over … Not for residential rent.
A word the listing must contain (matched by the site's own keyword filter).
Only listings with an open home scheduled.
Only mortgagee sales.
Only new builds.
Only coastal / waterfront properties.
Only properties with a swimming pool.
Rentals only: pets allowed.
Only listings with floor plans.
Only listings with a video.
Only listings with a 3D walkthrough.
Rentals only: furnished, unfurnished, partly_furnished (one or several).
Only listings whose price changed in the last 28 days (the site's "pricing changes" filter; for sale only).
Only this agent's listings (every row returns agents[].agent_id).
Only this agency office's listings (every row returns agency.agency_id).
Order of results.
Result page, 1-based. page x limit can reach 10,000 results. (1–10000)
Listings per page, 1-100 (default 20). (1–100)
Advanced: how many times to retry a difficult request (1-5). (1–5)
curl -X POST https://api.reefapi.com/realestate-nz/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"region":"Auckland","limit":"10"}'Press Send request to see the live result here.
Not sure what to send? Ask Reef AIWhat you can run here, without an account
ReefAPI is one HTTP gateway to 632 live web-data APIs covering 3860 endpoints across 13 categories. Every endpoint answers with the same JSON envelope, so one integration reaches all of them. Each response reports what it cost and when the source was read.
No signup, no API key and no card are required to try an endpoint on this page. Anonymous calls run on a shared demo key, capped at 15 calls per hour per visitor. Pick an API, fill the parameters and the real response comes back from the live source, not from a canned sample. A free account lifts the cap and gives you 1,000 credits and your own key.
Browse every API in the catalog, read an endpoint's fields and example response in the docs, or see per-call credit costs on the pricing page.
Coverage by category
| ecommerce | 350 |
| classifieds | 116 |
| real-estate | 29 |
| media | 25 |
| utilities | 18 |
| jobs | 18 |
| developer-tools | 18 |
| reviews | 15 |
| social | 15 |
| search-seo | 11 |
| travel | 8 |
| other | 5 |
| finance | 4 |