YellowPages Business Scraper (USA Listings)

What is YellowPages Business Scraper?

YellowPages Business Scraper collects business listings from YellowPages.com for any keyword and place in the USA. For each business it returns the name, the categories, the business phone number, the address, the website, the star rating and review count where shown, the years in business and the YellowPages profile link. It opens the public search pages in a real Chromium browser, reads the rendered results, and pages through them. It collects business listings only; it does not collect personal contact details.

What data does YellowPages Business Scraper extract?

Field	Type	Description
name	string	Business name
categories	array	Categories listed for the business
phone	string or null	The business phone number shown on the listing
address	string or null	Street and city line as shown
street / locality	string or null	Street address and city, state and ZIP, when shown separately
website	string or null	The business website, when listed
rating	number or null	Star rating, 1 to 5, when shown
reviewCount	number or null	Number of reviews shown next to the rating
yearsInBusiness	number or null	Years in business, when shown
sponsored	boolean	True for paid placements
businessId / profileUrl	string	YellowPages business number and profile link
keyword, location, page, position, scrapedAt	mixed	The search that produced the row

How to use YellowPages Business Scraper

1. Enter the What keyword, for example "plumber".
2. Enter the Where place, for example "Austin, TX" or a ZIP code.
3. Set Max businesses and click Start.
4. Download the dataset as JSON, CSV or Excel, or read it through the API.

Example input

{
    "searchTerms": "dentist",
    "location": "Denver, CO",
    "maxItems": 40
}

Example output

Real row from a run on 2026-10-23 (dentist, Denver, CO). Values are as shown on YellowPages at that time.

{
    "businessId": "561052407",
    "name": "Aspen Dental",
    "categories": ["Dentists", "Oral & Maxillofacial Surgery", "Orthodontists"],
    "phone": "(303) 376-4154",
    "address": "9409 Sheridan Blvd, Westminster, CO 80031",
    "street": null,
    "locality": null,
    "website": null,
    "rating": null,
    "reviewCount": null,
    "yearsInBusiness": 5,
    "sponsored": true,
    "profileUrl": "https://www.yellowpages.com/westminster-co/mip/aspen-dental-561052407",
    "keyword": "dentist",
    "location": "Denver, CO",
    "page": 1,
    "position": 1,
    "scrapedAt": "2026-10-23T03:03:20.257Z"
}

Input parameters

• What (searchTerms): the business type or keyword. Default "plumber".
• Where (location): city and state, or a ZIP code. Default "Austin, TX".
• Max businesses (maxItems): 1 to 500. Default 30.

Pricing

Pay per business: one event for each business row written to the dataset. Prices in USD.

Plan	Price per 1,000 businesses
Free	$1.00
Bronze	$0.93
Silver	$0.87
Gold, Platinum, Diamond	$0.81

Measured platform usage on 2026-10-23: 40-business runs took 21 to 22 seconds on a 2 GB browser and were billed at $0.003 each (rounded by the platform), about $0.000075 per business. That is an upper estimate that includes the run start.

YellowPages Business Scraper vs. alternatives

Other YellowPages actors in the Apify Store list their per-result price at about $0.00096 to $0.003 at the free tier (checked on 2026-10-23). This Actor reads the search results in a real browser and returns the listing data. It does not open each business page, so hours, reviews text and photos are not included.

Using YellowPages Business Scraper with AI agents and MCP

Each business is one dataset row with flat fields, so an agent can filter by categories, rating or locality without parsing nested data. Call the Actor through the Apify MCP server or the REST API with {"searchTerms": "...", "location": "...", "maxItems": 40}.

FAQ

Is this legal? The Actor reads public business listings without logging in and without solving any challenge. Use the data within the law and within YellowPages' terms. Business phone numbers are public listing data; the Actor does not collect personal names or private contact details.

Why is the rating null for some businesses? Many listings show no rating. The field stays null instead of guessed.

Why are some websites null? Only listings with a website link show one.

Why do sponsored listings appear? They are paid placements shown in the results. The sponsored flag tells them apart.

What happens when YellowPages shows a check page? The Actor retries the page up to three times. If results still do not render, it records the page in the ERRORS record and stops that search. A run with no businesses at all fails, so you are not billed for an empty run.

Limits. Large limits (hundreds of businesses) were not measured in this release. The search is limited to what YellowPages returns for the keyword and place.

Related Actors

• Other webdatatools Actors are listed on the publisher profile.

Support

Open an issue on the Actor's Issues tab. Include the keyword, the place, the run ID and the ERRORS record if one exists.