Yellow Pages Canada Scraper — Business Leads

Scrape Canadian business listings from YellowPages.ca — the largest business directory in Canada. Extract business names, phone numbers, emails, addresses, websites, ratings, reviews, operating hours, social media links, and geo-coordinates. Search by keyword + location or paste direct URLs.

Use Cases

• B2B Lead Generation: Build targeted prospect lists of Canadian SMBs by category and city for outbound sales
• Local SEO Analysis: Audit client listings against top-ranked competitors across Canadian markets
• Market Research: Map business density, compare ratings, and track competitor coverage across provinces
• CRM Enrichment: Enrich existing business databases with verified phone, website, address, and social handles
• Recruiting: Find trades and skilled-trade employers (plumbers, electricians, contractors) for sourcing
• Directory Building: Build structured local-business corpora for RAG, LLM training, or data products

Features

• Multi-input mode: Search by keyword + location OR paste direct YellowPages.ca URLs
• Detail page enrichment: Optional visit to each business detail page for email, hours, social links, services, photos, coordinates
• Customer reviews: Optional review extraction (author, rating, text, date)
• Anti-bot handling: Residential CA proxies + session rotation + stealth browser args
• Pagination: Automatic pagination through search results (configurable max pages)
• Sort options: Default, distance, name, or rating
• MCP-optimized: Semantic field names, structured output, AI-agent-ready schema
• Pay-per-event: Only charged for results actually extracted

Input Parameters

Parameter	Type	Default	Description
searchTerms	string[]	["plumber"]	Keywords/categories to search (cross-joined with locations)
locations	string[]	["Toronto, ON"]	Canadian locations in "City, Province" format
startUrls	array	[]	Direct YellowPages.ca URLs (search, category, or detail pages)
maxResults	integer	100	Hard cap on total business records (0 = unlimited)
maxPagesPerSearch	integer	10	Max result pages to crawl per search term × location
extractDetails	boolean	true	Visit detail pages for richer fields (email, hours, social, etc.)
includeReviews	boolean	false	Extract customer reviews (requires extractDetails)
maxReviewsPerBusiness	integer	30	Max reviews per business (0 = all, ~500 cap)
sortBy	enum	"default"	Sort: default, distance, name, or rating
proxyConfiguration	object	CA residential	Proxy settings (CA residential required)
maxConcurrency	integer	5	Concurrent browser pages

Output Data

Each record contains:

Field	Type	Description
businessName	string	Business name
phone	string|null	Phone number
email	string|null	Email address (from detail page)
website	string|null	Business website URL
address	object	{street, city, province, postalCode}
addressFormatted	string|null	Full address as single string
coordinates	object|null	{lat, lng} geo-coordinates
categories	string[]	Business categories
primaryCategory	string|null	First category
rating	number|null	Star rating (1-5)
reviewCount	number|null	Total review count
hours	object|null	Day-by-day operating hours
socialLinks	object	{facebook, instagram, linkedin, twitter, youtube}
logo	string|null	Logo image URL
photos	string[]	Photo image URLs
services	string[]	Services offered
paymentMethods	string[]	Accepted payment methods
yearsInBusiness	number|null	Years in operation
claimed	boolean|null	Whether listing is owner-claimed
profileUrl	string	YellowPages.ca profile URL
yellowPagesId	string|null	Internal YP listing ID
searchTerm	string|null	Search keyword used
searchLocation	string|null	Search location used
sourceUrl	string	Page URL where data was extracted
scrapedAt	string	ISO 8601 timestamp
reviews	array|undefined	Customer reviews (if enabled)

Sample Output

