# Yellow Pages Scraper (`anyxsolutions/yellowpages-scraper`) Actor
Scrapes US business listings from Yellow Pages by search term and location, returning names, addresses, phone numbers, websites, categories, ratings, and opening hours.
- **URL**: https://apify.com/anyxsolutions/yellowpages-scraper.md
- **Developed by:** [Anyx Solutions](https://apify.com/anyxsolutions) (community)
- **Categories:** Lead generation, Business, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $3.00 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## Yellow Pages Scraper
**US business listings with addresses, phones, websites, ratings, and opening hours.**
Search Yellow Pages by term and location — "plumbers in Austin, TX", "chinese restaurants in San
Francisco, CA" — and get every listing back as structured JSON, CSV, or Excel. Each result carries
the business name, full postal address, phone number, rating, review count, and opening hours. Point
it at individual business pages instead and you also get categories and the business website. Built
for local lead generation, market mapping, and competitor research.
### ⚡ Quick start
```json
{
"searchTerms": ["chinese restaurants"],
"location": "San Francisco, CA",
"maxItems": 30,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"]
}
}
```
### 🧩 Input
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| `searchTerms` | array | no¹ | — | What to search for, e.g. `plumbers`. One entry per search. |
| `location` | string | no | — | City and state, e.g. `San Francisco, CA`. Applies to every search term. |
| `startUrls` | array | no¹ | — | Yellow Pages URLs. Search pages and business pages are both supported. |
| `maxItems` | integer | no | `30` | Maximum businesses per search term or start URL. Search pages hold 30 listings each. |
| `proxyConfiguration` | object | no | `{ "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US" }` | Proxy settings. See the FAQ before changing this. |
¹ Provide either `searchTerms` or `startUrls`.
### 📤 Output
One dataset row per business, in the same shape whether the row came from a search page or from a
business page. Search listings are the cheaper source and carry everything except `website` and
`categories`; business pages add those two. `source` tells you which produced the row.
#### Fields
| Field | Type | Description |
|---|---|---|
| `name` | string | Business name. |
| `url` | string | Yellow Pages listing URL. |
| `phone` | string | Phone number as listed. |
| `website` | string | The business's own website. Business pages only. |
| `address` | string | Full address on one line. |
| `street` | string | Street portion of the address. |
| `city` | string | City. |
| `state` | string | Two-letter state code. |
| `postalCode` | string | ZIP code. |
| `country` | string | Two-letter country code. |
| `categories` | array | Business categories. Business pages only. |
| `rating` | number | Star rating out of 5, e.g. `4.5`. |
| `reviewCount` | number | Number of reviews. |
| `openingHours` | object | Opening hours per weekday, e.g. `{ "Mo": "11:00-21:30" }`. |
| `source` | string | `search` or `business` — which page type produced the row. |
| `page` | number | Results page the listing came from. `null` for business pages. |
Example output
```json
{
"name": "Z &Y Restaurant",
"url": "https://www.yellowpages.com/san-francisco-ca/mip/z-y-restaurant-4970454",
"phone": "(415) 981-8988",
"website": null,
"address": "655 Jackson St, San Francisco, CA 94133",
"street": "655 Jackson St",
"city": "San Francisco",
"state": "CA",
"postalCode": "94133",
"country": "US",
"categories": [],
"rating": 5,
"reviewCount": 17,
"openingHours": {
"Mo": "11:00-21:30",
"Tu": "11:00-21:30",
"We": "11:00-21:30",
"Th": "11:00-21:30",
"Fr": "11:00-22:30",
"Sa": "11:00-22:30",
"Su": "11:00-21:30"
},
"source": "search",
"page": 1
}
```