Docs / API reference

POST/v1/data/instamart/product

Instamart Product

Return one Swiggy Instamart product with price, stock, rating and pack variants 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.

Instamart Product Endpoint

Return one Swiggy Instamart product with price, stock, rating and pack variants at a delivery location.

Getting Started

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

Run Instamart Product

Send the smallest useful request and read the structured response.

curl -X POST "https://api.datablue.dev/v1/data/instamart/product" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_id": "945DNIVBP4"
}'
Example response
{
  "success": true,
  "source": "instamart",
  "product_id": "945DNIVBP4",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bangalore",
  "city": "Bangalore",
  "latitude": 12.9352,
  "longitude": 77.6245,
  "store_id": "1396284",
  "serviceable": true,
  "captured_at": "2026-11-15T09:41:17.414153Z",
  "time_taken": 4.36,
  "product": {
    "product_id": "CCX1XWR7GN",
    "spin_id": "945DNIVBP4",
    "title": "Nandini Shubham Milk",
    "brand": "Nandini",
    "url": "https://www.swiggy.com/instamart/item/CCX1XWR7GN",
    "unit": "500 ml x 4",
    "price": 128,
    "mrp": 128,
    "price_per_unit": "6.4/100 ml",
    "in_stock": true,
    "availability": "in_stock",
    "cart_allowed_quantity": 1,
    "images": [
      "https://media-assets.swiggy.com/swiggy/image/upload/NI_CATALOG/IMAGES/ciw/2025/12/17/02bfb139-2185-4...",
      "https://media-assets.swiggy.com/swiggy/image/upload/jbgxpzc5wuvvcwyygeln"
    ],
    "category": "Milk",
    "sub_category": "Fresh Milk",
    "super_category": "Dairy, Bread and Eggs",
    "rating": 4.4,
    "rating_count": 131700,
    "short_description": "Fresh milk from Nandini’s trusted dairy network",
    "highlights": [
      "Box Contents: 1 x Milk",
      "Pack Size: 4 x 500 ml"
    ],
    "description": "Nourish your body and soul with Nandini Shubam Milk, the ultimate source of vitality and well-being....",
    "details": [
      {
        "name": "Nutritional Information",
        "value": "Energy: 71\nCarbohydrates: 5.1g\nFat: 4.1g\nProtein: 3.5g"
      }
    ],
    "variants": [
      {
        "spin_id": "945DNIVBP4",
        "unit": "500 ml x 4",
        "price": 128,
        "mrp": 128,
        "in_stock": true
      },
      {
        "spin_id": "RIVPKH8WIP",
        "unit": "500 ml x 2",
        "price": 64,
        "mrp": 64,
        "in_stock": true
      }
    ]
  },
  "credits_used": 1
}

Options

Location and Language

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

curl -X POST "https://api.datablue.dev/v1/data/instamart/product" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_id": "945DNIVBP4",
  "location_key": "blr_koramangala",
  "location": "New York, NY",
  "city": "example",
  "latitude": 40.7128
}'
Example response
{
  "success": true,
  "source": "instamart",
  "product_id": "945DNIVBP4",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bangalore",
  "city": "Bangalore",
  "latitude": 12.9352,
  "longitude": 77.6245,
  "store_id": "1396284",
  "serviceable": true,
  "captured_at": "2026-11-15T09:41:17.414153Z",
  "time_taken": 4.36
}

Request Controls

Set device, timeout, and request-specific controls.

curl -X POST "https://api.datablue.dev/v1/data/instamart/product" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_id": "945DNIVBP4",
  "timeout_ms": 30000
}'
Example response
{
  "success": true,
  "source": "instamart",
  "product_id": "945DNIVBP4",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bangalore",
  "city": "Bangalore",
  "latitude": 12.9352,
  "longitude": 77.6245,
  "store_id": "1396284",
  "serviceable": true,
  "captured_at": "2026-11-15T09:41:17.414153Z",
  "time_taken": 4.36
}

Additional Options

Set endpoint-specific options for this request.

curl -X POST "https://api.datablue.dev/v1/data/instamart/product" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_id": "example"
}'
Example response
{
  "success": true,
  "source": "instamart",
  "product_id": "945DNIVBP4",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bangalore",
  "city": "Bangalore",
  "latitude": 12.9352,
  "longitude": 77.6245,
  "store_id": "1396284",
  "serviceable": true,
  "captured_at": "2026-11-15T09:41:17.414153Z",
  "time_taken": 4.36
}

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
product_id / spin_id / urlstringRequiredspin_id from Instamart Products, an Instamart item ID, or a swiggy.com/instamart/item/<id> URL.
location_keystringOptionalFixed launch location: blr_koramangala, blr_indiranagar, 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
successbooleanFalse when the product or location could not be served.
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.
store_idstringInstamart store that served the request.
productobjectproduct_id, spin_id, title, brand, url, unit, price, mrp, price_per_unit, in_stock, availability, cart_allowed_quantity, images, category, sub_category, super_category, rating, rating_count, short_description, highlights, description, details, and variants.
credits_usednumberCredits charged for this request.
time_takennumberAPI response time in seconds.

Request and response

curl -X POST "https://api.datablue.dev/v1/data/instamart/product" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_id": "945DNIVBP4"
}'
Example response
{
  "success": true,
  "source": "instamart",
  "product_id": "945DNIVBP4",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bangalore",
  "city": "Bangalore",
  "latitude": 12.9352,
  "longitude": 77.6245,
  "store_id": "1396284",
  "serviceable": true,
  "captured_at": "2026-11-15T09:41:17.414153Z",
  "time_taken": 4.36,
  "product": {
    "product_id": "CCX1XWR7GN",
    "spin_id": "945DNIVBP4",
    "title": "Nandini Shubham Milk",
    "brand": "Nandini",
    "url": "https://www.swiggy.com/instamart/item/CCX1XWR7GN",
    "unit": "500 ml x 4",
    "price": 128,
    "mrp": 128,
    "price_per_unit": "6.4/100 ml",
    "in_stock": true,
    "availability": "in_stock",
    "cart_allowed_quantity": 1,
    "images": [
      "https://media-assets.swiggy.com/swiggy/image/upload/NI_CATALOG/IMAGES/ciw/2025/12/17/02bfb139-2185-4...",
      "https://media-assets.swiggy.com/swiggy/image/upload/jbgxpzc5wuvvcwyygeln"
    ],
    "category": "Milk",
    "sub_category": "Fresh Milk",
    "super_category": "Dairy, Bread and Eggs",
    "rating": 4.4,
    "rating_count": 131700,
    "short_description": "Fresh milk from Nandini’s trusted dairy network",
    "highlights": [
      "Box Contents: 1 x Milk",
      "Pack Size: 4 x 500 ml"
    ],
    "description": "Nourish your body and soul with Nandini Shubam Milk, the ultimate source of vitality and well-being....",
    "details": [
      {
        "name": "Nutritional Information",
        "value": "Energy: 71\nCarbohydrates: 5.1g\nFat: 4.1g\nProtein: 3.5g"
      }
    ],
    "variants": [
      {
        "spin_id": "945DNIVBP4",
        "unit": "500 ml x 4",
        "price": 128,
        "mrp": 128,
        "in_stock": true
      },
      {
        "spin_id": "RIVPKH8WIP",
        "unit": "500 ml x 2",
        "price": 64,
        "mrp": 64,
        "in_stock": true
      }
    ]
  },
  "credits_used": 1
}