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.