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

> Browse and search Postmates restaurants to discover menus, items, and detailed restaurant information all in one place. Get category suggestions, view complete menus, and access specific item details to find exactly what you're looking for.

**Category:** Food & Dining | **Website:** [postmates.com/](https://postmates.com/) | **Docs:** [parse.bot/marketplace/4c9aa124-c853-4f64-a687-504e758cb176/postmates-com-api](https://parse.bot/marketplace/4c9aa124-c853-4f64-a687-504e758cb176/postmates-com-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-postmates-com-api-4c9aa124/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_categories

Returns the top food categories available for browsing, organized by vertical (ALL, RESTAURANTS, SHOP, ALCOHOL). Does not require location context. Categories include their icon URLs and can be used as search terms.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-postmates-com-api-4c9aa124/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_menu_item_details

Returns details for a specific menu item, including price, description, and customization options. Requires the store UUID, section UUID (top-level key from catalogSectionsMap in get_restaurant_menu), and the item UUID (from catalogItems). The subsection UUID is optional but provides better context.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_uuid` | string | Yes | UUID of the menu item (from catalogSectionsMap catalogItems in get_restaurant_menu) |
| `section_uuid` | string | Yes | UUID of the menu section (top-level key from catalogSectionsMap in get_restaurant_menu) |
| `store_uuid` | string | Yes | UUID of the restaurant/store |
| `subsection_uuid` | string | No | UUID of the menu subsection (catalogSectionUUID from get_restaurant_menu). Omitting returns the item without subsection context. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-postmates-com-api-4c9aa124/get_menu_item_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_uuid":"<string>","section_uuid":"<string>","store_uuid":"<string>","subsection_uuid":"<string>"}'
```

### get_restaurant_details

Returns full details for a specific restaurant/store by its UUID, including location, hours, rating, categories, menu sections, and catalog items. The store_uuid can be obtained from search_restaurants or get_restaurant_feed results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `store_uuid` | string | Yes | UUID of the restaurant/store (obtainable from search_restaurants feedItems[*].store.storeUuid or get_restaurant_feed feedItems[*].carousel.stores[*].storeUuid) |

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

### get_restaurant_feed

Returns a location-based feed of restaurants and stores available for delivery. Requires a delivery address to determine nearby options. Returns dining modes, sort/filter options, and a list of feed items including store carousels and regular store listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | No | Delivery address to search near (e.g. '1600 Pennsylvania Ave NW, Washington, DC'). Defaults to Washington DC if not provided. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-postmates-com-api-4c9aa124/get_restaurant_feed \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>"}'
```

### get_restaurant_menu

Returns the complete menu for a restaurant including catalog sections and items. Uses the same underlying API as get_restaurant_details, returning full store data with menu structure in catalogSectionsMap. The store_uuid can be obtained from search_restaurants or get_restaurant_feed results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `store_uuid` | string | Yes | UUID of the restaurant/store (obtainable from search_restaurants feedItems[*].store.storeUuid) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-postmates-com-api-4c9aa124/get_restaurant_menu \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store_uuid":"<string>"}'
```

### get_search_suggestions

Returns autocomplete suggestions as the user types a search query. Includes both store suggestions (with UUIDs) and text/keyword suggestions. Does not require location context.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query text for typeahead suggestions (e.g. 'piz', 'burger') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-postmates-com-api-4c9aa124/get_search_suggestions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### search_restaurants

Search for restaurants, grocery stores, and alcohol shops by keyword. Returns matching stores with ratings, delivery info, and images. Location context is established via the address parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | No | Delivery address for location context (e.g. '1600 Pennsylvania Ave NW, Washington, DC'). Defaults to Washington DC if not provided. |
| `query` | string | Yes | Search keyword (e.g. 'pizza', 'sushi', 'chipotle') |
| `vertical` | string | No | Filter by vertical: ALL, RESTAURANTS, SHOP, ALCOHOL. Filtering is advisory and may include cross-category results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-postmates-com-api-4c9aa124/search_restaurants \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>","query":"<string>","vertical":"<string>"}'
```