# Michelin Guide — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access data from guide.michelin.com.

**Category:** Food & Dining | **Website:** [guide.michelin.com/](https://guide.michelin.com/) | **Docs:** [parse.bot/marketplace/b8b4cb04-0239-4c8d-a7a7-1b3730cb8c28/guide-michelin-com-api](https://parse.bot/marketplace/b8b4cb04-0239-4c8d-a7a7-1b3730cb8c28/guide-michelin-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/michelin-guide/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get cuisine types

Get all available cuisine types and their restaurant counts. Returns a mapping of cuisine slugs to the number of restaurants offering that cuisine. Useful for discovering filter values for list_restaurants.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/michelin-guide/get-cuisine-types \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get restaurant detail

Get full details for a specific restaurant by its slug. Returns comprehensive information including description, contact details, hours of operation, cuisines, facilities, and distinction level. The slug is obtained from search_restaurants or list_restaurants hits.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Restaurant slug as returned in search_restaurants or list_restaurants hits (e.g. 'les-parisiens', 'le-gabriel476630') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/michelin-guide/get-restaurant-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### List articles

Browse Michelin Guide magazine articles. Supports keyword search and pagination. Returns article details including title, excerpt, content, tags, and publication date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Results per page |
| `page` | integer | No | Page number (0-indexed) |
| `query` | string | No | Search keyword to filter articles |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/michelin-guide/list-articles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```

### List countries and regions

Get all countries and regions covered by the Michelin Guide with restaurant counts. Returns two mappings: country slugs to counts and region slugs to counts. Useful for discovering filter values for list_restaurants.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/michelin-guide/list-countries-and-regions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List hotels

Browse Michelin Guide selected hotels. Supports search by keyword and pagination. Returns hotel details including name, location, amenities, distinction level, and booking information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Results per page |
| `page` | integer | No | Page number (0-indexed) |
| `query` | string | No | Search keyword to filter hotels by name or location |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/michelin-guide/list-hotels \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```

### List restaurants

Browse all Michelin Guide restaurants with optional filters for country, city, cuisine, distinction level, and price category. Returns paginated results. Useful for discovering restaurants by geographic or quality criteria without a text search.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City slug (e.g. 'paris', 'tokyo', 'new-york') |
| `country` | string | No | Country slug (e.g. 'fr', 'us', 'jp', 'it', 'de', 'gb', 'es') |
| `cuisine` | string | No | Cuisine slug (e.g. 'creative', 'french', 'japanese', 'modern-cuisine') |
| `distinction` | string | No | Distinction slug: '1-star-michelin', '2-stars-michelin', '3-stars-michelin', 'bib-gourmand', 'the-plate-michelin' |
| `limit` | integer | No | Results per page |
| `page` | integer | No | Page number (0-indexed) |
| `price` | string | No | Price category slug: 'budget', 'mid-range', 'premium', 'luxury' |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/michelin-guide/list-restaurants \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","country":"<string>","cuisine":"<string>","distinction":"<string>","limit":"<integer>","page":"<integer>","price":"<string>"}'
```

### Search restaurants

Full-text search over Michelin Guide restaurants by keyword. Matches against restaurant names, cities, and cuisines. Paginates via zero-indexed page number. Each hit includes name, slug, city, country, distinction, cuisines, price category, and contact details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Results per page |
| `page` | integer | No | Page number (0-indexed) |
| `query` | string | Yes | Search keyword (e.g. city name, restaurant name, cuisine) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/michelin-guide/search-restaurants \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.