GrubHub Scraper

Overview

This actor scrapes restaurant data from GrubHub. It can extract detailed information from individual restaurant pages or from search result listings. The data is output in JSON format for analysis or integration with other systems.

Key Features

• Comprehensive Data Extraction: Pulls restaurant details including name, address, phone, cuisines, ratings, and location coordinates.
• Menu and Hours Scraping: Optional extraction of menu items (with descriptions and prices) and operating hours.
• Robust Performance: Built-in proxy rotation and automatic retry logic for failed requests.
• Pagination Support: Can scrape multiple pages when provided with a search results URL.
• Configurable Limits: Set a maximum number of restaurants to scrape via maxItems.

How to Use

Configure the actor run using input parameters. You can provide either direct restaurant URLs or a search results page URL.

Input Parameters

• urls (Required): An array of GrubHub URLs to scrape. Can be individual restaurant pages or a search results page.
• maxItems (Optional): Maximum number of restaurants to scrape. Default is 100.
• scrapeMenu (Optional): Set to true to scrape menu items for each restaurant. Increases run time. Default is true.
• scrapeAvailableHours (Optional): Set to true to scrape operating hours. Default is true.

Input Examples

Example 1: Scraping a specific restaurant

{
  "urls": [
    "https://www.grubhub.com/restaurant/20-dollar-pizza-642-9th-ave-new-york/1172686"
  ],
  "scrapeMenu": true,
  "scrapeAvailableHours": true
}

Example 2: Scraping from search results

{
  "urls": [
    "https://www.grubhub.com/search?orderMethod=delivery&locationMode=DELIVERY&facetSet=umamiV6&pageSize=36&hideHateos=true&searchMetrics=true&queryText=pizza&latitude=40.71277618&longitude=-74.00597382&geohash=dr5regw3pgd3&sorts=price&includeOffers=true&featureControl=fastTagBadges%3Atrue&sortSetId=umamiv3&countOmittingTimes=true&tab=all"
  ],
  "maxItems": 100,
  "scrapeMenu": false,
  "scrapeAvailableHours": false
}

Input/Output

Output Format

The actor outputs a JSON array of restaurant objects. Each object contains the following core fields:

• name, id, url, description
• phoneNumber, cuisines[]
• location: address, city, postalCode, country, latitude, longitude
• deliveryInfo: fee, timeEstimate, available
• rating, ratingCount, priceRating
• currencyCode, logoUrl

If scrapeMenu is enabled, each restaurant object will also include a menuItems array containing:
- id, name, description
- price: pickup, delivery
- imageUrl (if available)

If scrapeAvailableHours is enabled, an availableHours array will be included.

Use Cases

• Market & Competitive Analysis: Compare restaurant offerings, menus, and pricing in specific locations.
• Data Enrichment: Add detailed restaurant information to existing datasets.
• Business & Academic Research: Study food industry trends, pricing, and consumer behavior.