New Zealand Business Directory Leads Scraper (Phone & Address)

Here is one real result, with every field the actor returns:

{
  "name": "Peninsula Plumbers",
  "phone": "027 414 4741",
  "email": "peninsulaplumbers@xtra.co.nz",
  "website": null,
  "category": "Plumbers",
  "street": "4 Arnott Street",
  "suburb": null,
  "city": "Harwood",
  "region": "OTA",
  "postalCode": "9014",
  "country": "NZ",
  "addressText": "Harwood 9014",
  "description": "The certified Plumbers and Drainlayers at **Peninsula Plumbers** service the whole of the Dunedin area. We can take care of your requirements, be it: * General Maintenance *…",
  "rating": 5,
  "reviewCount": 2,
  "latitude": -45.8169,
  "longitude": 170.67,
  "openingHours": "Mo-Fr 08:00-17:00",
  "imageUrl": "https://i2.ypcdn.com/blob/eab530fc00e178da62dd113dd9f29ecff5e23774_130x130_crop.jpg?bbc5b574a4",
  "listingUrl": "https://www.yellow.co.nz/harwood/bpp/peninsula-plumbers-579352030?lid=1002194370973",
  "searchQuery": "plumber",
  "searchLocation": "Auckland",
  "source": "yellow.co.nz",
  "observedAt": "2026-08-10T14:32:34.260Z",
  "error": null,
  "businessId": "579352030"
}

The most complete New Zealand business directory scraper available. It returns every field the listing exposes for each business, plus a full split address (street, suburb, city, region, postcode), coordinates, opening hours, and an optional paid contact-email add-on, and gives you multi-keyword and multi-location filters to target exactly the leads you need.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor searches the New Zealand business directory (yellow.co.nz) for every keyword across every location you provide, paginates through the matching listings, and writes one normalized record per business to the run's dataset. With fetchDetails on (the default), each business profile is opened to add its email and full split address (street, suburb, city, region, postcode). Missing values are returned as null so you never get invented data.

You can also paste ready-made yellow.co.nz search or business-profile links straight into startUrls instead of the structured fields. An optional paid add-on (enrichEmails) recovers a real business email for each result from its detail page and website, and a separate add-on (enrichContacts) finds a public contact email and person. Both are off by default and billed only when an email is found (see Billing and limits).

Quickstart

Open the actor, paste this into the input, and press Run. It returns 10 plumber leads searched from Auckland.

{
  "maxBusinesses": 10,
  "fetchDetails": true,
  "searchQueries": ["plumber"],
  "locations": ["Auckland"],
  "enrichContacts": false,
  "enrichContactsMax": 50
}

Add more keywords and locations to searchQueries and locations (each keyword runs across each location). Leave locations empty to search nationwide.

Input reference

Field	Type	Required	Default	Description
startUrls	string[]	no	–	Paste ready-made directory search or business-profile URLs, one per line, for example https://yellow.co.nz/search?search_terms=car+dealers&geo_location_terms=New+Zealand. A search URL returns the same results as the structured searchQueries + locations fields; a business-profile URL is scraped directly. Combines with the structured fields.
searchQueries	string[]	no*	["plumber"]	Business types or keywords to search, one per line, for example plumber, cafe, accountant, electrician. Each query runs across every location. *Required unless you supply startUrls.
locations	string[]	no	["Auckland"]	New Zealand cities or regions to search, one per line, for example Auckland, Wellington, Christchurch. Leave empty to search nationwide.
maxBusinesses	integer	no	10	Maximum number of businesses to collect across all searches. Free Apify plans are capped at 10 per run.
fetchDetails	boolean	no	true	When on, each profile is opened to add email and the full split address. When off, only the fast listing-level fields (name, phone, category, website, area) are returned.
enrichEmails	boolean	no	false	Optional paid add-on, paying accounts only. Recovers a real business email for each result — from the listing's detail page and, when the business has a website, from its homepage and contact/about pages. Adds email, allEmails and emailSource. Billed only when a real email is actually found for a result (no email found = no charge).
enrichContacts	boolean	no	false	Optional paid add-on. For each result without an email, attempt to find a public business contact email and a contact person's name. Billed per attempt, plus an extra charge only when an email is found.
enrichContactsMax	integer	no	50	Cap how many results the add-on tries to enrich, to control add-on cost. Free Apify accounts are capped at 3.

Output reference

One dataset item per business. Types: string, number, or null when the source value is absent.

