# Yellow Pages Australia Scraper - Emails & Leads (`confidential_gnat/yellowpages-australia-scraper`) Actor

Scrape Australian businesses from Yellow Pages Australia (yellowpages.com.au) with emails: name, phone, address, website, rating, ABN and the business email when listed, plus employee emails from each website. Search by keyword and city or paste a URL. Export JSON, CSV or Excel.

- **URL**: https://apify.com/confidential_gnat/yellowpages-australia-scraper.md
- **Developed by:** [ActorFlow](https://apify.com/confidential_gnat) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.50 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Yellow Pages Australia Scraper - Emails & Leads

![Yellow Pages Australia Scraper - Emails & Leads cover](https://i.postimg.cc/5NJ19GWB/Gemini-Generated-Image-d8qfrhd8qfrhd8qf.jpg)

**Scrape businesses from Yellow Pages Australia (yellowpages.com.au)**: name, phone, address, categories, website, rating, years in business, hours, ABN, email and social links. Export to JSON, CSV or Excel, or call it as an **API**. Paste a **Yellow Pages Australia search URL**, or give search terms and locations, and press Start. **Emails too:** business emails where the page lists one, plus employee emails found on each business website.

**Target website:** [Yellow Pages Australia (yellowpages.com.au)](https://www.yellowpages.com.au)

### ✨ Features of this Yellow Pages Australia business scraper

- **Email extraction** — business emails where the page lists one, plus employee emails found on each business website.
- **Business listing extraction** — name, phone, full address, categories, website, rating, years in business and a short description from any Yellow Pages Australia search or category page.
- **Pagination support** — walks the result pages of each search until it has the number of businesses you asked for.
- **Search terms and locations** — give any number of terms and locations; every term is searched in every location.
- **Business page details** — optional: opens each business page for the full description, coordinates, opening hours, email, ABN, ACN, staff size, payment methods and social links.
- **Employee contacts (leads)** — optional: finds employee names, roles, emails and LinkedIn links from each business's website.
- **Cache, new and changed businesses only** — use one cache name across scheduled runs and skip businesses you already have.
- **No proxy needed** — pages are loaded by the Actor's built-in service, so you leave proxies off.

### 🚀 How to scrape Yellow Pages Australia businesses in 5 steps

1. [Sign up](https://apify.com/sign-up) for a free Apify account — includes **$5 monthly credit**.
2. Open the actor page and click **Try for free**.
3. Paste Yellow Pages Australia search URLs, or fill in **Search terms** and **Locations**.
4. Click **Start** and wait for the run to complete.
5. Download results from the **Output** tab in JSON, CSV, or Excel format.

You can also run this actor via the [Apify API](https://docs.apify.com/api/v2) or integrate it directly into your workflows using [Zapier](https://zapier.com/apps/apify), [Make](https://www.make.com/), or [n8n](https://n8n.io/).

### 💰 Pricing for the Yellow Pages Australia scraper

This actor uses **pay-per-result** billing based on the compute units a run consumes.

- New Apify accounts include **$5 of free monthly credit**.
- It reads the data straight from the directory's pages instead of driving a browser, so it costs significantly less to run than browser-based scrapers.
- **Business pages** (the *Scrape business pages* option) are charged separately, per business whose page is opened, on top of the result price. Runs with business pages off pay only the standard result price.
- **Employee contacts** are charged separately, and only when the lookup successfully returns a list of contacts: every business you are charged for comes with at least one contact. The charge is once per business, not per contact. Businesses with no website, or where no contacts are found, are not charged for it.
- Businesses skipped by the cache are not charged.

### 🖼️ Yellow Pages Australia scraper input screenshot

![Yellow Pages Australia Scraper - Emails & Leads input form in Apify Console: search or business URLs, max items per search, cache project name, find employee contacts, scrape business pages, search terms, locations and proxy configuration](https://i.postimg.cc/sDTPfkGK/image.png)

Numbered labels in the screenshot:

1. **Search or business URLs** — the search result pages or business pages to scrape.
2. **Max items per search** — how many businesses to save for each search.
3. **Cache project name** — reuse the same name on scheduled runs to get only new and changed businesses.
4. **Find employee contacts (leads)** — look up each business website for employee contacts (charged separately, only when contacts are found).
5. **Scrape business pages** — open every business page for extra details (charged separately per business page).

Search terms and Locations (in the collapsible optional section) and the proxy settings sit below these fields.

### 🔧 Yellow Pages Australia scraper input configuration

| Field | Type | Required | Default | Description |
| ----- | ---- | -------- | ------- | ----------- |
| Search or business URLs (`startUrls`) | array | — | example search (prefill) | Yellow Pages Australia search result pages, category pages or single business pages, for example https://www.yellowpages.com.au/search?search_terms=plumber\&geo_location_terms=Sydney%2C+NSW or https://www.yellowpages.com.au/sydney-nsw/plumbers. Leave empty to use the search terms and locations below. |
| Max items per search (`maxItems`) | integer | — | 5 | Maximum businesses saved for each search. A search shows a limited number of result pages; for more, use narrower searches (more search terms or locations). |
| Cache project name (`cacheProjectName`) | string | — | — | Same name on each run = only new and changed businesses. |
| Find employee contacts (`enrichLeads`) | boolean | — | false | Looks up each business's website for employee contacts and adds them as a `leads` array. Needs the business to have a website. Charged only when the lookup successfully returns a list of contacts (at least one per charged business): once per business, not per contact; nothing when none are found. |
| Scrape business pages (`scrapeDetails`) | boolean | — | false | Open every business page for the full description, coordinates, opening hours, email, ABN, ACN, staff size, payment methods and social links. Slower; off by default. Adds a separate charge per business page opened, on top of the normal result price. |
| Search terms (`searchTerms`) | array | — | — | What to search for, for example plumber, dentist or cafe. Each term is searched in every location. |
| Locations (`locations`) | array | — | — | Where to search, for example Sydney, NSW or Melbourne, VIC. Each location is searched for every search term. |
| Proxy configuration (`proxyConfiguration`) | object | — | no proxy | Not needed: pages are loaded by the Actor's built-in service. |

**Supported URL types:**

- Search: `https://www.yellowpages.com.au/search?search_terms=plumber&geo_location_terms=Sydney%2C+NSW`
- Category page: `https://www.yellowpages.com.au/sydney-nsw/plumbers`
- Business page: `https://www.yellowpages.com.au/castle-hill-nsw/bpp/goldman-plumbing-services-580347136`

### 📦 Yellow Pages Australia scraper output data

The output is a dataset of business records with the fields `businessId`, `name`, `url`, `phone`, `address`, `street`, `city`, `region`, `postalCode`, `categories`, `website`, `rating`, `ratingCount`, `yearsInBusiness`, `snippet`, `imageUrl`, `description`, `latitude`, `longitude`, `foundingYear`, `abn`, `acn`, `staff`, `ownership`, `hours`, `email`, `socialLinks`, `associations`, `paymentMethods`, `leads`, `changeType`, `searchUrl`, `scrapedAt`. The dataset has 2 views:

- **Overview** — name, phone, address, categories, website, rating and years in business.
- **Contacts** — name, phone, email, website and city of each business.

**Output at a glance:**

| Business | Phone | Address | Categories | Website | Rating | Years |
| --- | --- | --- | --- | --- | --- | --- |
| [Goldman Plumbing Services](https://www.yellowpages.com.au/castle-hill-nsw/bpp/goldman-plumbing-services-580347136?lid=1002195543327) | (02) 7908 4316 | 10 Anella Avenue, Castle Hill, NSW 2154 | Plumbers & Gasfitters, Drainage Contractors | https://goldmanplumbing.com.au/ | — | 62 |
| [Aussie Plumbing Services - Sydney](https://www.yellowpages.com.au/nationwide/bpp/aussie-plumbing-services-sydney-580270773?lid=1002195239608) | (02) 9191 0865 | Serving Sydney, NSW | Plumbers & Gasfitters, Drainage Contractors | https://www.aussieelectricalandplumbing. | 4.5 | 17 |

**Sample output (raw JSON):**

```json
[
  {
    "businessId": "580347136",
    "name": "Goldman Plumbing Services",
    "url": "https://www.yellowpages.com.au/castle-hill-nsw/bpp/goldman-plumbing-services-580347136?lid=1002195543327",
    "phone": "(02) 7908 4316",
    "address": "10 Anella Avenue, Castle Hill, NSW 2154",
    "street": "10 Anella Avenue",
    "city": "Castle Hill",
    "region": "NSW",
    "postalCode": "2154",
    "categories": [
      "Plumbers & Gasfitters",
      "Drainage Contractors"
    ],
    "website": "https://goldmanplumbing.com.au/",
    "rating": null,
    "ratingCount": null,
    "yearsInBusiness": 62,
    "snippet": "Servicing Sydney for over 50 years",
    "imageUrl": "https://i4.ypcdn.com/blob/df4e1211eb60f005a4915c2ba40a0d259f8d0080_180x50_max.jpg?81819a50f",
    "searchUrl": "https://www.yellowpages.com.au/search?search_terms=plumber&geo_location_terms=Sydney%2C+NSW",
    "description": "Our phones are answered 24 hours 7 days a week by our management team to attend to our clients' requirements.Servicing Sydney for over 50 yearsAt Goldman Plumbing Services our philosophy is simple, old fashioned reliable service with a smile and that's why our customers return again and again. We offer a wide range of products and services whether it's a bathroom renovation or a plumbing emergency one of our qualified plumbing technicians is there to help you.With over forty years in the game, our industry experience speaks for itself. Our skilled management team are experts in their field so you can rely on them and our reputation to give you fast, dependable and fair service that you can trust.We currently employ twenty five staff, including a management team of five which includes three in-field supervisors. All of our employees have been trained and certified in all appropriate aspects of OH&S as well as successfully completing the St Johns Senior First Aid Certificate.",
    "latitude": -33.7249,
    "longitude": 150.9804,
    "foundingYear": 1964,
    "abn": "56051254301",
    "acn": "051254301",
    "staff": "21-50",
    "ownership": "Locally Owned",
    "hours": "Mon - Sun: 12:00 am - 11:59 pm",
    "email": "lauren@goldman.com.au",
    "paymentMethods": [
      "mastercard",
      "visa"
    ],
    "leads": [],
    "changeType": null,
    "scrapedAt": "2026-10-22T11:22:34.820Z"
  },
  {
    "businessId": "580270773",
    "name": "Aussie Plumbing Services - Sydney",
    "url": "https://www.yellowpages.com.au/nationwide/bpp/aussie-plumbing-services-sydney-580270773?lid=1002195239608",
    "phone": "(02) 9191 0865",
    "address": "Serving Sydney, NSW",
    "street": null,
    "city": null,
    "region": null,
    "postalCode": null,
    "categories": [
      "Plumbers & Gasfitters",
      "Drainage Contractors"
    ],
    "website": "https://www.aussieelectricalandplumbing.com.au/",
    "rating": 4.5,
    "ratingCount": 15,
    "yearsInBusiness": 17,
    "snippet": "Our experts at Aussie Plumbing Services can handle any plumbing service that you may need. We have the skills, knowledge, experience and appropriate tools to…",
    "imageUrl": "https://i4.ypcdn.com/blob/98297f6dcde5b2cfcb0c348d5895e146781655cd_180x50_max.jpg?81819a50f",
    "searchUrl": "https://www.yellowpages.com.au/search?search_terms=plumber&geo_location_terms=Sydney%2C+NSW",
    "description": "We strive to provide our customers with a first class experience, unlike any other they have received from a trades-person!Our experts at Aussie Plumbing Services can handle any plumbing service that you may need. We have the skills, knowledge, experience and appropriate tools to handle your job professionally. Our team of experts can handle any domestic plumbing service or commercial plumbing service and leave you absolutely satisfied with a first-class service.No matter if it's a blocked drain, broken toilet or hot water system - we will address your emergency plumbing issues with a lifetime service guarantee. Whatever the size of your problem, we'll find the source and fix it safely and effectively.$0 call out fee Book a same day emergency plumbing service Free emergency plumbing and CCTV inspection - State of the art equipment for the toughest plumbing situations $50 Cashback for all new customers Our plumbers are fully licensed & insured No hidden fees Pensioner discounts available We'll always contact you before arrival Call us on 02 9191 0865 and solve your plumbing issues with the help of an experienced plumber in Sydney! Making sure your plumbing is running without any problems is essential to your day to day livelihood.Without proper plumbing, you’re unable to shower, heat or cool your home and in some cases, poor plumbing may severely damage your home.That’s why we here at AEP we have fully licensed,experienced and insured plumbers to make sure your plumbing issues are taken care of with utmost comfort.From repairing your toilet to renovating your bathroom,we’ve got you covered.If you need a plumber to repair, maintain or respond to a plumbing emergency in your home or business - give us a call today!If you need a plumber to repair, maintain or respond to a plumbing emergency in your home or business- give us a call today on 02 9191 0865! Here’s A List Of Our Plumbing Services: 24/7 Emergency Plumbing - Emergency plumbing issues can get very ugly quickly. The worse the build-up, the more struggle and clean up you’ll have. Click here right now or call 02 9191 0865 if you suspect you have an emergency plumbing situation. Toilet Repairs - There are very few things more uncomfortable than a broken toilet. If your toilet is not working as it used to, click here or call 02 9191 0865 and we’ll repair it. Blocked Drain Repairs - Are any of your basins, sinks or plumbing fixtures draining very slowly or not at all? Click here or call 02 91910865 and get in touch an expert plumber today to take a look. Leaking Tap Repairs - Is your leaking tap driving you insane? Click here or call 02 9191 0865 to get in touch with an expert plumber who will fix it right away. Hot Water Repairs - There are very few things less infuriating than running out of hot water in the morning. Click here or call 02 91910865 to get in touch with a plumber so you can enjoy having your hot water back Bathroom Renovations - Need your bathroom renovated but can’t find an affordable option who understands what you need? Click here or call 02 9191 0865 to get started.",
    "foundingYear": 2009,
    "abn": "69600483850",
    "acn": "600483850",
    "staff": "11-20",
    "hours": "Mon - Sun: Open 24 Hours; 01/01/2026 Closed; 26/01/2026 Closed; 03/04/2026 Closed; 05/04/2026 Closed; 06/04/2026 Closed; 25/04/2026 Closed; 25/12/2026 Closed; 26/12/2026 Closed; 28/12/2026 Closed",
    "email": "info@aussieservicesnsw.com.au",
    "paymentMethods": [
      "mastercard",
      "visa"
    ],
    "leads": [],
    "changeType": null,
    "scrapedAt": "2026-10-22T11:22:37.129Z"
  }
]
```

### 📧 How to find Yellow Pages Australia business emails and employee contacts (email enrichment)

Switch on **Find employee contacts** and the actor looks up each business's website and adds a `leads` array with employee names, roles, departments, emails, phone numbers and LinkedIn links when they can be found. The `leads` field is always present on every record: it is an empty array when the business has no website or nothing was found. The contacts charge is applied only when the lookup successfully returns a list of contacts, so every charged business has at least one lead. It is charged once per business, not per contact, and never when `leads` is empty. The lookup runs once per business website.

| name | email | position |
| ---- | ----- | -------- |
| Jane Example | jane@example.com | Owner |
| John Sample | john@example.com | Office manager |

### 🔁 Scrape only new Yellow Pages Australia businesses with the cache

Set the same **Cache project name** on every scheduled run. Businesses already saved under that name and unchanged are skipped: they are not charged and do not count towards **Max items per search**. New businesses get `changeType: "new"` and businesses whose phone, address, website or rating changed get `changeType: "updated"`. Each name keeps its own separate cache. Add the actor to an Apify Schedule to track new businesses in a category and area automatically.

### 🐍 How to scrape Yellow Pages Australia with Python, JavaScript or the API

Run the actor programmatically with the official Apify clients. Replace `<YOUR_API_TOKEN>` with the token from your [Apify Console](https://console.apify.com/account/integrations).

**Python** (`pip install apify-client`):

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")

run = client.actor("confidential_gnat/yellowpages-australia-scraper").call(run_input={
        "searchTerms": [
            "plumber"
        ],
        "locations": [
            "Sydney, NSW"
        ],
        "maxItems": 20,
        "scrapeDetails": False,
        "enrichLeads": True
    })

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

**JavaScript** (`npm install apify-client`):

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_API_TOKEN>' });

const run = await client.actor('confidential_gnat/yellowpages-australia-scraper').call({
        "searchTerms": [
            "plumber"
        ],
        "locations": [
            "Sydney, NSW"
        ],
        "maxItems": 20,
        "scrapeDetails": false,
        "enrichLeads": true
    });

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

**cURL** — start a run and wait for the dataset:

```bash
curl -X POST "https://api.apify.com/v2/acts/confidential_gnat~yellowpages-australia-scraper/run-sync-get-dataset-items?token=<YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms": ["plumber"], "locations": ["Sydney, NSW"], "maxItems": 20, "scrapeDetails": false, "enrichLeads": true}'
```

### 💡 What you can use Yellow Pages Australia business data for

- Lead generation: phone numbers, websites and emails of local businesses by category and area
- Sales prospecting with employee names, roles and emails from each company website
- Local market research and competitor mapping by category, city and rating
- Building and enriching CRM and mailing lists
- Monitoring new businesses and changes in a category with scheduled cached runs

Sales teams, marketing agencies, recruiters and market researchers typically use this data across services, trades, retail and hospitality.

### ⚠️ Limitations of the Yellow Pages Australia scraper

- **Result depth** — one search shows a limited number of result pages; for more businesses use more search terms and locations.
- **Service-area businesses** — some businesses list the area they serve instead of a street address, so street, city and postcode can be empty.
- **Reviews and ratings** — ratings and counts are only present for businesses that have reviews.
- **Emails** — an email address is only present when the business lists one on its page; use employee contacts for more.
- **Login-required content** — nothing behind a login is collected.

### ❓ Yellow Pages Australia scraper FAQ

#### Can I scrape Yellow Pages Australia legally?

The actor only collects data that is already publicly visible on Yellow Pages Australia — no login, paywall or private content is accessed. Scraping publicly available data is generally considered lawful (see *hiQ Labs v. LinkedIn*), but you are responsible for complying with the site's Terms of Service and applicable laws such as GDPR or CCPA, since business listings can contain personal data such as names, phone numbers and emails.

#### What data does the Yellow Pages Australia scraper return?

Each record has the business name, phone, address, categories, website, rating and more. With business pages on you also get the full description, coordinates, opening hours, email, ABN, ACN, staff size, payment methods and social links. With employee contacts on, each record also has a `leads` array with employee names, roles and emails: business emails where the page lists one, plus employee emails found on each business website.

#### How many businesses can I scrape from one Yellow Pages Australia search?

`maxItems` limits the businesses saved for each search URL, not the whole run. A search shows a limited number of result pages; to collect more, use several search terms and locations.

#### Do I need a proxy to scrape yellowpages.com.au?

No. Pages are loaded by the Actor's built-in service, so you leave the proxy off.

#### How do I find emails of businesses on Yellow Pages Australia?

Switch on **Find employee contacts**: the actor looks up each business's website and adds employee names, roles and emails to a `leads` array. It is charged separately and only when the lookup successfully returns contacts: once per business, with at least one lead in every charged record, and nothing when `leads` is empty.

#### How do I scrape Yellow Pages Australia with Python?

Use the Python example above: call the actor with the Apify client and iterate over the dataset items.

#### Can I run this Yellow Pages Australia scraper on a schedule?

Yes. Use Apify Schedules to run it daily or weekly. Set a **Cache project name** and each run returns only new and changed businesses; businesses already seen and unchanged are skipped and not charged.

#### What output formats are supported?

JSON, CSV, Excel, XML and RSS, either from the **Output** tab or through the Apify API.

### 🔗 Relevant actors for business directories and leads

| Scraper | Description |
| ------- | ----------- |
| [📒 Páginas Amarillas Spain (Yellow Pages) Business Scraper](https://apify.com/confidential_gnat/paginasamarillas-business-scraper) | Scrape business listings from Páginas Amarillas Spain: name, phone, address and more. |
| [🏢 BBB Emails & Info Scraper](https://apify.com/confidential_gnat/bbb-business-scraper) | Scrapes Better Business Bureau businesses: name, phone, rating, accreditation and contacts. |
| [⚖️ Martindale Lawyers Scraper](https://apify.com/confidential_gnat/martindale-lawyers-scraper) | Scrapes lawyer and law firm profiles from Martindale with optional contacts. |
| [📧 Decision Maker Email Finder](https://apify.com/confidential_gnat/decision-maker-email-finder) | Finds decision makers and emails from company websites. |
| [💰 Signal NFX Investors Email Scraper](https://apify.com/confidential_gnat/signal-nfx-investors-scraper) | Scrapes VC and angel investor profiles from Signal by NFX. |

### 🔗 Other actors you may find useful

| Scraper | Description |
| ------- | ----------- |
| [💼 XING Jobs Scraper](https://apify.com/confidential_gnat/xing-jobs-scraper) | Scrape job listings from XING Jobs: title, company, location and employment type. |
| [🍷 Vivino Wine Scraper](https://apify.com/confidential_gnat/vivino-wine-scraper) | Scrape wine data from Vivino: name, winery, vintage, region and rating. |
| [📈 Kalshi Markets Scraper](https://apify.com/confidential_gnat/kalshi-markets-scraper) | Scrape Kalshi prediction markets: yes/no prices, implied probability and volume. |
| [✈️ Kiwi.com Flight Scraper](https://apify.com/confidential_gnat/kiwi-flight-scraper) | Scrape flight prices and schedules from Kiwi.com, including airline and times. |
| [🛒 Craigslist Listings Scraper](https://apify.com/confidential_gnat/craigslist-listings-scraper) | Scrape Craigslist listings in any city and category: title, price and more. |

### 💬 Support & contact

If you encounter any issues or have questions, please [open an issue](https://apify.com/confidential_gnat/yellowpages-australia-scraper/issues/open) or reach out via the [Apify Community Forum](https://community.apify.com/).

You can also find more of our actors on the [Actor Flow](https://apify.com/confidential_gnat) page.

# Actor input Schema

## `startUrls` (type: `array`):

Yellow Pages Australia search result pages, category pages or single business pages, for example https://www.yellowpages.com.au/search?search_terms=plumber\&geo_location_terms=Sydney%2C+NSW or https://www.yellowpages.com.au/sydney-nsw/plumbers. Leave empty to use the search terms and locations below.

## `maxItems` (type: `integer`):

Maximum businesses saved for each search. A search shows a limited number of result pages; for more, use narrower searches (more search terms or locations).

## `cacheProjectName` (type: `string`):

Use the same name on each scheduled run to get only new and changed businesses. Businesses already seen and unchanged are skipped and not charged. Each record gets a changeType: new or updated.

## `enrichLeads` (type: `boolean`):

Looks up each business's website for employee contacts (name, role, email, LinkedIn) and adds them as a 'leads' array. Needs the business to have a website. Adds a separate charge only for a business where the lookup successfully returns at least one contact (one charge per business, not per contact); nothing is charged when no contacts are found.

## `scrapeDetails` (type: `boolean`):

Open every business page for the full description, coordinates, opening hours, email, ABN, ACN, staff size, payment methods and social links. Slower; off by default. Adds a separate charge per business page opened, on top of the normal result price.

## `searchTerms` (type: `array`):

What to search for, for example plumber, dentist or cafe. Each term is searched in every location.

## `locations` (type: `array`):

Where to search, for example Sydney, NSW or Melbourne, VIC. Each location is searched for every search term.

## `proxyConfiguration` (type: `object`):

Not needed: pages are loaded by the Actor's built-in service. Leave proxies off.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.yellowpages.com.au/search?search_terms=plumber&geo_location_terms=Sydney%2C+NSW"
    }
  ],
  "maxItems": 5,
  "enrichLeads": false,
  "scrapeDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `businesses` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://www.yellowpages.com.au/search?search_terms=plumber&geo_location_terms=Sydney%2C+NSW"
        }
    ],
    "maxItems": 5,
    "enrichLeads": false,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("confidential_gnat/yellowpages-australia-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": [{ "url": "https://www.yellowpages.com.au/search?search_terms=plumber&geo_location_terms=Sydney%2C+NSW" }],
    "maxItems": 5,
    "enrichLeads": False,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("confidential_gnat/yellowpages-australia-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://www.yellowpages.com.au/search?search_terms=plumber&geo_location_terms=Sydney%2C+NSW"
    }
  ],
  "maxItems": 5,
  "enrichLeads": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call confidential_gnat/yellowpages-australia-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,confidential_gnat/yellowpages-australia-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/TAYdBy30Fc62Ry8Yv/builds/VgBvnQPDJo9i4nmoc/openapi.json
