Docs / API reference

POST/v1/data/bigbasket/product

BigBasket Product

Return one BigBasket product page at an Indian 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.

BigBasket Product Endpoint

Return one BigBasket product page at an Indian delivery location.

Getting Started

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

Run BigBasket Product

Send the smallest useful request and read the structured response.

curl -X POST "https://api.datablue.dev/v1/data/bigbasket/product" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_id": "40149832",
  "location_key": "blr_koramangala"
}'
Example response
{
  "success": true,
  "source": "bigbasket",
  "product_id": "40149832",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bengaluru",
  "city": "Bengaluru",
  "latitude": 12.9352403,
  "longitude": 77.624532,
  "pincode": "560095",
  "store_id": "18648",
  "serviceable": true,
  "captured_at": "2026-11-15T08:37:32Z",
  "product": {
    "product_id": "40149832",
    "title": "Nandini Pasteurised Toned Milk",
    "brand": "Nandini",
    "is_private_label": false,
    "url": "https://www.bigbasket.com/pd/40149832/nandini-pasteurised-toned-milk-500-ml-pouch/",
    "quantity": "500 ml",
    "pack_description": "Pouch",
    "price": 25.33,
    "mrp": 25.33,
    "unit_price": "5.06 per 100ml",
    "in_stock": true,
    "availability": "in_stock",
    "images": [
      "https://www.bbassets.com/media/uploads/p/l/40149832_2-nandini-pasteurised-toned-milk.jpg"
    ],
    "category": "Bakery, Cakes & Dairy",
    "sub_category": "Fresh Milk",
    "breadcrumbs": [
      "bakery, cakes & dairy",
      "dairy",
      "fresh milk"
    ],
    "description": "Experience the creamy goodness of Nandini Pasteurised Toned Milk...",
    "details": [
      {
        "name": "About the Product",
        "value": "Experience the creamy goodness of Nandini Pasteurised Toned Milk..."
      }
    ],
    "variants": [
      {
        "product_id": "40158264",
        "quantity": "1 L",
        "price": 50.65,
        "mrp": 50.65,
        "in_stock": true,
        "url": "https://www.bigbasket.com/pd/40158264/nandini-pasteurised-toned-milk-1-l-pouch/"
      }
    ],
    "store_id": "18648"
  },
  "time_taken": 2.22,
  "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/bigbasket/product" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_id": "40149832",
  "location_key": "blr_koramangala",
  "location": "New York, NY",
  "latitude": 40.7128
}'
Example response
{
  "success": true,
  "source": "bigbasket",
  "product_id": "40149832",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bengaluru",
  "city": "Bengaluru",
  "latitude": 12.9352403,
  "longitude": 77.624532,
  "pincode": "560095",
  "store_id": "18648",
  "serviceable": true,
  "captured_at": "2026-11-15T08:37:32Z"
}

Request Controls

Set device, timeout, and request-specific controls.

curl -X POST "https://api.datablue.dev/v1/data/bigbasket/product" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_id": "40149832",
  "location_key": "blr_koramangala",
  "timeout_ms": 20000
}'
Example response
{
  "success": true,
  "source": "bigbasket",
  "product_id": "40149832",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bengaluru",
  "city": "Bengaluru",
  "latitude": 12.9352403,
  "longitude": 77.624532,
  "pincode": "560095",
  "store_id": "18648",
  "serviceable": true,
  "captured_at": "2026-11-15T08:37:32Z"
}

Additional Options

Set endpoint-specific options for this request.

curl -X POST "https://api.datablue.dev/v1/data/bigbasket/product" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_id": "example",
  "location_key": "blr_koramangala"
}'
Example response
{
  "success": true,
  "source": "bigbasket",
  "product_id": "40149832",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bengaluru",
  "city": "Bengaluru",
  "latitude": 12.9352403,
  "longitude": 77.624532,
  "pincode": "560095",
  "store_id": "18648",
  "serviceable": true,
  "captured_at": "2026-11-15T08:37:32Z"
}

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 / urlstringRequiredBigBasket product ID, or a bigbasket.com/pd/<id>/<slug>/ URL.
location_keystringOptionalLaunch delivery point: blr_koramangala, mum_andheri_west, or del_lajpat_nagar. Used only when location and coordinates are empty.
locationstringOptionalArea, address, or 6-digit pincode, e.g. "Indiranagar Bengaluru" or "560038". Wins over location_key; the response echoes the resolved coordinates and pincode.
latitude / longitudenumberOptionalExact delivery point. Send both; wins over location.
timeout_msnumberOptionalProvider deadline in milliseconds (3000-60000).

Response fields

FieldTypeDescription
successbooleanFalse when the product is unknown or the location is not serviceable.
pincode / store_id / serviceablestring / string / booleanDelivery pincode, serving store, and whether BigBasket delivers there.
productobjectproduct_id, title, brand, is_private_label, url, quantity, pack_description, price, mrp, discount, unit_price, in_stock, availability, images, category, sub_category, breadcrumbs, description, details[] (name, value), rating, rating_count, review_count, variants[], and store_id.
credits_usednumberCredits charged for this request.
errorstringReason when success is false.
time_takennumberAPI response time in seconds.

Request and response

curl -X POST "https://api.datablue.dev/v1/data/bigbasket/product" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_id": "40149832",
  "location_key": "blr_koramangala"
}'
Example response
{
  "success": true,
  "source": "bigbasket",
  "product_id": "40149832",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bengaluru",
  "city": "Bengaluru",
  "latitude": 12.9352403,
  "longitude": 77.624532,
  "pincode": "560095",
  "store_id": "18648",
  "serviceable": true,
  "captured_at": "2026-11-15T08:37:32Z",
  "product": {
    "product_id": "40149832",
    "title": "Nandini Pasteurised Toned Milk",
    "brand": "Nandini",
    "is_private_label": false,
    "url": "https://www.bigbasket.com/pd/40149832/nandini-pasteurised-toned-milk-500-ml-pouch/",
    "quantity": "500 ml",
    "pack_description": "Pouch",
    "price": 25.33,
    "mrp": 25.33,
    "unit_price": "5.06 per 100ml",
    "in_stock": true,
    "availability": "in_stock",
    "images": [
      "https://www.bbassets.com/media/uploads/p/l/40149832_2-nandini-pasteurised-toned-milk.jpg"
    ],
    "category": "Bakery, Cakes & Dairy",
    "sub_category": "Fresh Milk",
    "breadcrumbs": [
      "bakery, cakes & dairy",
      "dairy",
      "fresh milk"
    ],
    "description": "Experience the creamy goodness of Nandini Pasteurised Toned Milk...",
    "details": [
      {
        "name": "About the Product",
        "value": "Experience the creamy goodness of Nandini Pasteurised Toned Milk..."
      }
    ],
    "variants": [
      {
        "product_id": "40158264",
        "quantity": "1 L",
        "price": 50.65,
        "mrp": 50.65,
        "in_stock": true,
        "url": "https://www.bigbasket.com/pd/40158264/nandini-pasteurised-toned-milk-1-l-pouch/"
      }
    ],
    "store_id": "18648"
  },
  "time_taken": 2.22,
  "credits_used": 1
}