GrubHub

GrubHub API & Data Access

Unofficial | 👉 Official GrubHub Website: https://www.grubhub.com | 👥 Contributors: steve

Notes

These are unofficial GrubHub API endpoints useful for scraping public data such as restaurants, contact information, menus, popular dishes and pricing. They are made available for unofficial use and experimentation, such as for security research, use at your own risk!

Most of these endpoints are presumed to work with GrubHub’s mobile app, meaning that these endpoints are unlikely to change too much as mobile clients tend to stick around in the wild for a while. Hence, it should be safe to assume these won’t change too much over the next few years.

Auth Token

GrubHub requires all authentication for all endpoints, even for public data. You’ll need to get a GrubHub authentication token to access data, which you can do anonymously (without a username and password). The token typically lasts for 60 minutes, so you’ll need to get a new token if you want to make repeated requests over the span of a few hours.

Rate Limiting

Please be considerate when requesting data through these endpoints or GrubHub may block your requesting IP address. We don’t recommend exceeding one request per second per proxy.

Read Only

These endpoints are “read only” and only allow you to scrape data.

Official API

There is no known official API for GrubHub.

Sample Data

Below is a sample JSON snippet for a restaurant (with nested menu information). You can also download aggregate results together in CSV format.

{
  "restaurant_id": "316958",
  "restaurant_hash": "9e10d474bd900c761a591c8b85944717",
  "name": "Just Salad City Hall (Broadway)",
  "logo": "https://res.cloudinary.com/grubhub/image/upload/v1486662673/r3xwotdshe6btnjvtajx.png",
  "description": null,
  "billing_comment": null,
  "pickup": true,
  "delivery": true,
  "ratings": {...},
  "delivery_fee": null,
  "service_fee": null,
  "delivery_minimum": {...},
  "menu_items": [...],
  "total_menu_items": 120,
  "cuisines": [...],
  "phone_only": false,
  "phone_number": {...},
  "routing_number": {...},
  "coupons_available": false,
  "coupons_count": 0,
  "first_coupon": null,
  "track_your_grub": true,
  "accepts_credit": false,
  "accepts_cash": false,
  "address": {...},
  "highlighting_info": [...],
  "time_zone": "America/New_York",
  "price_rating": 3,
  "distance_from_location": "0.13",
  "delivery_time_estimate": 25,
  "pickup_time_estimate": 10,
  "min_delivery_fee": {...},
  "delivery_fee_without_discounts": {...},
  "delivery_fee_percent": 0,
  "restaurant_cdn_image_url": "http://s1.seamless.com/-/ri/vl/43691",
  "media_image": {...},
  "recommended": false,
  "rank": 1,
  "faceted_rating_data": {...},
  "open": true,
  "next_open_at": null,
  "next_delivery_time": null,
  "next_pickup_time": null,
  "next_closed_at": "2019-07-18T22:30:00.000Z",
  "inundated": false,
  "badge_list": [...],
  "additional_media_images": {...},
  "available_hours": null,
  "override_hours": null,
  "catering": false,
  "percentage_ad_fee": 0,
  "go_to": false,
  "uid": "searchRestaurant#dr5reg_316958",
  "available_promo_codes": null,
  "chain_id": "4479e9e0-abb9-11e8-8468-1994b8258d1f",
  "chain_name": "Just Salad",
  "brand_id": "3f2b6b50-f419-11e8-ba38-b7aec5cdfecf",
  "brand_name": "Just Salad",
  "sales_force_group": "Just Salad",
  "queue_size": null,
  "merchant_url_path": "just-salad-city-hall-broadway-233-broadway-new-york",
  "score": 1,
  "offers_background_color": "#14294C",
  "new_restaurant": false,
  "vendor_location_id": 43691
}