{
  "businessName": "Joe's Plumbing Inc",
  "phone": "+1 416-555-0123",
  "email": "info@joesplumbing.ca",
  "website": "https://joesplumbing.ca",
  "address": {
    "street": "123 Main Street",
    "city": "Toronto",
    "province": "ON",
    "postalCode": "M1M 1M1"
  },
  "addressFormatted": "123 Main Street, Toronto, ON, M1M 1M1",
  "coordinates": { "lat": 43.6532, "lng": -79.3832 },
  "categories": ["Plumbing", "Contractor"],
  "primaryCategory": "Plumbing",
  "rating": 4.5,
  "reviewCount": 127,
  "hours": { "Monday": "8:00-17:00", "Tuesday": "8:00-17:00" },
  "socialLinks": {
    "facebook": "https://facebook.com/joesplumbing",
    "instagram": null,
    "linkedin": null,
    "twitter": null,
    "youtube": null
  },
  "logo": "https://...",
  "photos": ["https://..."],
  "services": ["Drain cleaning", "Pipe repair"],
  "paymentMethods": ["Visa", "Mastercard"],
  "yearsInBusiness": 15,
  "claimed": true,
  "profileUrl": "https://www.yellowpages.ca/bus/Ontario/Toronto/Joes-Plumbing/12345.html",
  "yellowPagesId": "12345",
  "searchTerm": "plumber",
  "searchLocation": "Toronto, ON",
  "sourceUrl": "https://www.yellowpages.ca/search/si/1/plumber/Toronto+ON",
  "scrapedAt": "2026-07-02T10:30:00.000Z"
}

Pricing

This actor uses pay-per-event pricing:

Event	Price	Description
Actor Start	$0.00005	Charged once per run start
Business Scraped	$0.003	Per business listing extracted

Cost Examples

• Scrape 100 businesses → $0.30
• Scrape 1,000 businesses → $3.00
• Scrape 10,000 businesses → $30.00

Code Examples

JavaScript

const { ApifyClient } = require('apify-client');

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

const run = await client.actor('muhammadafzal/yellow-pages-ca-scraper').call({
  searchTerms: ['plumber'],
  locations: ['Toronto, ON', 'Montreal, QC'],
  maxResults: 200,
  extractDetails: true
});

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

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")
run = client.actor("muhammadafzal/yellow-pages-ca-scraper").call(run_input={
    "search_terms": ["dentist"],
    "locations": ["Vancouver, BC"],
    "max_results": 500,
    "extract_details": True
})
dataset = client.dataset(run["defaultDatasetId"]).list_items()
for item in dataset:
    print(item["businessName"], item["phone"], item["email"])

Technical Notes

• Proxy: Canadian residential proxies are required — YellowPages.ca uses CloudFront geo-blocking that blocks datacenter IPs and non-CA traffic
• Crawler: PlaywrightCrawler with stealth browser args and session rotation
• Speed: ~2-5 seconds per search page, ~3-8 seconds per detail page
• Limits: YellowPages.ca returns up to ~500 results per search term × location pair

FAQ

Q: Why am I getting 0 results? A: Ensure proxy is set to Canadian residential (CA). YellowPages.ca geo-blocks non-Canadian IPs. Check that your search terms and locations are valid Canadian locations.

Q: Can I scrape all of Canada? A: Yes — leave locations empty (defaults to Toronto, ON). For comprehensive coverage, specify multiple cities: ["Toronto, ON", "Montreal, QC", "Vancouver, BC", "Calgary, AB", "Ottawa, ON"].

Q: Why is email null for some businesses? A: Email is only available on the business detail page. Ensure extractDetails is true. Some businesses don't list emails publicly.

Q: How do I get reviews? A: Enable both extractDetails and includeReviews. Reviews increase runtime significantly.

What is Yellow Pages Canada Scraper?

Yellow Pages Canada Scraper turns the target data into structured, reusable results on Apify. Use it when you need repeatable collection for sales teams, agencies, recruiters, market researchers, and data-enrichment workflows without maintaining a custom scraper or one-off integration. Run it manually, schedule recurring jobs, call it through the Apify API, or connect it to an AI agent through the Apify MCP server.

The Actor stores results in an Apify dataset, where they can be previewed and exported as JSON, CSV, Excel, XML, or RSS. Availability and completeness depend on the source, supplied inputs, public visibility, authentication requirements, and upstream rate limits.

Use cases for Yellow Pages Canada Scraper

• Build structured datasets for research, reporting, enrichment, or monitoring.
• Automate repetitive collection with schedules, webhooks, and API calls.
• Feed clean records into spreadsheets, databases, CRMs, BI tools, AI agents, or RAG pipelines.
• Track changes over time by running the same validated input on a schedule.
• Replace fragile manual copy-and-paste work with a reproducible Apify workflow.

