Grubhub

Search Grubhub restaurants near a location

Returns restaurants delivering to (or offering pickup at) a latitude/longitude, optionally filtered by keyword over restaurant names, cuisines and dishes. Each restaurant carries its id (the value every other Grubhub endpoint takes), name, full address with coordinates, phone, cuisines, star rating and rating count, Grubhub's 1-4 price tier, distance, open state, delivery and pickup fees and minimums, service fee, delivery and pickup time estimates, coupon availability and total menu item count. A location Grubhub does not serve returns an empty list rather than an error.

get/grubhub/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/grubhub/search
  • Auth: API key in header x-api-key

Query parameters

latitudenumber required

Search center latitude

longitudenumber required

Search center longitude

searchstring

Keyword over restaurant names, cuisines and dishes

order_method'delivery' | 'pickup'

One of delivery, pickup. Default delivery.

page_sizeinteger

Restaurants per page, 1-50 (default 20)

pageinteger

1-based page number (default 1)

Headers

x-api-keystring required

API key required

Response

OK

codeinteger

Code is the HTTP status code or a custom code used to indicate the result of the request @example 200

msgunknown

Example response

{
  "data": {
    "count": 20,
    "page": 1,
    "restaurants": [
      {
        "address": "199 Water Street",
        "city": "New York",
        "delivery_fee": {
          "amount": 399,
          "currency": "USD",
          "value": 3.99
        },
        "delivery_minimum": {
          "amount": 399,
          "currency": "USD",
          "value": 3.99
        },
        "delivery_time_minutes": 30,
        "distance_miles": "0.4",
        "name": "NYC Bagel and Coffee House",
        "offers_delivery": true,
        "offers_pickup": true,
        "open": true,
        "pickup_time_minutes": 15,
        "postal_code": "10038",
        "price_rating": 2,
        "rating": {
          "count": 65,
          "value": 4.6
        },
        "restaurant_id": "14344720",
        "service_fee": {
          "amount": 399,
          "currency": "USD",
          "value": 3.99
        },
        "state": "NY"
      }
    ],
    "total_hits": 1457,
    "total_pages": 73
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.