Yellow Pages Australia Scraper

This actor scrapes business listings from Yellow Pages Australia based on search criteria like business type and location. It extracts comprehensive business data including contact details, address, operating hours, ratings, and more.

Features

• Search for businesses by type (e.g., "electrician", "plumber", "restaurant")
• Filter by location (e.g., "Melbourne, VIC", "Sydney, NSW")
• Search by keyword + location, or paste Yellow Pages URLs directly
• Set result limits and automatic forward pagination
• Optional detail enrichment: reviews, aggregate rating, and detail images per business
• Comprehensive proxy support (Apify Proxy or custom proxies)
• Data extraction from DOM and JSON-LD structured data
• Deduplication of sponsored/organic listings

Proxy Support

An Australian residential proxy is required for reliable results; datacenter and bare default-group IPs are frequently blocked by the site. With Apify Residential the exit IP rotates across AU/NZ automatically until a clean one connects.

Using Apify Proxy

{
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "AU"
  }
}

Using Custom Proxies

Alternatively, you can provide your own proxy URLs:

{
  "proxy": {
    "useApifyProxy": false,
    "proxyUrls": [
      "http://username:password@proxy1.example.com:8080",
      "http://username:password@proxy2.example.com:8080"
    ]
  }
}

Usage

Input Parameters

Parameter	Type	Description
mode	String	keyword (search by business type + location) or url (use pasted URLs). Auto-detected when omitted.
businessType	String	Keyword mode: type of business to search for (e.g., "electrician", "plumber").
location	String	Keyword mode: location to search in (e.g., "Melbourne, VIC", "Sydney, NSW").
urls	Array	URL mode: one or more Yellow Pages search URLs. Pagination auto-advances forward from each URL; if a URL has ?page=N, scraping continues from N.
limit	Integer	Maximum number of business listings to scrape (default: 20).
pageNumber	Integer	Keyword mode: page to start scraping from (default: 1).
fetchDetails	Boolean	Visit each business's detail page to extract reviews, aggregate rating, and detail images. Slower and billed per enriched listing (default: false).
proxy	Object	Proxy configuration (see "Proxy Support" section).

Output Format

The actor stores results in the default dataset, one item per business:

{
  "listingId": "00000001",
  "name": "Sample Business Pty Ltd",
  "address": "1 Example Street, Melbourne, VIC 3000",
  "phone": "(00) 0000 0000",
  "email": "contact@example.com",
  "website": "https://www.example.com",
  "scrapedFromPage": 1,

  "primaryCategoryName": "Electrical Contractors",
  "categoryText": "Electrical Contractors, Electric Contractors-Commercial & Industrial",

  "detailsPageUrl": "https://www.yellowpages.com.au/melbourne-vic/bpp/sample-business-00000001",
  "logoUrl": "https://i2.ypcdn.com/ypau/images/default-thumbnail.jpg",

  "openingHoursToday": "OPEN until 5:30 pm",
  "openingHoursDetails": {
    "Mon - Fri": "8:00 am - 6:00 pm",
    "Sat": "9:00 am - 4:00 pm"
  },
  "openingHoursStructured": ["Mo-Fr 08:00-18:00", "Sa 09:00-16:00"],

  "rating": "4.5",
  "reviewCount": 12,

  "longDescription": "Sample business description text...",
  "slogan": "Sample slogan",
  "isAd": false,
  "hasPhotos": true,
  "features": "website,reviews,phone,open-now",
  "yearsInBusiness": "10 Years",
  "yearsWithYellowPages": "5 Years",
  "servingArea": "Serving Melbourne, VIC",
  "listingType": "free",

  "addressDetails": {
    "streetAddress": "1 Example Street",
    "locality": "Melbourne",
    "region": "VIC",
    "postalCode": "3000",
    "country": "AU"
  },
  "latitude": -37.000000,
  "longitude": 144.000000
}

Enrichment fields (only when fetchDetails is enabled)

When fetchDetails: true, each record is additionally populated from the business's detail page:

{
  "enriched": true,
  "reviewsCount": 2,
  "aggregateRating": 4.5,
  "aggregateReviewCount": 2,
  "reviews": [
    {
      "author": "Sample Reviewer",
      "rating": 5,
      "title": "Great service",
      "text": "Sample review text...",
      "date": "2026-01-01"
    }
  ],
  "detailImages": ["https://i2.ypcdn.com/ypau/images/00000001.jpg"]
}

Field notes

• slogan: Business tagline displayed on the listing.
• isAd: Whether the listing is a sponsored/paid advertisement.
• hasPhotos: Whether the listing has uploaded gallery photos (vs default thumbnail).
• features: Comma-separated listing capabilities from analytics (e.g., "website,reviews,phone,open-now,preferred").
• yearsInBusiness / yearsWithYellowPages: How long the business has operated / been listed.
• addressDetails: Structured address from JSON-LD data, available for listings with addresses.
• latitude / longitude: Search location center point from JSON-LD Place data.
• openingHoursStructured: ISO format opening hours from JSON-LD (e.g., "Mo-Fr 08:00-18:00").
• listingType: From analytics data (e.g., "free", "sub").
• reviews / aggregateRating / reviewsCount / aggregateReviewCount / detailImages: Populated only when fetchDetails is enabled. reviews is an empty array for businesses with no reviews.
• enriched: true when the detail page was successfully fetched for this record.
• email, address, addressDetails, latitude, longitude: contact + location fields. Many are only available on the business's detail page, so they are most complete when fetchDetails is enabled (the detail page backfills any values the search results omit). Businesses that don't publish a value (e.g. nationwide mobile services with no fixed address) leave the field empty.