Yellow NZ Business Scraper

Scrapes business listings from Yellow.co.nz (New Zealand Yellow Pages). Extract comprehensive business information including contact details, emails, ratings, reviews, opening hours, and geo coordinates.

Features

Core Capabilities

• Comprehensive Data Extraction: Business names, phone, email, address, ratings, reviews, opening hours, geo coordinates, and more
• Flexible Search: Search by any keyword and location across New Zealand
• Pagination Support: Automatically handles pagination to fetch all results
• Detail Page Enrichment: Optional deep scraping via JSON-LD structured data for full business profiles
• Proxy Support: Optional proxy configuration for large-scale scraping

Perfect for Lead Generation

• Direct Contact Information: Extract phone numbers and email addresses for immediate outreach
• Location Intelligence: Full addresses with latitude/longitude coordinates for geo-targeting
• Business Verification: Year established, associations, and payment methods for lead qualification
• Customer Reviews: Star ratings, review counts, and full review text for quality assessment

AI-Ready Data Structure

• Structured JSON Output: Clean, consistent data format perfect for AI processing and analysis
• Rich Context: Business descriptions, services, slogan, and customer reviews for AI understanding
• Geo Data: Latitude/longitude coordinates for location-based analysis and mapping
• Training Data: Comprehensive business profiles ideal for training recommendation systems

Input Parameters

Parameter	Type	Description	Default
searchTerms	string	Business type or keyword (e.g., 'Plumbers', 'Restaurants')	Plumbers
location	string	Location (e.g., 'New Zealand', 'Auckland', 'Wellington')	New Zealand
maxPages	integer	Maximum search result pages to scrape (1-100)	5
scrapeDetails	boolean	Fetch detail pages for rich data (email, geo, hours, reviews)	true
maxConcurrency	integer	Concurrent detail page requests (1-20)	5
proxy	object	Optional proxy configuration	null

Send results into your apps (MCP connectors)

Optionally pipe the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. This is an extra delivery step after the scrape — the Apify dataset is never changed.

What gets written to the connector: a condensed, human-readable summary of each record — not the full JSON. Each item becomes one entry with a title and its key fields flattened to plain text. The complete record always stays in the Apify dataset.

1. Authorize a connector once under Apify → Settings → Integrations (Notion, Linear, Airtable, or Apify).
2. Select it in the "Pipe results into your apps" input field. (If the picker is empty, you haven't authorized a connector yet.)
3. For Notion, also set notionParentPageUrl to the page where items should be created.

The connection is mediated by Apify's MCP proxy, so this actor never sees your third-party credentials. Leave the field empty to skip.

Output Format

Search-Only Data

Each business record includes:

{
  "name": "Crawshaw Sample Ltd",
  "phone": "07 012 1234",
  "address": "Servicing: Waikato Region",
  "categories": ["Plumbers"],
  "rating": 5.0,
  "reviewCount": 2,
  "openStatus": "CLOSED NOW",
  "website": "https://example.co.nz",
  "description": "At Sample Plumbers we are experienced...",
  "detailUrl": "https://yellow.co.nz/hamilton/bpp/crawshaw-plumbers-ltd-12345678",
  "searchTerms": "Plumbers",
  "searchLocation": "New Zealand"
}

Enriched Data (when scrapeDetails: true)

Additional fields from detail pages:

{
  "email": "info@example.co.nz",
  "fullAddress": {
    "street": "10 Sample Street",
    "locality": "Lower Hutt",
    "region": "WGN",
    "postalCode": "5012",
    "country": "NZ"
  },
  "latitude": -41.232006,
  "longitude": 174.89116,
  "openingHours": ["Mo-Fr 07:00-17:00", "Sa 08:00-12:00"],
  "paymentAccepted": "visa, cash, mastercard",
  "imageUrl": "https://i3.ypcdn.com/blob/...",
  "logoUrl": "https://i1.ypcdn.com/blob/...",
  "reviews": [
    {
      "author": "John Smith",
      "rating": 5,
      "text": "Excellent service...",
      "date": "2024-03-15"
    }
  ],
  "yearEstablished": "1950",
  "slogan": "Your trusted local plumber",
  "associations": "Master Plumbers, Gasfitters & Drainlayers NZ",
  "generalInfo": "Full business description...",
  "servicesAndProducts": ["Plumbing", "Drainage", "Gasfitting"]
}