# Canada411 People & Phone Directory Scraper

> Canada411 People & Phone Directory Scraper is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes Canada411 for residential listings by name, address, phone number, or postal code and returns structured contact records

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/canada411?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/canada411-people-phone-directory-scraper-0bd62706
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_k6YMHW9FIUCxS9A5IY1_R

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 canada411-people-phone-directory-scraper-0bd62706 -d '<json body>'
```

Example prompt: Can you look up John Maguire in North York, ON on Canada411 and get me his address and phone number? Limit it to the top 10 results.

## When to prefer this

Use this endpoint when you need structured Canadian residential contact data from Canada411 — particularly for reverse phone lookups, name-to-address searches, or postal code area sweeps. It is purpose-built for Canadian directory data and handles pagination automatically. Prefer it over generic web scrapers when you need clean, deduplicated listing records without writing custom extraction logic.

## Known failure modes

- No listings found for the given search parameters — returns empty items array (not charged)
- Canada411 blocks the scraper — may require enabling proxy option (useApifyProxy: true)
- Invalid or non-Canadian phone number format causes no results
- Postal code must be full 6-character Canadian format (e.g. M9N 3L3) — partial codes may fail
- maxPages or maxItems limits reached before all results are fetched

## 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 matched listings and an array of items, each with the person's name, phone number, formatted phone, street address, city, listing type, and a Canada411 listing ID. Failed or empty scrapes are not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "names": {
   "type": "array",
   "description": "Person or listed name to search in every location. A location is required for name searches."
  },
  "proxy": {
   "type": "object",
   "default": {
    "useApifyProxy": false
   },
   "description": "Optional proxy configuration. Direct requests are used by default; enable if your run encounters blocks."
  },
  "maxItems": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Stop after this many unique listings across all searches. Set 0 to use only the page limits."
  },
  "maxPages": {
   "type": "integer",
   "default": 20,
   "maximum": 200,
   "minimum": 1,
   "description": "Maximum 100-result pages to read for each search, subject to the number of pages the site reports."
  },
  "addresses": {
   "type": "array",
   "description": "Street, city, and optional province, separated by commas; for example 48 Howbert, North York, ON."
  },
  "locations": {
   "type": "array",
   "description": "City, city and province, or province for each name search."
  },
  "startUrls": {
   "type": "array",
   "description": "Canada411 search results or residential profile URLs. Search result pages are followed up to maxPages."
  },
  "postalCodes": {
   "type": "array",
   "description": "Full six-character Canadian postal codes, such as M9N 3L3."
  },
  "phoneNumbers": {
   "type": "array",
   "description": "Canadian phone numbers for reverse lookup, in any common format."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "city": null,
    "name": null,
    "type": null,
    "phone": null,
    "street": null,
    "address": null,
    "listingId": null,
    "phoneFormatted": null
   }
  ],
  "product": "canada411"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/canada411-people-phone-directory-scraper-0bd62706/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)
