Before we can query for restaurant booking, we need to load static information
about restaurant locations into our databases. The catalog should be updated
daily to ensure that we always have the most up to date data possible.
Provided static data will be used to match restaurant locations against our
catalog. Please note that new locations will not appear on KAYAK until an import
and mapping has been completed.
Technical details
We accept multiple data exchange formats. The preferred option is to use an
already existing provider static data API or a scheduled dump of static data.
In both cases we will extract all useful data and ensure that the maximum number
of restaurant locations will be available for search. UTF-8 character encoding
should be used for text fields.
We strongly discourage manual data preparation as it leads to poor quality data.
Static data must be accessible online, here are the transfer methods we support:
- HTTP, HTTPS
- FTP, FTPS
- Amazon S3
- SSH, SFTP
If provider has no API and is about to implement one to cover our needs, here is
the standard preferred format:
sample.json
[
{
"_comment_": "Main content should always be English",
"name": "Bob's Burgers",
"description": "Wow, this is quite an interesting description about my really great restaurant!",
"cuisine": "Comfort food",
"address1": "57 Main Street",
"address2": "Suite 1",
"city": "Villagetown",
"_comment_": "State also falls under region",
"region": "MA",
"country": "US",
"postalCode": "12345",
"latitude": 42.460105,
"longitude": -71.390874,
"phone1": "+1 123-456-7890",
},
{
"name": "The Shoreline Cafe",
"cuisine": "Brunch",
"address1": "13 South Avenue",
"city": "Boston",
"region": "MA",
"country": "US",
"postalCode": "02115",
"latitude": 42.460105,
"longitude": -71.390874,
"phone1": "+1 123-456-7890",
}
]
Note: if you choose to dump your full catalog into a single file, please compress it.
Attention: we have no support for spreadsheets (XLS, XLSX, CSV, TSC, etc.) nor do we plan to implement it.
Required Fields for Integration
- Restaurant Name (clean)
- No city
- No prices
- No star rating
- No headlines
- Types of Cuisine / Primary Food Types
- Location info (as separate fields):
- Phone number (with country calling code)
Attention: if we receive low quality restaurant location data and we are unable to match it
against our catalog, such properties will not appear in search results.
Optional Fields
- Restaurant Description (in English)
- Reservation policies
- Food types
- Seating options
- Alcoholic beverages
- Year opened / renovated
- Dining Style
- Dress Code
- Executive Chef
- Payment Types Accepted
- Rating Information
- Ambiance Score
- Food Score
- Noise Score
- Service Score
- Aggregate Score
- Number of ratings
- Price Range (formatted as: $20-60)
- Restaurant Website URL
- Restaurant Image URLs (following the image requirements)
- Restaurant Keywords
Hotel Image Requirements
Effective as of July 16, 2018
The following guidelines should be strictly adhered to when providing restaurant images.
Quality is measured by not only the size of the image but by the variety of the content as well.
Image Files
- Landscape orientation (4:6 aspect ratio) - 1200x800 pixels recommended, 720x480 pixels minimum
- Portrait orientation (6:4 aspect ratio) - 800x1200 pixels recommended, 480x720 pixels minimum
- File types: JPG, PNG, GIF
- Photos must be under 25MB each
- No borders
- No watermarks, copyright logos, or text
Image Content & Metadata
- Keep your content looking fresh. Include images of all the restaurant features including reception,
seating, the bar, ambiance, exterior, lounges, food, and drinks. We strive to tell a consistent, high-quality story for each property listed on KAYAK.
- Captions or tags are important for determining the order in which restaurant images will be displayed.
- Types of images to avoid:
- Images including people. The restaurant should always be the primary focus of the image
- Maps
- Offensive images