
GetYourGuide Scraper
scrape.ly/store/roamandroof/getyourguide-scraperTravelE-commerce
1 monthly user

Scrape public Yelp businesses by search term and city, or from Yelp URLs. Get contact details, rating, opening hours, amenities, and photos.
Scrape public Yelp businesses by search term and city, or from Yelp business and search URLs. Each result is one business with its name, address, phone, website, rating, review count, price range, categories, opening hours, amenities, highlights, and photos. No Yelp login needed, $1.80 per 1,000 businesses.
| Field | Key | What it does |
|---|---|---|
| Search terms | searchTerms | What to search for, such as Pizza. Each term runs in every location. |
| Locations | locations | Cities or addresses. A term without a location is skipped. |
| Search results limit | searchLimit | Businesses to save per search (1 to 240). Default 10. |
| Yelp URLs | directUrls | Business or search page URLs, scraped together with any search terms. |
| Max images | maxImages | Photos to keep per business (the page holds about 25). |
| Proxy configuration | proxyConfiguration | Datacenter by default. |
{
"searchTerms": ["Pizza"],
"locations": ["New York"],
"searchLimit": 10,
"directUrls": [],
"maxImages": 20,
"proxyConfiguration": {
"useScrapelyProxy": true,
"scrapelyProxyGroups": ["DATACENTER"]
}
}
Every term runs in every location, so two terms and two cities are four searches. searchLimit applies to each search, not to a single business URL.
One dataset row per business.
| Field | Description |
|---|---|
name, bizId, directUrl | Business name, Yelp id, and page URL. |
address | Street, city, region, postal code, and country. |
phone, website | Contact details when listed. |
aggregatedRating, reviewCount | Star rating and number of reviews. |
priceRange, type, cuisine, categories | Price band and categories. |
operationHours | Hours per day, with raw minute values. |
amenitiesAndMore, businessHighlights | Features and highlights. |
aboutTheBusiness | Specialties, history, and year established when listed. |
healthScore, claimed, verified, advertiser | Inspection grade and listing status. |
primaryPhoto, images | Photo links. |
{
"name": "East Village Pizza",
"bizId": "oOr6Ta5gZyDl6PyZ1cq7pg",
"directUrl": "https://www.yelp.com/biz/east-village-pizza-new-york",
"address": {
"addressLine1": "145 1st Ave",
"city": "New York",
"regionCode": "NY",
"postalCode": "10003",
"country": "US"
},
"phone": "(212) 529-4545",
"website": "https://www.eastvillagepizza.net",
"aggregatedRating": 4.1,
"reviewCount": 698,
"priceRange": "Under $10",
"type": "Restaurants",
"cuisine": "Pizza",
"categories": ["Restaurants", "Pizza"],
"amenitiesAndMore": ["Offers delivery", "Offers take-out", "Takes reservations"],
"businessHighlights": ["Grab-and-go", "Vegetarian friendly", "Casual dining"],
"healthScore": "Grade Pending",
"claimed": true,
"primaryPhoto": "https://s3-media0.fl.yelpcdn.com/bphoto/m_q8O3vifJvbyoeTIZ2UxQ/l.jpg"
}
(Trimmed: the real row also has the full hours, the about section, and an image list.) Fields Yelp does not publish come back as null or an empty list.
You pay $0.0018 per business saved, which is $1.80 per 1,000 businesses. Platform usage (compute and proxy) is billed on top.
Worked example: 10 businesses cost 10 × $0.0018 = $0.018 in events plus about $0.014 of compute and proxy, around $0.032 in total.
The actor reads only public pages. You are responsible for using the data in line with Yelp's terms and applicable law.
No account. A datacenter proxy is built in and used by default.
No. The actor saves the rating and the review count, not the review text.
It produces no row, and the run still succeeds.
Yelp leaves out hours, amenities, or a website on some listings, and the health score is only set where Yelp publishes an inspection.
Yes, from the console or through the API.
maxImages cannot add more.Every field below can be set in the run form, passed through the API, or saved as a task. Unset fields fall back to the defaults shown.
searchTermsarrayOptionalSearch terms
What to search for, such as Pizza or Plumbers. Each term is searched in every location.
locationsarrayOptionalLocations
Cities or addresses to search. A search term without a location is skipped.
searchLimitintegerOptionaldefault 10Search results limit
How many businesses to save for each search. Yelp shows about 240 results for one search.
directUrlsarrayOptionaldefault []Yelp URLs
Business or search page URLs. These are scraped together with any search terms.
How many photos to keep from each business page.
maxImagesintegerOptionaldefault 20Max images
Photos to keep per business. The business page includes about 25. Set 0 to skip photos.
proxyConfigurationobjectOptionaldefault {"useScrapelyProxy":true,"scrapelyProxyGroups":["DATACENTER…Proxy configuration
Proxy used to reach Yelp. Datacenter is tried first.
Every run writes its results to a dataset. Preview it in the dashboard, then export it or read it through the API.
| Field | Type | Description |
|---|---|---|
| primaryPhoto | string | null | Main photo URL |
| name | string | null | Business name |
| type | string | null | Top-level category |
| priceRange | string | null | Price range |
| cuisine | string | null | Cuisine, for restaurants |
| aggregatedRating | number | null | Average rating |
| reviewCount | number | null | Number of reviews |
| directUrl | string | null | Yelp business URL |
| website | string | null | Business website |
You pay for the events the actor reports, such as each result or page it produces. Platform usage is included in the event prices.
| Event | Charged when | Price |
|---|---|---|
| Result | One Yelp business saved to the dataset. | $0.0018 |
Run this actor from your own code. Swap in your API token and the examples work as-is.
import { ScrapelyClient } from 'scrapely-client'
const client = new ScrapelyClient({ token: process.env.SCRAPELY_TOKEN })
// Start the actor and wait for the run to finish.
const run = await client.actor('cornerledger/yelp-scraper').call({
"searchTerms": [
"Pizza"
],
"locations": [
"New York"
],
"searchLimit": 10,
"maxImages": 20,
"proxyConfiguration": {
"useScrapelyProxy": true,
"scrapelyProxyGroups": [
"DATACENTER"
]
}
})
// Read the dataset the run produced.
const { items } = await client.dataset(run.defaultDatasetId).listItems()
console.log(items)Tokens live in your account settings. Keep them server-side: a token carries the full permissions of your account.
Connect the Scrape.ly MCP server once and your agent can run this actor as a tool. Pick your tool:
Fetch scrape.ly/agents.md and run cornerledger/yelp-scraperPaste into Claude Code, Codex, Cursor or any AI agent. It signs you in once in the browser.
{
"mcpServers": {
"scrapely": {
"url": "https://api.scrape.ly/mcp?tools=actors,runs,storage,docs&actors=cornerledger/yelp-scraper"
}
}
}No key in the file: your client opens the browser to sign you in the first time it connects.
No examples yet
The developer hasn't published example inputs for this actor.
Scrape.ly gives you the infrastructure, the tooling, and the team to extract, process, and operationalize web data at any scale. Setup takes minutes. The advantage lasts forever.