Hydra Feed
The Hydra feed provides our partners - like you - with a listing of restaurants in the Grubhub system. With these listings, you can match up restaurant information with the restaurant IDs that we use to pull information using our restaurants endpoints.
This feed is delivered ZIP-compressed as either an XML or JSON file.
To use this feed, you'll need to call the affiliate-feed.grubhub.com/v2/{brand}/affiliate_network_feed/latest/{format}, where {brand} is the Grubhub/Seamless brand for which to pull from, and {format} is eiter XML or JSON. Please note that the XML feed is deprecated; we recommend that you use the JSON feed whenever possible.
To access the feed, you must include your Hydra user name and password in the headers of the request. It should look like this:
x-hydra-auth: testuser|1ae3014c37e26ee563ae70f06cfd8bd27eb2f251648bbf8dc7b32c8cfa7ca080
Get the restaurant feed.
GET /affiliate-feed.grubhub.com/v2/{brand}/affiliate_network_feed/latest/{format}Description
Returns a ZIP-compressed feed of restaurant information as either XML or JSON, depending on the format specified.
Path Parameters
brand
labelRequired
String
The brand for which to pull restaurant information. This must be `grubhub` or `seamless` to pull from those brands, or `primary_brand` to pull from whichever brand is most popular in a given area.
format
labelRequired
String
Specifies the delivery format of the restaurant feed. This must either be `xml` or `json`.
Responses
200
OK - the body of this response will contain a ZIP file named `affiliate_premium.{xml | json}`
Address
A full street address broken into its constituent parts.
Properties
locality
label_outlineOptional
String
The city, town, or other locality in which this address is located.
region
label_outlineOptional
String
The state, county, or other larger region in which this address is located.
postal_code
label_outlineOptional
String
The ZIP Code or Postcode of the address.
street_address
label_outlineOptional
String
The house number and street name portion of the address.
country
label_outlineOptional
String
The country in which this address is located.
Restaurants
A single restaurant within the affiliate feed.
Properties
id
label_outlineOptional
Integer
A unique number that identifies this restaurant within the Grubhub API.
name
label_outlineOptional
String
The displayed name of the restaurant.
address
label_outlineOptional
The full street address of the restaurant.
latitude
label_outlineOptional
String
The latitude coordinate of this restaurant.
longitude
label_outlineOptional
String
The longitude coordinate of this restaurant.
url
label_outlineOptional
URL
The Grubhub URL to access this URL using your affiliate information.
phone_number_for_delivery
label_outlineOptional
String
The phone number to call in order to order delivery.