Field	Type	Description
name	string	Business name.
phone	string	Contact phone number, or null.
email	string	Best business email found, or null. Populated by the enrichEmails add-on (from the detail page or the business website).
allEmails	string[]	All valid business emails found for this record, or null. Populated by the enrichEmails add-on.
emailSource	string	Where the email came from — the listing detail page or the business website URL — or null.
website	string	Business website URL, or null.
category	string	Primary business category.
street	string	Street address (from the profile), or null.
suburb	string	Suburb, or null.
city	string	City or locality, or null.
region	string	Region code, for example OTA, TAS.
postalCode	string	Postal code, or null.
country	string	Country code, for example NZ.
addressText	string	Address or service area as shown on the listing card.
description	string	Business description, or null.
rating	number	Average star rating, or null when unrated.
reviewCount	number	Number of reviews, or null.
latitude	number	Latitude, or null.
longitude	number	Longitude, or null.
openingHours	string	Opening hours string, or null.
imageUrl	string	Business image URL, or null.
listingUrl	string	Business profile URL on the directory.
businessId	string	Directory listing identifier.
searchQuery	string	The query that produced this record.
searchLocation	string	The location that produced this record, or null for nationwide.
source	string	Data source, always yellow.co.nz.
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	null on success. On a failed run, a single item with a populated error field is written instead.

Example output record

Real record from a live run (input {"searchQueries": ["plumber"], "locations": ["Auckland"], "maxBusinesses": 10}):

{
  "name": "My Personal Plumber",
  "phone": "0800 444 343",
  "email": "alex@mypersonalplumber.co.nz",
  "website": "http://www.mypersonalplumber.co.nz",
  "category": "Plumbers",
  "street": "1366 Moutere Highway",
  "suburb": null,
  "city": "Upper Moutere",
  "region": "TAS",
  "postalCode": "7173",
  "country": "NZ",
  "addressText": "Upper Moutere 7173",
  "description": "My Personal Plumber - Certifying plumber, gasfitter and drainlayer! With over 20 years of experience, we provide a friendly personal approach for all of your needs. Our aim is…",
  "rating": 5,
  "reviewCount": 1,
  "latitude": -41.27106,
  "longitude": 173.00633,
  "openingHours": null,
  "imageUrl": "https://i2.ypcdn.com/blob/ff402a32618fbc22f750156e39005e365b960d80_130x130_crop.jpg?bbc5b574a4",
  "listingUrl": "https://www.yellow.co.nz/upper-moutere/bpp/my-personal-plumber-579351729?lid=1002194373087",
  "searchQuery": "plumber",
  "searchLocation": "Auckland",
  "source": "yellow.co.nz",
  "observedAt": "2026-08-10T14:32:34.261Z",
  "error": null,
  "businessId": "579351729"
}

The description above is truncated at the source with an ellipsis; the value is returned exactly as published, not shortened by the actor.

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~yellowpages-nz-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchQueries":["plumber"],"locations":["Auckland"],"maxBusinesses":25}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~yellowpages-nz-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchQueries":["cafe","accountant"],"locations":["Wellington","Christchurch"],"maxBusinesses":100}'

Apify CLI:

apify call scrapers_lat/yellowpages-nz-scraper \
  --input '{"searchQueries":["electrician"],"locations":["Auckland"]}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per business record returned (result event). See the pricing tab for the current per-result price.
• Detail enrichment event. When fetchDetails is on and a profile page is successfully read (adding email and full address), a details event is charged for that record.
• Email enrichment add-on (enrichEmails). Optional, off by default, paying accounts only. When on, an email event is charged only for a result where a real, valid business email is actually found (from the listing's detail page or the business website). Results with no email found are never charged for email. Paste a search or business-profile link in startUrls and turn this on to build an email list.
• Contact enrichment add-on is billed separately: per attempt when enrichContacts is on, plus an extra charge only when an email is found.
• No charge on failure. If a run errors, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 records per run (and 3 enrichment attempts). Upgrade for higher maxBusinesses.

FAQ and troubleshooting

A run returned only an error item. Why? At least one search query is required. If searchQueries is empty the actor writes a single item with a populated error field and does not charge. Provide a keyword and re-run.

Why is email sometimes null? Emails come from the business profile page, so they are only populated when fetchDetails is on and the profile publishes one. Enable the enrichContacts add-on to search for a contact email when the profile has none.

What is the difference between fetchDetails on and off? Off returns fast listing-level fields only (name, phone, category, website, service area). On opens each profile to add email and the full split address (street, suburb, city, region, postcode), coordinates, and opening hours.

How do I search the whole country? Leave locations empty. Each query then runs as a nationwide search.

Is this an official Yellow tool? No. This actor is independent and has no affiliation with the New Zealand business directory. It reads only data that is publicly available on the site.

Related scrapers

• Yellow Pages Canada Business Leads Scraper: Canadian business leads with parsed addresses.
• 11880 Germany Business Scraper: German business listings and contacts.
• ACCA Accountants Scraper: ACCA-registered accountancy firm leads.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with the New Zealand business directory. Accesses only publicly available business listing data.