Yellow Pages NZ Scraper — Business Leads, Phone & Email

Scrape New Zealand business leads from yellow.co.nz — name, phone, email, website, category, full split address, coordinates, opening hours, rating, reviews and description. Search by keyword + city, or paste yellow.co.nz URLs. Email ships in every result at no extra cost. Export to JSON or CSV.

Why Use This Scraper?

• Email included in every result — yellow.co.nz exposes business emails on each profile page. The competitor charges $0.0275/email as a paid add-on; here it ships in the base result.
• Full split address — street, suburb, city, region (AUK/WGN/CAN…), postcode, country, plus lat/lng coordinates.
• Two speeds — fast listing mode (name, phone, category, website, rating) or full detail mode (email, hours, description, reviews, payment methods, images).
• Residential proxy resilience — yellow.co.nz sits behind Cloudflare; the actor runs Evomi residential first, with automatic IPCook and Apify RESIDENTIAL fallback so a single vendor outage never kills a run.
• Search by keyword × location — plumbers in Auckland, cafes in Wellington, accountants nationwide. Multi-query, multi-location, paginated.
• Direct profile URLs — paste one or more yellow.co.nz/{city}/bpp/{slug}-{id} links and get full details for each.

Overview

The actor scrapes yellow.co.nz, the New Zealand business directory operated by Yellow Pages Group. Each result is one business record. The search flow paginates /search?search_terms=…&geo_location_terms=… pages (30 businesses per page), collecting business profile URLs. In full-detail mode each profile page is opened and parsed from its schema.org LocalBusiness JSON-LD block, which carries the name, full postal address, geo coordinates, telephone, opening hours, image, aggregate rating, individual reviews, business website, and email.

The dataset is one row per business. No padding rows. Clients pay per result.

Supported Inputs

Search mode (recommended):

searchQueries: ["plumber", "electrician"]
locations: ["Auckland", "Wellington"]

Start URLs — paste yellow.co.nz links, one per line:

• Search URL: https://www.yellow.co.nz/search?search_terms=plumber&geo_location_terms=Auckland
• Business profile: https://www.yellow.co.nz/auckland/bpp/ak-speech-therapy-579486261

Unsupported: whitepages.co.nz (separate site, behind reCAPTCHA), the Yellow mobile app API, logged-in agent pages.

Use Cases

Audience	Use
B2B lead generation	Build NZ business lists by trade + city with phone and email
Email outreach	Recover verified business emails straight from each listing
Local SEO / mapping	Collect coordinates + full addresses for NZ business mapping
Market research	Category coverage by region, rating distribution, review counts
Sales pipelines	Enrich CRM records with website, category, hours, payment methods

How It Works

1. Resolve inputs — search queries × locations become search-page URLs; pasted start URLs are split into search URLs (expanded) and profile URLs (scraped directly).
2. Paginate search — each search page returns 30 business cards. The actor parses name, phone, category, website, address, rating and review count from the HTML, and pulls coordinates from the embedded map JSON.
3. Collect profile URLs — each card links to /{city}/bpp/{slug}-{ypid}; these are queued for detail fetch.
4. Fetch details (if fetchFullDetails is on) — each profile page is opened and its LocalBusiness JSON-LD is parsed for email, full split address, opening hours, description, reviews, payment methods and images.
5. Push rows — one dataset row per business, deduplicated by ypid.

Input Configuration

Field	Type	Default	Description
searchQueries	array	["plumber"]	Business types or keywords, one per line. Each runs across every location.
locations	array	["Auckland"]	NZ cities or regions, one per line. Leave empty for nationwide.
startUrls	array	[]	Paste yellow.co.nz search or profile URLs. Combines with the fields above.
fetchFullDetails	boolean	true	Open each profile page for email, hours, reviews, full address. Off = fast listing fields only.
maxItems	integer	1000	Max businesses across all searches.
maxPages	integer	0	Max search pages per query×location (30/page). 0 = unlimited.
maxConcurrency	integer	10	Pages fetched in parallel.
proxy	object	residential	Leave empty for the default residential proxy. yellow.co.nz is behind Cloudflare.

Example — plumbers in Auckland with full details:

{
  "searchQueries": ["plumber"],
  "locations": ["Auckland"],
  "maxItems": 50,
  "fetchFullDetails": true
}

Example — fast listing scan, no details (cheaper, no email):

{
  "searchQueries": ["cafe", "restaurant"],
  "locations": ["Wellington", "Christchurch"],
  "maxItems": 200,
  "fetchFullDetails": false
}

Example — direct profile URLs:

{
  "startUrls": [
    "https://www.yellow.co.nz/auckland/bpp/ak-speech-therapy-579486261",
    "https://www.yellow.co.nz/ashburton/bpp/goulds-towing-limited-579433096"
  ],
  "fetchFullDetails": true
}

Output Overview

Each dataset row is one NZ business. In full-detail mode the row carries 25+ fields; in listing mode it carries the 10 fast fields. The source field is "search" for listing rows and "detail" for profile-enriched rows.

Output Samples

