guide.michelin.com APIguide.michelin.com ↗
Access Michelin Guide restaurant listings, star ratings, Bib Gourmand awards, hotel data, and editorial articles via 7 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/70808de2-3170-4ee9-8819-d781d6b15701/search_restaurants?query=paris' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for Michelin Guide restaurants by keyword. Returns paginated results matching the query against restaurant names, cities, and cuisines.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (0-indexed) |
| limit | integer | Results per page |
| queryrequired | string | Search keyword (e.g. city name, restaurant name, cuisine) |
{
"type": "object",
"fields": {
"hits": "array of restaurant objects with name, slug, city, country, distinction, cuisines, and other details",
"page": "integer current page number",
"nbHits": "integer total number of matching restaurants",
"nbPages": "integer total number of pages"
},
"sample": {
"data": {
"hits": [
{
"city": {
"name": "Paris",
"slug": "paris"
},
"name": "Les Parisiens",
"slug": "les-parisiens",
"country": {
"name": "France",
"slug": "fr"
},
"cuisines": [
{
"slug": "traditional-cuisine",
"label": "Traditional Cuisine"
}
],
"distinction": {
"slug": "the-plate-michelin",
"label": "Selected: Good cooking"
}
}
],
"page": 0,
"nbHits": 1500,
"nbPages": 75
},
"status": "success"
}
}About the guide.michelin.com API
The Michelin Guide API gives programmatic access to the full Guide Michelin dataset across 7 endpoints, covering starred restaurants, Bib Gourmand listings, selected hotels, and editorial articles. The list_restaurants endpoint lets you filter by country, city, cuisine, price tier, and distinction level — returning fields like distinction, cuisines, slug, and nbHits — while get_restaurant_detail returns contact details, opening hours, facilities, and the restaurant's full description.
Restaurant Search and Browsing
The search_restaurants endpoint accepts a free-text query parameter matched against restaurant names, cities, and cuisines, returning paginated hits arrays with name, slug, city, country, distinction, and cuisines fields alongside nbHits and nbPages for pagination control. The list_restaurants endpoint exposes the same result shape but with structured filter parameters: distinction accepts slugs like 1-star-michelin, 2-stars-michelin, 3-stars-michelin, and bib-gourmand; cuisine accepts slugs like french or japanese; and price accepts slugs like budget or luxury. Both endpoints are 0-indexed via the page parameter.
Restaurant Detail
get_restaurant_detail takes a slug obtained from either listing endpoint and returns a richer record: main_desc (full editorial description), phone, website, facilities (array of facility objects), cuisines (array with label and slug), and a distinction object with both a human-readable label and its slug. Passing an unrecognised slug returns a stale_input error rather than an empty result.
Hotels and Editorial Content
list_hotels returns Michelin-selected hotels with name, slug, city, country, and amenities fields, filterable by keyword via the query parameter. list_articles similarly surfaces Guide Michelin magazine content — each hit includes title, slug, excerpt, content, tags, and published_date.
Reference Lookups
Two reference endpoints require no inputs. get_cuisine_types returns a flat object mapping each cuisine slug to an integer restaurant count, useful for building filter UIs. list_countries_and_regions returns two sub-objects — countries and regions — each mapping slugs to restaurant counts, showing the full geographic scope of the Guide's current coverage.
- Build a starred-restaurant finder that filters by
distinctionslug and city to surface Michelin-starred options in a specific destination. - Populate a travel app's dining section with Bib Gourmand listings using the
bib-gourmanddistinction filter onlist_restaurants. - Create a cuisine-type breakdown dashboard using the
get_cuisine_typesresponse to visualise restaurant distribution by category. - Aggregate
websiteandphonecontact data fromget_restaurant_detailfor a hospitality CRM or reservation tool. - Monitor geographic coverage gaps by diffing
list_countries_and_regionsresults over time to track when new markets are added. - Index Michelin editorial
contentandtagsfromlist_articlesto enrich a food media recommendation engine. - Filter Michelin-selected hotels by location keyword using
list_hotelsto supplement a luxury travel itinerary builder.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Michelin Guide have an official developer API?+
How do I retrieve only three-star Michelin restaurants in a specific country?+
list_restaurants with distinction set to 3-stars-michelin and country set to the relevant country slug (e.g. fr for France or jp for Japan). The response includes nbHits so you can determine whether to paginate using the page parameter.Does the API return user reviews or ratings for restaurants?+
distinction object with label and slug), the main_desc editorial description from get_restaurant_detail, and structured metadata like cuisines and facilities. You can fork this API on Parse and revise it to add an endpoint targeting any review-adjacent data the Guide surfaces publicly.Does the API cover opening hours or reservation links?+
get_restaurant_detail response, and reservation links are not exposed. The endpoint does return website and phone for contact purposes. You can fork this API on Parse and revise it to add those fields if the source exposes them.How complete is the geographic coverage across the listing endpoints?+
list_countries_and_regions endpoint returns the full set of covered country and region slugs with restaurant counts, so you can check current scope before building country-specific features. Markets not yet covered by the Guide will not appear in those results.