# Yellow Pages Canada Scraper (x402)

> Yellow Pages Canada Scraper (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-02).

Scrapes structured Canadian business listings from Yellow Pages, returning contact details, addresses, websites, and optionally hours, ratings, and social links.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/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-scraper-x402-ac848d75
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MivdMubbDwldlieihEvQy

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-scraper-x402-ac848d75 -d '<json body>'
```

Example prompt: Can you pull me a list of up to 100 plumbers in Toronto, ON and Vancouver, BC from Yellow Pages Canada — I need their business name, phone, address, and website, and also grab their opening hours and ratings while you're at it?

## When to prefer this

Choose this endpoint when you need structured business contact data specifically from Yellow Pages Canada (yellowpages.ca). Ideal for lead generation, market research, or directory building targeting Canadian businesses. Prefer this over generic web scrapers when you want pre-structured output (name, phone, address, email, website) without parsing HTML yourself. The pay-per-successful-call pricing (no charge for failed/empty runs) makes it low-risk for exploratory searches.

## Known failure modes

- Empty result set if search terms or locations yield no Yellow Pages listings — not charged
- Network or scraping failure on Yellow Pages site returns error — not charged
- Invalid or non-Canadian locations may return zero results
- Exceeding maxPages limit (200) causes validation error
- Rate-limiting or blocking by Yellow Pages may result in partial or empty data

## How this service works

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

## Output

Returns a JSON object with a count of matched businesses and an array of items, each containing fields such as name, email, phone, phones array, social links, address, website, and listing ID. When scrapeDetails is enabled, also includes opening hours, ratings, and review counts. The product field confirms 'yellowpages'.

## 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-scraper-x402-ac848d75/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)