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

NameTypeRequirementDescription
querystringRequiredProduct search query, e.g. milk, coffee, sunscreen.
num_resultsnumberOptionalMaximum products to return (1-100).
pagenumberOptionalStarting Zepto result page (1-5).
location_keystringOptionalFixed launch location. Supported: blr_koramangala, mum_bandra, del_connaught_place.
latitudenumberOptionalCustom delivery latitude. Must be sent with longitude.
longitudenumberOptionalCustom delivery longitude. Must be sent with latitude.
citystringOptionalCustom city label. Requires latitude and longitude.
locationstringOptionalCustom area/address label. Requires latitude and longitude.
timeout_msnumberOptionalProvider timeout in milliseconds (3000-60000).

Response fields

FieldTypeDescription
successbooleanWhether the Zepto request completed successfully.
location_key / requested_locationstringDelivery context used for the request.
serviceablebooleanWhether Zepto considers the selected location serviceable.
store_idstringResolved Zepto store identifier when available.
productsarrayProduct rows with store_product_id, product_id, variant_id, title, brand, category, pack_size, price, original_price, inventory, availability, rating, and rating_count.
pages_fetchednumberNumber of provider pages fetched.
time_takennumberAPI 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"
    }
  ]
}