# Zepto — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 product and delivery data from Zepto, India's quick-commerce grocery platform. Search product listings with prices, discounts, and stock status; browse categories; set a delivery pincode to check serviceability; retrieve full product details by variant ID; and fetch real-time delivery ETA estimates.

**Category:** Food & Dining | **Website:** [zepto.com/](https://zepto.com/) | **Docs:** [parse.bot/marketplace/17775393-0b5a-4f9d-8266-c4c1c0b9670c/zepto-com-api](https://parse.bot/marketplace/17775393-0b5a-4f9d-8266-c4c1c0b9670c/zepto-com-api)

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/zepto/`
**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 categories

Fetch all top-level product categories available on Zepto for the configured delivery location. Returns category ID, name, image path, and deeplink URL for each category. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

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

### Get delivery eta

Retrieve current delivery ETA estimates for the configured delivery location. Returns estimated delivery time in minutes and deliverability status. The location defaults to Bangalore; use set_delivery_location to change it.

**Estimated cost:** Metered

_No parameters required._

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

### Get product details

Retrieve full details for a specific product by its product variant ID (pvid). Extracts data from the product page including pricing, stock status, brand, pack size, and images. The pvid is a UUID obtainable from search_products results under products[*].pvid.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `pvid` | string | Yes | Product variant ID in UUID format (from search_products results products[*].pvid) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/zepto/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"pvid":"<string>"}'
```

### Search products

Full-text search over Zepto's grocery product catalog for a configured store location. Returns product details including name, brand, pricing (MRP and discounted selling price), stock availability, category, and images. Results are paginated by page number (0-indexed). Without pincode, searches the default Bangalore store (1 upstream request). With pincode, resolves the delivery location first and searches that store (4 upstream requests). Use set_delivery_location to change the persistent default store.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (0-indexed) |
| `pincode` | string | No | Indian 6-digit pincode to search products at a specific delivery location (e.g. '400001' for Mumbai). When omitted, uses the default Bangalore store. |
| `query` | string | Yes | Search keyword (e.g. 'milk', 'bread', 'chips') |

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

### Set delivery location

Set or validate a delivery location by Indian pincode. Resolves the pincode to geographic coordinates via Google Places autocomplete, identifies the nearest Zepto store, and returns serviceability status. Updates the internal store context used by subsequent search and category calls.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `pincode` | string | Yes | Indian 6-digit pincode (e.g. '400001' for Mumbai, '560001' for Bangalore, '110001' for Delhi) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/zepto/set-delivery-location \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"pincode":"<string>"}'
```

## Next steps

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