bayleys.co.nz APIbayleys.co.nz ↗
Access Bayleys NZ property listings, agent profiles, office details, auctions, news, and magazines via 12 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/4574cfaa-dab1-4954-88c6-8df3ecce0f46/search_properties?page=1&page_size=3&search_types=Residential' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for property listings with various filters including location, price range, bedrooms, and property type. Returns paginated results sorted by the specified order type.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| bedrooms | integer | Minimum number of bedrooms. |
| keywords | string | Search keywords (e.g. location name, listing ID). |
| bathrooms | integer | Number of bathrooms. |
| car_parks | integer | Number of car parks. |
| max_price | integer | Maximum price filter. |
| min_price | integer | Minimum price filter. |
| page_size | integer | Number of results per page. |
| region_id | integer | Region ID to filter by. |
| order_type | string | Sort order type. |
| suburb_ids | string | Suburb IDs to filter by. |
| district_id | integer | District ID to filter by. |
| search_types | string | Property type filter. Accepted values: Residential, Commercial, Rural, Lifestyle, Business. Comma-separated for multiple (e.g. 'Residential,Lifestyle'). |
{
"type": "object",
"fields": {
"page": "current page number",
"items": "array of property listing summaries with listingId, address, saleInfo, images, icons, and features",
"pageSize": "results per page",
"totalItems": "total number of matching listings",
"numberOfPages": "total number of pages (may return 0 due to upstream bug)"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"region": "Auckland",
"suburb": "Pukekohe",
"heading": "Stylish new build living",
"district": "Franklin",
"saleInfo": "Auction",
"heroImage": "1973103_1.jpg",
"listingId": 1973103,
"listingIcons": [
{
"name": "bed",
"value": "4"
}
],
"marketingAddress": "32 Rongoa Maori Way, Pukekohe"
}
],
"pageSize": 3,
"totalItems": 4187,
"numberOfPages": 0
},
"status": "success"
}
}About the bayleys.co.nz API
The Bayleys NZ API covers 12 endpoints that expose property listings, agent profiles, office directories, upcoming auctions, news articles, and publications from bayleys.co.nz. You can query search_properties with filters for bedrooms, bathrooms, price range, and location keywords, then drill into any individual listing using get_property_details with the full URL slug. Each listing returns fields including address, saleInfo, images, icons, and features.
Property Search and Listing Details
The search_properties endpoint accepts filters for min_price, max_price, bedrooms, bathrooms, car_parks, and free-text keywords. Results are paginated and each item in the items array includes listingId, address, saleInfo, images, icons, and features. A convenience endpoint, search_residential_properties, applies the Residential type filter automatically. Note that numberOfPages may return 0 in some responses due to a known upstream issue; use totalItems and pageSize to calculate page count independently.
For full listing details, get_property_details requires the complete slug path — including region, district, address, and listing ID segments — and returns a listing object with address, description, agents, images, and sale information, alongside an office object for the listing branch.
Agents and Offices
search_people accepts keywords and region_id to locate agents, returning personnelId, name, position, contact details, and branch information. From there, get_agent_profile fetches a full bio, awards, and current listings by slug in the format /agents/{firstname}-{lastname}-{personnelId}. The get_agent_listings endpoint takes a numeric agent_id and returns paginated property summaries for that agent.
Office lookup follows the same pattern: search_offices returns branchId, branchName, address, telephone, email, and numberOfListings. get_office_profile and get_office_listings accept a slug or office_id respectively and return full office details alongside current listing summaries.
Auctions, News, and Magazines
get_upcoming_auctions returns scheduled auction listings across all property types, with each item including auctionDate and eventLocation. get_news supports tag-based filtering (e.g., Residential, Commercial) and returns article objects with title, description, url, tags, and publishedDate. get_magazines returns Bayleys publication issues with issueDate, title, description, image, and url, along with pagingMetadata that includes totalRecords, currentPage, pageSize, and pageCount.
- Build a property search tool filtered by bedroom count, price range, and location using
search_properties. - Display upcoming auction schedules with dates and event locations from
get_upcoming_auctions. - Create an agent directory that surfaces contact details and current listings per agent via
search_peopleandget_agent_listings. - Track listing counts per Bayleys office across New Zealand using
search_officesand thenumberOfListingsfield. - Aggregate Bayleys market commentary and reports by tag using
get_newswith thetagsfilter. - Embed Bayleys magazine covers and issue links in a publications feed using
get_magazinesresponse fields. - Sync a CRM with full property details, agent assignments, and office data by chaining
search_properties,get_property_details, andget_agent_profile.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Bayleys have an official public developer API?+
How do I filter property searches by type — for example, residential only?+
search_residential_properties applies the Residential type filter automatically and accepts page and page_size parameters. For other property types, use search_properties with a relevant keywords value. The response items array includes saleInfo and features fields that further describe each listing.Why does `numberOfPages` sometimes return 0?+
search_properties, get_agent_listings, and get_upcoming_auctions. To determine total pages, divide totalItems by pageSize and round up. The totalItems field is reliably populated.Does the API cover sold or historical listings?+
search_properties, get_agent_listings, and get_office_listings all reflect current inventory. You can fork this API on Parse and revise it to add an endpoint targeting Bayleys' sold properties pages.Can I retrieve listings filtered by a specific geographic region ID?+
search_people and search_offices both accept a region_id parameter for region-scoped results. The get_agent_profile response includes a searchContext object with region and property type reference data that can be used to identify valid region IDs. Direct region filtering on search_properties is not currently exposed as a named parameter; keywords can be used to target a location by name. You can fork this API on Parse and revise it to add a dedicated region filter parameter to the property search endpoint.