Docs / API reference

POST/v1/data/zepto/autocomplete

Zepto Autocomplete

Return Zepto search suggestions for partial text at a delivery location.

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.

Zepto Autocomplete Endpoint

Return Zepto search suggestions for partial text at a delivery location.

Getting Started

Send your API key as a bearer token. Start with the smallest request below.

Run Zepto Autocomplete

Send the smallest useful request and read the structured response.

curl -X POST "https://api.datablue.dev/v1/data/zepto/autocomplete" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prefix": "mil"
}'
Example response
{
  "success": true,
  "source": "zepto",
  "prefix": "mil",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bangalore",
  "city": "Bangalore",
  "latitude": 12.9352,
  "longitude": 77.6245,
  "store_id": "5ec071fd-78df-41f6-b3ae-7298d9f96a3d",
  "serviceable": true,
  "captured_at": "2026-11-15T08:58:53.192781Z",
  "time_taken": 0.07,
  "count": 10,
  "suggestions": [
    {
      "position": 1,
      "keyword": "Milk",
      "type": "search_autosuggestion",
      "image_url": "https://cdn.zeptonow.com/production/inventory/banner/714b6953-fe94-4792-9f9a-934fad660fc5.png"
    },
    {
      "position": 2,
      "keyword": "Milkybar chocolates",
      "type": "search_autosuggestion",
      "image_url": "https://cdn.zeptonow.com/production/inventory/product/8230f481-b7f5-48cb-8406-d1498c88471d-1RGBdwMWq..."
    }
  ],
  "credits_used": 1
}

Options

Results and Pagination

Control how many records or pages are returned.

curl -X POST "https://api.datablue.dev/v1/data/zepto/autocomplete" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prefix": "mil",
  "limit": 10
}'
Example response
{
  "success": true,
  "source": "zepto",
  "prefix": "mil",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bangalore",
  "city": "Bangalore",
  "latitude": 12.9352,
  "longitude": 77.6245,
  "store_id": "5ec071fd-78df-41f6-b3ae-7298d9f96a3d",
  "serviceable": true,
  "captured_at": "2026-11-15T08:58:53.192781Z",
  "time_taken": 0.07
}

Location and Language

Localize results with country, language, coordinates, or delivery-location fields.

curl -X POST "https://api.datablue.dev/v1/data/zepto/autocomplete" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prefix": "mil",
  "location_key": "blr_koramangala",
  "location": "New York, NY",
  "city": "example",
  "latitude": 40.7128
}'
Example response
{
  "success": true,
  "source": "zepto",
  "prefix": "mil",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bangalore",
  "city": "Bangalore",
  "latitude": 12.9352,
  "longitude": 77.6245,
  "store_id": "5ec071fd-78df-41f6-b3ae-7298d9f96a3d",
  "serviceable": true,
  "captured_at": "2026-11-15T08:58:53.192781Z",
  "time_taken": 0.07
}

Request Controls

Set device, timeout, and request-specific controls.

curl -X POST "https://api.datablue.dev/v1/data/zepto/autocomplete" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prefix": "mil",
  "timeout_ms": 20000
}'
Example response
{
  "success": true,
  "source": "zepto",
  "prefix": "mil",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bangalore",
  "city": "Bangalore",
  "latitude": 12.9352,
  "longitude": 77.6245,
  "store_id": "5ec071fd-78df-41f6-b3ae-7298d9f96a3d",
  "serviceable": true,
  "captured_at": "2026-11-15T08:58:53.192781Z",
  "time_taken": 0.07
}

Additional Options

Set endpoint-specific options for this request.

curl -X POST "https://api.datablue.dev/v1/data/zepto/autocomplete" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prefix": "example"
}'
Example response
{
  "success": true,
  "source": "zepto",
  "prefix": "mil",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bangalore",
  "city": "Bangalore",
  "latitude": 12.9352,
  "longitude": 77.6245,
  "store_id": "5ec071fd-78df-41f6-b3ae-7298d9f96a3d",
  "serviceable": true,
  "captured_at": "2026-11-15T08:58:53.192781Z",
  "time_taken": 0.07
}

Response

Read success first, then consume the endpoint-specific records and pagination fields shown below.

Error Handling

Handle 401 for authentication, 422 for invalid input, 429 for limits, and retry only transient failures.

Parameters

NameTypeRequirementDescription
prefixstringRequiredPartial search text (1-100 characters).
limitnumberOptionalMaximum suggestions to return (1-20).
location_keystringOptionalFixed launch location: blr_koramangala, mum_bandra, del_connaught_place. Used only when location, city and coordinates are empty.
locationstringOptionalArea name, address or 6-digit pincode, e.g. Koramangala or 560034. Wins over location_key; unknown areas return an error, never a default area.
citystringOptionalOptional city that narrows location. A city alone returns HTTP 422 with example areas.
latitude / longitudenumberOptionalExact delivery point. Send both; wins over location.
timeout_msnumberOptionalProvider deadline in milliseconds (3000-60000).

Response fields

FieldTypeDescription
successbooleanWhether suggestions were returned.
suggestionsarrayRows with position, keyword, type, and image_url when the source shows one.
countnumberSuggestions returned.
serviceableboolean | nulltrue when a store serves the location, false when it is outside the delivery area, null when the lookup did not answer.
location_key / requested_location / city / latitude / longitudestring | numberThe delivery location that was used.
credits_usednumberCredits charged for this request.
time_takennumberAPI response time in seconds.

Request and response

curl -X POST "https://api.datablue.dev/v1/data/zepto/autocomplete" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prefix": "mil"
}'
Example response
{
  "success": true,
  "source": "zepto",
  "prefix": "mil",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bangalore",
  "city": "Bangalore",
  "latitude": 12.9352,
  "longitude": 77.6245,
  "store_id": "5ec071fd-78df-41f6-b3ae-7298d9f96a3d",
  "serviceable": true,
  "captured_at": "2026-11-15T08:58:53.192781Z",
  "time_taken": 0.07,
  "count": 10,
  "suggestions": [
    {
      "position": 1,
      "keyword": "Milk",
      "type": "search_autosuggestion",
      "image_url": "https://cdn.zeptonow.com/production/inventory/banner/714b6953-fe94-4792-9f9a-934fad660fc5.png"
    },
    {
      "position": 2,
      "keyword": "Milkybar chocolates",
      "type": "search_autosuggestion",
      "image_url": "https://cdn.zeptonow.com/production/inventory/product/8230f481-b7f5-48cb-8406-d1498c88471d-1RGBdwMWq..."
    }
  ],
  "credits_used": 1
}