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.
runtime	string	Current runtime path, usually http_decoded_protocol.
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.

cURL Example

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
}'

System Responses

200 OK

Request processed successfully.

401 UNAUTHORIZED

Missing or invalid API key.

429 RATE LIMIT

System capacity exceeded.

500 SYSTEM FAILURE

Internal core exception.

EXAMPLE RESPONSE

{
  "success": true,
  "source": "zepto",
  "runtime": "http_decoded_protocol",
  "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"
    }
  ]
}