Yellow Pages Australia Business Scraper

Overview

This actor scrapes business listings from Yellow Pages Australia, returning structured data for lead generation, market research, and business intelligence. It handles pagination automatically and outputs clean JSON.

Key Features

• Extracts comprehensive business data: names, phone numbers, emails, websites, full addresses with GPS coordinates, and descriptions.
• Advanced search: filter by keyword, location, open now status, local businesses only, and popular listings.
• Smart result handling: detects available listings and prevents over-scraping if requests exceed available data.
• Additional business details: retrieves ratings, review counts, accreditations, operating hours, and category classifications.
• Flexible sorting: order results by relevance or distance from a specified location.
• Efficient operation: fetches pages concurrently with intelligent result limiting.
• Structured output: provides consistent JSON ready for CRM import or further processing.

How to Use

Configure the actor with input parameters. The scraper will navigate search results, extract data from each business profile, and return a dataset of JSON objects.

Input Parameters

• searchTerm: Business type or service (e.g., "plumber", "restaurant").
• location: City, suburb, or region in Australia.
• maxResults: Maximum number of results to extract (automatically adjusted to available data).
• sortBy: "relevance" or "distance".
• openNow: (Boolean) Filter for businesses currently open.
• localBusinesses: (Boolean) Include only mappable local businesses.
• popular: (Boolean) Show only popular/featured listings.

Example Input:

{
  "searchTerm": "accountant",
  "location": "Melbourne VIC",
  "maxResults": 500,
  "sortBy": "relevance",
  "openNow": false,
  "localBusinesses": true,
  "popular": false
}

Input/Output

Output Format

The actor outputs an array of items, where each item is a JSON object representing a business.

Example Output Item:

{
  "id": "123456",
  "name": "ABC Accounting Services",
  "phone": "02 9876 5432",
  "email": "info@abcaccounting.com.au",
  "website": "https://www.abcaccounting.com.au",
  "address": {
    "addressLine": "123 Collins Street",
    "suburb": "Melbourne",
    "state": "VIC",
    "postCode": "3000",
    "latitude": -37.8136,
    "longitude": 144.9631
  },
  "rating_score": 4.5,
  "rating_count": 28,
  "category_name": "Accountants",
  "category_id": "accounting-services",
  "opening_hours": {
    "monday": "9:00 AM - 5:00 PM",
    "tuesday": "9:00 AM - 5:00 PM",
    "friday": "9:00 AM - 4:00 PM"
  },
  "description": "Professional accounting services for small to medium businesses...",
  "accreditations": ["CPA Australia", "Certified Tax Agent"],
  "unique_selling_points": ["Free initial consultation", "Same day service"],
  "profile_link": "https://www.yellowpages.com.au/vic/melbourne/abc-accounting-123456",
  "pureMobileBusiness": false,
  "last_updated": "2024-01-15"
}

Notes & Limitations

• Geographic Scope: Limited to Australian businesses listed on Yellow Pages Australia.
• Search Dependency: Results depend on Yellow Pages' search algorithm and available listings.
• Maximum Results: Actual results may be fewer than requested if listings are limited.

Error Handling

• Failed requests are automatically retried with exponential backoff.
• The scraper uses graceful degradation; processing continues if individual pages fail.
• All input parameters are validated and sanitized with sensible defaults.

For issues or feature requests, please create an issue.