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

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"]
}