Full-detail row (from a plumber search in Auckland):

{
  "ypid": "579352122",
  "name": "Brockelsby Plumbing & Gasfitting Limited",
  "slug": "brockelsby-plumbing-gasfitting-limited",
  "url": "https://www.yellow.co.nz/lower-hutt/bpp/brockelsby-plumbing-gasfitting-limited-579352122",
  "website": "https://brockelsby.co.nz",
  "phone": "04 569 7029",
  "email": "info@brockelsby.co.nz",
  "description": "We honor our heritage by providing exceptional plumbing and gasfitting services…",
  "categories": ["Metalwork - Architectural", "Drainage Contractors", "Engineers - Sheet Metal", "Gas Appliances", "Gas Lines-Installation & Repairing", "Plumbers"],
  "primaryCategory": "Metalwork - Architectural",
  "streetAddress": "10 Waione Street",
  "suburb": "Lower Hutt",
  "city": "Lower Hutt",
  "region": "WGN",
  "postcode": "5012",
  "country": "NZ",
  "latitude": -41.232006,
  "longitude": 174.89116,
  "rating": 5,
  "reviewCount": 1,
  "openingHours": ["Mo-Su 00:00-23:59"],
  "image": "https://i1.ypcdn.com/blob/f9f4c3815ddcb837acae6b3408a145f2201998ea",
  "paymentAccepted": "invoicing available, cash, mastercard, visa",
  "reviews": [
    { "author": "Yellow Mobile User", "datePublished": "2021-13-05", "ratingValue": 5, "reviewBody": "I experienced Brockelsby's service last month…" }
  ],
  "isAd": false,
  "source": "detail",
  "scrapedAt": "2026-10-20T11:21:17.120Z"
}

Listing row (fast mode, no details):

{
  "ypid": "579504888",
  "name": "Mojo Central",
  "phone": "044729272",
  "primaryCategory": "Cafes",
  "website": "https://mojo.coffee/",
  "city": "wellington",
  "rating": 4.5,
  "reviewCount": 9,
  "url": "https://www.yellow.co.nz/wellington/bpp/mojo-central-579504888",
  "source": "search"
}

Key Output Fields

Identity: ypid, name, slug, url (profile URL), website (business's own site)

Contact: phone, email (from the profile page, mailto: stripped)

Classification: categories[], primaryCategory

Address: streetAddress, suburb, city, region (NZ region code), postcode, country

Location: latitude, longitude

Reputation: rating, reviewCount, reviews[] (author, date, rating, body)

Operations: openingHours[], paymentAccepted, image

Meta: isAd, source (search | detail), scrapedAt

FAQ

Is email really included for free? Yes. yellow.co.nz exposes business emails in the profile page's JSON-LD. In full-detail mode every result that has an email on its profile page returns it in the email field. No add-on, no extra charge.

Why do I need a residential proxy? yellow.co.nz is behind Cloudflare's managed challenge. Datacenter IPs get HTTP 403. The actor's residential fallback chain (Evomi → IPCook → Apify RESIDENTIAL) handles this automatically.

What's the difference between the two modes? fetchFullDetails: true opens each profile page — slower but returns email, full split address, hours, reviews, description, payment methods. false parses only the search-page cards — fast and cheap, returns name, phone, category, website, rating, review count, city, coordinates.

How many businesses per search page? 30. The actor paginates automatically up to maxPages (0 = unlimited) or until maxItems is reached.

Does it scrape whitepages.co.nz? No. White Pages is a separate site behind Google reCAPTCHA. This actor covers yellow.co.nz only.

Can I scrape a single business? Yes — paste its profile URL into startUrls with fetchFullDetails: true.

Support

• Issues: Apify Console → Issues
• Author: memo23

Additional Services

Need a custom export format, a specific filter (e.g. only businesses with email, only rating ≥ 4), or integration with your CRM? Reach out via the Issues tab or Apify — custom work is available.

Explore More Scrapers

See the full memo23 actor portfolio for other directory, real estate, and lead-generation scrapers.

⚠️ Disclaimer

This actor is not affiliated with, endorsed by, or sponsored by Yellow Pages Group or yellow.co.nz. "Yellow Pages" is a trademark of its respective owner. The actor scrapes publicly accessible business directory pages only, in accordance with the site's terms of service. It does not access logged-in or paywalled content. Users are responsible for complying with all applicable laws and regulations, including the GDPR, CCPA, and New Zealand privacy law, when using data scraped from this site. Do not use this actor to send unsolicited commercial electronic messages in breach of the New Zealand Unsolicited Electronic Messages Act 2007.

SEO Keywords

yellow pages nz scraper, yellow.co.nz scraper, new zealand business directory, nz business leads, nz b2b leads, yellow pages nz email, nz business phone numbers, auckland business directory, wellington business directory, christchurch business directory, nz plumber leads, nz electrician leads, nz business contact list, nz company directory scraper, yellow pages nz api, nz business address data, nz business coordinates, nz business reviews, nz opening hours data, nz lead generation scraper, nz business email finder, scrape yellow pages new zealand