# Rappi — 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.

> Search and browse restaurants across Mexico on Rappi by location or keyword, then view detailed menus with prices, ratings, and delivery information. Discover restaurants and products tailored to your area and preferences in one place.

**Category:** Food & Dining | **Website:** [www.rappi.com.mx/](https://www.rappi.com.mx/) | **Docs:** [parse.bot/marketplace/ad7804fa-6f83-4be2-8769-646011581fd9/rappi-com-mx-api](https://parse.bot/marketplace/ad7804fa-6f83-4be2-8769-646011581fd9/rappi-com-mx-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-rappi-com-mx-api-ad7804fa/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_restaurant_details

Get detailed restaurant information including full menu with categories, products, prices, descriptions, ratings, schedule, and promotions. Requires a store_id obtained from search_restaurants or list_restaurants. Returns the complete menu organized by category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `store_id` | string | Yes | Restaurant store ID obtained from search_restaurants or list_restaurants results |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rappi-com-mx-api-ad7804fa/get_restaurant_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store_id":"<string>"}'
```

### list_restaurants

List nearby restaurants by geographic coordinates. Returns restaurants with ratings, delivery times, prices, and availability status. Uses Rappi's catalog API with guest authentication. Results are paginated server-side but this endpoint returns one page of up to limit results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lat` | number | No | Latitude coordinate for the search center |
| `limit` | integer | No | Maximum number of restaurants to return |
| `lng` | number | No | Longitude coordinate for the search center |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rappi-com-mx-api-ad7804fa/list_restaurants \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":"<number>","limit":"<integer>","lng":"<number>"}'
```

### search_restaurants

Full-text search for restaurants and their products by keyword. Returns matching restaurants with product listings including prices and availability. Results are scoped to Mexico City area. Each result carries matched products — use get_restaurant_details for the full menu.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of restaurants to return |
| `query` | string | No | Search keyword for restaurants or products |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rappi-com-mx-api-ad7804fa/search_restaurants \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```