# Yellow Pages Canada Business Scraper

> Yellow Pages Canada Business Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-02).

Scrapes structured business listings from Canadian Yellow Pages, returning contact details, addresses, and optional extended profiles for businesses matching given search terms and locations.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/yellowpages?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/yellow-pages-canada-business-scraper-cc24ed98
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EYdpOcIOVUH3dFeyhzPj8

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability yellow-pages-canada-business-scraper-cc24ed98 -d '<json body>'
```

Example prompt: Search Yellow Pages Canada for plumbers and HVAC companies in Toronto, ON and Vancouver, BC — grab up to 100 listings in English and include their opening hours, ratings, and social links too.

## When to prefer this

Choose this endpoint when you specifically need structured business listing data from Canadian Yellow Pages (yellowpages.ca), covering Canadian cities and provinces. It is ideal for lead generation, local market research, or directory enrichment targeting Canadian businesses. Prefer it over generic web scrapers when you need consistent structured output (name, phone, address, email, website) and optionally extended details like hours and ratings.

## Known failure modes

- Empty results if search terms or locations produce no matches on Yellow Pages Canada — not charged
- Rate limiting or blocking by Yellow Pages Canada resulting in partial data
- Invalid or unsupported Canadian city names causing no location matches
- maxItems set to 0 with very broad terms may return extremely large datasets slowly
- startUrls pointing to non-Yellow Pages Canada domains may be ignored or fail

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

A JSON object containing a count of businesses found and an array of business records, each with fields for name, email, phone, phones (array), social links, address, website, and listing ID. When scrapeDetails is enabled, additional fields like opening hours, ratings, and review counts are included.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "language": {
   "enum": [
    "en",
    "fr"
   ],
   "type": "string",
   "default": "en",
   "description": "Language for keyword searches. Start URLs keep their own site language."
  },
  "maxItems": {
   "type": "integer",
   "default": 50,
   "minimum": 0,
   "description": "Stop after this many unique businesses across all searches. Zero removes the cap."
  },
  "maxPages": {
   "type": "integer",
   "default": 20,
   "maximum": 200,
   "minimum": 1,
   "description": "Maximum result pages to request for each term and location or search URL."
  },
  "locations": {
   "type": "array",
   "description": "Canadian cities or city and province pairs, such as Toronto, ON."
  },
  "startUrls": {
   "type": "array",
   "description": "Canadian search pages or business profile URLs. Use this instead of, or alongside, terms and locations."
  },
  "searchTerms": {
   "type": "array",
   "description": "Business categories or keywords to search in every location."
  },
  "scrapeDetails": {
   "type": "boolean",
   "default": false,
   "description": "Load each business page for opening hours, ratings, review count, and social links. This increases request volume."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "name": null,
    "email": null,
    "phone": null,
    "phones": null,
    "social": null,
    "address": null,
    "website": null,
    "listingId": null
   }
  ],
  "product": "yellowpages"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/yellow-pages-canada-business-scraper-cc24ed98/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)