# Yellowpages (Canada) — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for businesses across Canada and retrieve detailed information including contact details, ratings, reviews, and website data. Supports keyword and location-based discovery of local businesses for research, analysis, and data enrichment use cases.

**Category:** Business Directories | **Website:** [yellowpages.ca/](https://yellowpages.ca/) | **Docs:** [parse.bot/marketplace/bd821d21-6409-4511-8a2a-f89718bf21a5/yellowpages-ca-api](https://parse.bot/marketplace/bd821d21-6409-4511-8a2a-f89718bf21a5/yellowpages-ca-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-yellowpages-ca-api-bd821d21/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_business_leads_with_website

Filter the first page of search results for a given keyword and location to return only businesses that include a website URL. Useful for quickly identifying businesses with an online presence. Internally calls search_businesses page 1 and filters.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `keyword` | string | Yes | Business keyword to search for (e.g. 'restaurants', 'dentists', 'plumbers'). |
| `location` | string | Yes | Location to search in, formatted as city and province code (e.g. 'Toronto ON', 'Vancouver BC'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yellowpages-ca-api-bd821d21/get_all_business_leads_with_website \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"<string>","location":"<string>"}'
```

### get_business_details

Retrieve full details for a specific business by its path. Returns name, address, phone, website, business hours, rating summary with sub-ratings, social links, photos, and categorized detail sections. The path is obtained from search_businesses results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `path` | string | Yes | The path to the business page, as returned in the 'path' field from search_businesses results (e.g. '/bus/Ontario/Toronto/Bardi-s-Steak-House/156059.html?what=restaurants&where=Toronto+ON&useContext=true'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yellowpages-ca-api-bd821d21/get_business_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"path":"<string>"}'
```

### get_business_reviews

Retrieve customer reviews for a business. Returns written reviews with author, date, body text, and rating. Businesses that have only ratings but no written reviews will return an empty reviews array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `path` | string | Yes | The path to the business page, as returned in the 'path' field from search_businesses results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yellowpages-ca-api-bd821d21/get_business_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"path":"<string>"}'
```

### search_businesses

Full-text search across Yellow Pages Canada by keyword and location. Returns paginated business listings (up to 35 per page) with contact info, ratings, and categories. Pagination advances via the page parameter. Each result includes a path suitable for drilling into details or reviews.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `keyword` | string | Yes | Business keyword to search for (e.g. 'restaurants', 'dentists', 'plumbers'). |
| `location` | string | Yes | Location to search in, formatted as city and province code (e.g. 'Toronto ON', 'Vancouver BC', 'Calgary AB'). |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yellowpages-ca-api-bd821d21/search_businesses \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"<string>","location":"<string>","page":"<integer>"}'
```