How to use Yellow Pages Canada Scraper

1. Open the Actor input page and choose a focused, valid target.
2. Set a conservative result limit for the first run.
3. Start the Actor and inspect the dataset for coverage and field availability.
4. Export the results or connect the dataset to your downstream system.
5. Scale gradually and use scheduling, pagination, or proxies when supported.

Important input options

• searchTerms — Keywords or business categories to search for on YellowPages.ca (e.g. plumber, dentist, restaurant). Each term is cross-joined with every location — 2 terms x 3 locations = 6 searches. Use t
• locations — Canadian locations in 'City, Province' or 'City, ST' format (e.g. 'Toronto, ON', 'Montreal, QC', 'Vancouver, BC'). Each location is cross-joined with every search term. Leave empty to search
• startUrls — Direct YellowPages.ca URLs to scrape. Accepts search results pages (yellowpages.ca/search/...), category pages (yellowpages.ca/ON/Toronto/Plumbers), or individual business detail pages (yell
• maxResults — Hard cap on total business records extracted across all searches and URLs. Set to 0 for unlimited (internal cap of 10,000 applies). The actor stops paginating once this number is reached.
• maxPagesPerSearch — Maximum number of result pages to crawl per (search term x location) pair or per start URL. YellowPages.ca typically shows up to 50 results per page. Set higher for more exhaustive crawls.
• extractDetails — When enabled, follow each business's detail page on YellowPages.ca to extract additional fields (email, full hours, social links, services, payment methods, years in business, logo, photos,
• includeReviews — Embed customer reviews for each business when 'Visit Detail Pages' is also enabled. Off by default — significantly increases runtime as each business needs additional review page fetches.
• maxReviewsPerBusiness — Maximum number of customer reviews to capture per business when 'Include Reviews' is enabled (most recent first). Set to 0 to capture every available review (internal hard cap of ~500 applie

API and automation example

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('muhammadafzal/yellow-pages-ca-scraper').call({
  // Add the same input fields you use in the Apify Console.
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Related Apify Actors

Use these dedicated tools when a neighboring data source or workflow is a better match:

• Instagram Followers & Following Scraper — With Cookies
• Leads Finder Pro - B2B Leads with Emails [Apollo Alternative]
• Yellow Pages US Scraper — Business Leads & Reviews
• Yellow Pages Australia Scraper — Business Leads & Reviews
• OpenTable Restaurants, Ratings & Reviews Scraper
• Etsy Scraper Pro — Products, Prices, Reviews & Shop Data
• Shopify Store Scraper - Products, Reviews & Emails
• 🔧 USA Plumbers Scraper — Leads with Phone, Address & Website
• California CSLB Contractor License Scraper
• USA HVAC Leads Scraper — Verified Emails (AC, Heating)

Frequently asked questions

How many results can I scrape with Yellow Pages Canada Scraper?

The practical total depends on the source, input limits, pagination, available records, run timeout, and upstream restrictions. Start with a small run, verify the output, and increase the limit gradually.

Can I integrate Yellow Pages Canada Scraper with other apps?

Yes. Use Apify integrations, webhooks, schedules, dataset exports, Make, Zapier, Google Sheets, cloud storage, or your own application.

Can I use Yellow Pages Canada Scraper with the Apify API?

Yes. Start runs with the Apify REST API or an official Apify client, then retrieve records from the run's default dataset. Keep your API token in a secret or environment variable.

Can I use Yellow Pages Canada Scraper through an MCP Server?

Yes. The Apify MCP server can expose the Actor to compatible AI clients and agents. Review the input and expected cost before allowing an autonomous workflow to run it at scale.

Do I need proxies?

It depends on the source and volume. Use the default configuration first. For larger or geographically sensitive jobs, select an appropriate proxy configuration only when the Actor supports it.

Is it legal to scrape this data?

Scraping rules vary by source, jurisdiction, data type, and intended use. Collect only data you are authorized to access, respect applicable terms and privacy laws, and avoid restricted or personal data misuse. This documentation is not legal advice.

Your feedback

If a field is missing, a source layout has changed, or you need a supported use case documented, open an issue on the Actor page with a reproducible input and run ID.