Docs/Zepto Products
Docs / API reference
POST/v1/data/zepto/products
Zepto Products
Search Zepto products and return normalized quick-commerce rows with price, inventory, pack size, category, availability, store context, and rating fields when exposed by the source.
Execution model
Live request
Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.
Credit weight
Live catalog
Current weights are managed from the Data API Weights admin table and shown on pricing before use.
Parameters
| Name | Type | Requirement | Description |
|---|---|---|---|
| query | string | Required | Product search query, e.g. milk, coffee, sunscreen. |
| num_results | number | Optional | Maximum products to return (1-100). |
| page | number | Optional | Starting Zepto result page (1-5). |
| location_key | string | Optional | Fixed launch location. Supported: blr_koramangala, mum_bandra, del_connaught_place. |
| latitude | number | Optional | Custom delivery latitude. Must be sent with longitude. |
| longitude | number | Optional | Custom delivery longitude. Must be sent with latitude. |
| city | string | Optional | Custom city label. Requires latitude and longitude. |
| location | string | Optional | Custom area/address label. Requires latitude and longitude. |
| timeout_ms | number | Optional | Provider timeout in milliseconds (3000-60000). |
Response fields
| Field | Type | Description |
|---|---|---|
| success | boolean | Whether the Zepto request completed successfully. |
| location_key / requested_location | string | Delivery context used for the request. |
| serviceable | boolean | Whether Zepto considers the selected location serviceable. |
| store_id | string | Resolved Zepto store identifier when available. |
| products | array | Product rows with store_product_id, product_id, variant_id, title, brand, category, pack_size, price, original_price, inventory, availability, rating, and rating_count. |
| pages_fetched | number | Number of provider pages fetched. |
| time_taken | number | API response time in seconds. |
Request and response
curl -X POST "https://api.datablue.dev/v1/data/zepto/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "milk",
"location_key": "mum_bandra",
"num_results": 10,
"page": 1
}'Example response
{
"success": true,
"source": "zepto",
"query": "milk",
"location_key": "mum_bandra",
"requested_location": "Bandra, Mumbai",
"city": "Mumbai",
"serviceable": true,
"store_id": "store_123",
"page": 1,
"pages_fetched": 1,
"time_taken": 1.14,
"products": [
{
"position": 1,
"store_product_id": "sp_123",
"product_id": "prod_123",
"variant_id": "var_123",
"title": "Toned Milk",
"brand": "Example Dairy",
"category": "Dairy",
"pack_size": "500 ml",
"price": 28,
"original_price": 30,
"currency": "INR",
"inventory": 8,
"availability": "in_stock"
}
]
}