# Talabat — 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 restaurant details, menus, reviews, and cuisines from the Talabat food delivery platform, plus search across available restaurants and delivery areas. Browse complete restaurant information including dishes, ratings, and cuisine types all in one place.

**Category:** Food & Dining | **Website:** [talabat.com/](https://talabat.com/) | **Docs:** [parse.bot/marketplace/bf5d3595-8925-4ac8-a779-c4e31442b1f7/talabat-com-api](https://parse.bot/marketplace/bf5d3595-8925-4ac8-a779-c4e31442b1f7/talabat-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-talabat-com-api-bf5d3595/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_areas

Retrieves all delivery areas supported on Talabat UAE. Each area includes an id, name, and URL slug.

**Estimated cost:** Metered

_No parameters required._

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

### get_cuisines

Retrieves all unique cuisine types found across restaurants on Talabat UAE. Returns a sorted array of cuisine name strings extracted from restaurant listings.

**Estimated cost:** Metered

_No parameters required._

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

### get_grocery_product_details

Retrieves full details for a specific grocery product identified by its SKU within a category. Returns name, description, price, images, stock, and raw attributes. Use the SKU from get_grocery_products results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `area_id` | string | Yes | Numeric area ID (e.g. '1473') |
| `branch_id` | string | Yes | Branch ID of the grocery store (e.g. '799798') |
| `branch_slug` | string | Yes | URL slug of the grocery store branch (e.g. 'adcoop-powered-by-talabat-al-khalidiyah') |
| `category_slug` | string | Yes | Category slug the product belongs to (e.g. 'fruit-veg') |
| `sku` | string | Yes | Product SKU from get_grocery_products results (e.g. '538947') |
| `sub_category_slug` | string | No | Sub-category slug for the product (e.g. 'fresh-fruit') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-talabat-com-api-bf5d3595/get_grocery_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_id":"<string>","branch_id":"<string>","branch_slug":"<string>","category_slug":"<string>","sku":"<string>","sub_category_slug":"<string>"}'
```

### get_grocery_products

Retrieves products available at a specific grocery store filtered by category. Each product includes id, title, price, image, SKU, and stock info. Use category_slug from get_grocery_store_details categories.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `area_id` | string | Yes | Numeric area ID (e.g. '1473') |
| `branch_id` | string | Yes | Branch ID of the grocery store (e.g. '799798') |
| `branch_slug` | string | Yes | URL slug of the grocery store branch (e.g. 'adcoop-powered-by-talabat-al-khalidiyah') |
| `category_slug` | string | Yes | Category slug from get_grocery_store_details categories (e.g. 'fruit-veg') |
| `sub_category_slug` | string | No | Sub-category slug for finer filtering (e.g. 'fresh-fruit'). Omitting returns all products in the category. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-talabat-com-api-bf5d3595/get_grocery_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_id":"<string>","branch_id":"<string>","branch_slug":"<string>","category_slug":"<string>","sub_category_slug":"<string>"}'
```

### get_grocery_store_details

Retrieves detailed information for a specific grocery store including name, logo, rating, delivery info, and product categories with subcategories. Use branch_id and branch_slug from get_grocery_stores results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `area_id` | string | Yes | Numeric area ID the store is in (e.g. '1473') |
| `branch_id` | string | Yes | Branch ID of the grocery store from get_grocery_stores (e.g. '799798') |
| `branch_slug` | string | Yes | URL slug of the grocery store branch from get_grocery_stores (e.g. 'adcoop-powered-by-talabat-al-khalidiyah') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-talabat-com-api-bf5d3595/get_grocery_store_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_id":"<string>","branch_id":"<string>","branch_slug":"<string>"}'
```

### get_grocery_stores

Retrieves grocery stores available in a specific delivery area on Talabat UAE. Each store includes id, name, logo, branch slug, cuisines, rating, delivery time, and minimum order. Results are scoped to one area identified by area_id and area_slug from get_areas.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `area_id` | string | Yes | Numeric area ID from get_areas (e.g. '1473') |
| `area_slug` | string | Yes | URL slug of the area from get_areas (e.g. 'breakwater') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-talabat-com-api-bf5d3595/get_grocery_stores \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_id":"<string>","area_slug":"<string>"}'
```

### get_restaurant_details

Retrieves detailed information for a specific restaurant identified by its URL slug. Returns rating, cuisines, delivery info, popular menu items, and a description template. The vendor_id in the response is used as branch_id for the reviews endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The restaurant URL slug from get_restaurants or search_restaurants results |

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

### get_restaurant_reviews

Retrieves paginated customer reviews for a specific restaurant branch. Use the vendor_id from get_restaurant_details as the branch_id parameter. Each page returns up to 4 reviews with reviewer name, rating, date, and text.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `branch_id` | string | Yes | The vendor_id/branch ID of the restaurant, obtained from get_restaurant_details response vendor_id field |
| `page` | integer | No | Page number for pagination |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-talabat-com-api-bf5d3595/get_restaurant_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"branch_id":"<string>","page":"<integer>"}'
```

### get_restaurants

Retrieves the full list of restaurants available on Talabat UAE. Each restaurant includes its id, name, logo URL, URL slug, and a comma-separated cuisines string. The list is not paginated; a single request returns all restaurants.

**Estimated cost:** Metered

_No parameters required._

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

### search_grocery_products

Searches grocery products by keyword across multiple stores in a delivery area. Iterates through stores in the area (capped by max_stores), checks categories whose names match the query first for efficiency, and returns products whose title contains the query. Each result includes product details and the store it belongs to.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `area_id` | string | Yes | Numeric area ID from get_areas (e.g. '1473') |
| `area_slug` | string | Yes | URL slug of the area from get_areas (e.g. 'breakwater') |
| `max_stores` | integer | No | Maximum number of stores to search across (1-5). Higher values return more results but take longer. |
| `query` | string | Yes | Keyword to search for in product titles (case-insensitive partial match) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-talabat-com-api-bf5d3595/search_grocery_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_id":"<string>","area_slug":"<string>","max_stores":"<integer>","query":"<string>"}'
```

### search_restaurants

Searches restaurants by keyword, matching against restaurant name and cuisine fields. Returns filtered results from the full UAE restaurant list. Case-insensitive partial matching is used.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Keyword to search for in restaurant names and cuisines |

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