Yelp Business Scraper

Scrape structured Yelp business listings for local-market research, lead generation, location intelligence, and AI-agent workflows. Provide search terms and locations, paste Yelp search URLs, or scrape direct business URLs. Results are written to the default dataset as one stable JSON record per unique business.

What it extracts

Field	Description
name, yelpUrl	Business identity and canonical Yelp URL
rating, reviewCount, priceRange	Public rating and review signals
categories	Yelp business categories
phone, website, address	Public contact and location details
latitude, longitude	Coordinates when present in structured data
isClaimed	Claimed-page signal when visible
reviews	Optional visible reviews, capped by maxReviewsPerBusiness

Input

Use searchTerms with locations for searches:

{
  "searchTerms": ["coffee shops", "coworking spaces"],
  "locations": ["Austin, TX"],
  "maxResults": 50,
  "includeReviews": false
}

Use startUrls for a Yelp search or direct business page:

{ "startUrls": [{ "url": "https://www.yelp.com/biz/example-business" }] }

Search pages are expanded up to maxPagesPerSearch. The actor deduplicates business URLs and stops at maxResults. The default input is intentionally small so an agent or Apify health check can finish quickly.

Output

Each business is one dataset item. Optional fields use null when Yelp does not expose a value. A final _type: "SUMMARY" item and OUTPUT key-value record report item counts, failed pages, and block/challenge warnings.

When Yelp blocks the browser path, the actor can use ScrapeCreators' public Google Search endpoint as a fallback when SCRAPECREATORS_API_KEY is configured by the actor owner. Provider fallback rows include a warning and may contain fewer fields because they are based on public search snippets; no cookies are required and the API key is never an input field.

Reliability and limits

Yelp can vary content by region, session, and traffic level. The actor uses a low concurrency, persistent session pool and Apify Proxy by default. If Yelp presents a challenge, the run records a warning instead of pretending that a blocked page was an empty result. Use a lower page count and result cap for small one-off jobs.

Reviews are the visible reviews loaded on the business page, not a promise of the full review history. Website links may be Yelp redirect URLs when that is the only public link available.

Pricing

The actor is designed for predictable pay-per-use pricing: one primary result event per emitted business, with no charge for duplicate URLs or results beyond maxResults. Configure the final PPE price in Apify Console after observing proxy and runtime costs for your account.

Legal and responsible use

Use this actor only where you have a lawful basis and comply with Yelp's terms, robots directives, privacy obligations, and applicable local law. Respect rate limits and do not use extracted contact information for unwanted or unlawful outreach.

Use cases

• Build public prospect lists and qualify organizations or professionals before responsible outreach.
• Run a one-off research job and export the structured result as JSON, CSV, Excel, XML, or RSS from Apify.
• Schedule the same input to monitor changes over time and send completed datasets to a webhook or integration.
• Feed schema-shaped records into a database, spreadsheet, BI tool, or AI workflow with the source URL retained for verification.

Run Yelp Business Scraper with the Apify API

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('muhammadafzal/yelp-scraper').call({
  "searchTerms": [
    "coffee shops"
  ],
  "locations": [
    "Austin, TX"
  ],
  "startUrls": [],
  "maxResults": 25,
  "maxPagesPerSearch": 3,
  "includeReviews": false,
  "maxReviewsPerBusiness": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "BUYPROXIES94952"
    ],
    "apifyProxyCountry": "US"
  }
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

You can also run the Actor from Apify Console, schedules, webhooks, the REST API, Make, Zapier, n8n, or the hosted Apify MCP server.

Support

When reporting a problem, include the Actor run ID, a redacted input, the expected result, and a small public example URL when applicable. Do not post API tokens, cookies, credentials, or personal data in an issue.

Frequently asked questions

Can I schedule Yelp Business Scraper?

Yes. Use an Apify schedule to run the same saved input at a chosen interval, then connect a webhook or integration to process the dataset when the run finishes.

How should I test a new input?

Begin with the prefilled example or a small limit. Confirm that the output fields, source coverage, runtime, and live charges match your workflow before increasing the scope.

How do I export the results?

Open the run's default dataset in Apify Console and export JSON, CSV, Excel, XML, or RSS. Applications can retrieve the same records through the Apify API client or REST dataset endpoint.

Can an AI agent call this Actor?

Yes. Add muhammadafzal/yelp-scraper through the hosted Apify MCP server or call it through the API. The Actor's input and dataset schemas help agents construct valid requests and interpret returned records.