Docs / API reference

POST/v1/data/bigbasket/products

BigBasket Products

Search BigBasket, or list a category, 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 Products Endpoint

Search BigBasket, or list a category, at an Indian delivery location.

Getting Started

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

Run BigBasket Products

Send the smallest useful request and read the structured response.

curl -X POST "https://api.datablue.dev/v1/data/bigbasket/products" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "milk",
  "location_key": "blr_koramangala",
  "num_results": 2
}'
Example response
{
  "success": true,
  "source": "bigbasket",
  "query": "milk",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bengaluru",
  "city": "Bengaluru",
  "latitude": 12.9352403,
  "longitude": 77.624532,
  "pincode": "560095",
  "store_id": "18648",
  "serviceable": true,
  "page": 1,
  "pages_fetched": 1,
  "total_results": 220,
  "has_more": true,
  "stop_reason": "max_pages_reached",
  "products": [
    {
      "platform": "bigbasket",
      "position": 1,
      "search_query": "milk",
      "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/",
      "image_url": "https://www.bbassets.com/media/uploads/p/l/40149832_2-nandini-pasteurised-toned-milk.jpg",
      "price": 25.33,
      "mrp": 25.33,
      "currency": "INR",
      "quantity": "500 ml",
      "pack_size": "500 ml",
      "pack_description": "Pouch",
      "unit_price": "5.06 per 100ml",
      "category": "Dairy",
      "sub_category": "Fresh Milk",
      "in_stock": true,
      "availability": "in_stock",
      "delivery_time": "5 mins",
      "is_sponsored": false,
      "store_id": "18648",
      "captured_at": "2026-11-15T08:37:30Z"
    },
    {
      "platform": "bigbasket",
      "position": 2,
      "search_query": "milk",
      "product_id": "40128919",
      "title": "Example Dairy Cow Milk",
      "brand": "Example Dairy",
      "is_private_label": false,
      "url": "https://www.bigbasket.com/pd/40128919/example-dairy-cow-milk-1-l/",
      "price": 68,
      "mrp": 72,
      "discount": "5% OFF",
      "discount_percentage": 5.56,
      "currency": "INR",
      "quantity": "1 L",
      "pack_size": "1 L",
      "offer_label": "5% OFF",
      "category": "Dairy",
      "sub_category": "Fresh Milk",
      "in_stock": true,
      "availability": "in_stock",
      "delivery_time": "5 mins",
      "is_sponsored": true,
      "store_id": "18648",
      "captured_at": "2026-11-15T08:37:30Z"
    }
  ],
  "time_taken": 2.54,
  "credits_used": 1
}

Options

Query and Target

Set the search term, identifier, or source URL that defines the request.

curl -X POST "https://api.datablue.dev/v1/data/bigbasket/products" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "web scraping tools",
  "location_key": "blr_koramangala",
  "num_results": 2,
  "queries": [
    "milk",
    "bread"
  ],
  "category": "example"
}'
Example response
{
  "success": true,
  "source": "bigbasket",
  "query": "milk",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bengaluru",
  "city": "Bengaluru",
  "latitude": 12.9352403,
  "longitude": 77.624532,
  "pincode": "560095",
  "store_id": "18648",
  "serviceable": true,
  "page": 1
}

Results and Pagination

Control how many records or pages are returned.

curl -X POST "https://api.datablue.dev/v1/data/bigbasket/products" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "milk",
  "location_key": "blr_koramangala",
  "num_results": 20,
  "max_pages": 10,
  "page": 1
}'
Example response
{
  "success": true,
  "source": "bigbasket",
  "query": "milk",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bengaluru",
  "city": "Bengaluru",
  "latitude": 12.9352403,
  "longitude": 77.624532,
  "pincode": "560095",
  "store_id": "18648",
  "serviceable": true,
  "page": 1
}

Location and Language

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

curl -X POST "https://api.datablue.dev/v1/data/bigbasket/products" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "milk",
  "location_key": "blr_koramangala",
  "num_results": 2,
  "location": "New York, NY",
  "latitude": 40.7128
}'
Example response
{
  "success": true,
  "source": "bigbasket",
  "query": "milk",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bengaluru",
  "city": "Bengaluru",
  "latitude": 12.9352403,
  "longitude": 77.624532,
  "pincode": "560095",
  "store_id": "18648",
  "serviceable": true,
  "page": 1
}

Filters and Sorting

Narrow or order the returned records.

curl -X POST "https://api.datablue.dev/v1/data/bigbasket/products" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "milk",
  "location_key": "blr_koramangala",
  "num_results": 2,
  "sort": "example"
}'
Example response
{
  "success": true,
  "source": "bigbasket",
  "query": "milk",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bengaluru",
  "city": "Bengaluru",
  "latitude": 12.9352403,
  "longitude": 77.624532,
  "pincode": "560095",
  "store_id": "18648",
  "serviceable": true,
  "page": 1
}

Request Controls

Set device, timeout, and request-specific controls.

curl -X POST "https://api.datablue.dev/v1/data/bigbasket/products" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "milk",
  "location_key": "blr_koramangala",
  "num_results": 2,
  "timeout_ms": 20000
}'
Example response
{
  "success": true,
  "source": "bigbasket",
  "query": "milk",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bengaluru",
  "city": "Bengaluru",
  "latitude": 12.9352403,
  "longitude": 77.624532,
  "pincode": "560095",
  "store_id": "18648",
  "serviceable": true,
  "page": 1
}

Additional Options

Set endpoint-specific options for this request.

curl -X POST "https://api.datablue.dev/v1/data/bigbasket/products" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "milk",
  "location_key": "blr_koramangala",
  "num_results": 2,
  "search_url": "example"
}'
Example response
{
  "success": true,
  "source": "bigbasket",
  "query": "milk",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bengaluru",
  "city": "Bengaluru",
  "latitude": 12.9352403,
  "longitude": 77.624532,
  "pincode": "560095",
  "store_id": "18648",
  "serviceable": true,
  "page": 1
}

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
querystringOptionalProduct search query. Send this, queries, search_url, or category.
queriesstring[]OptionalUp to 25 search queries, each searched at the same location.
search_urlstringOptionalA bigbasket.com/ps/?q=... search URL; the query is read from it.
categorystringOptionalBrowse a category instead of searching: a slug such as fresh-milk, or a bigbasket.com/pc/... URL.
num_resultsnumberOptionalMaximum products to return per query (1-500).
max_pagesnumberOptionalPages to read per query (1-25, 20 products each). Sets num_results when num_results is omitted.
pagenumberOptionalFirst BigBasket result page to read (1-25).
sortstringOptionalrelevance (default), pricelth (price low to high), pricehtl (price high to low), dphtl (discount high to low), dahtl, or dalth.
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 location is not serviceable or no products were found.
serviceablebooleanWhether BigBasket delivers to this location.
latitude / longitude / pincodenumber / stringDelivery point and pincode BigBasket resolved.
store_idstringBigBasket service area that served the rows.
total_results / pages_fetchednumberMatches BigBasket reports, and pages read.
has_more / stop_reasonboolean | null / stringWhether more results exist, and why paging stopped: max_pages_reached, no_more_results, not_serviceable, or error.
productsarrayRows with position, search_query, product_id, title, brand, is_private_label, price, mrp, discount, discount_percentage, quantity, pack_description, unit_price, ean_code, category, sub_category, in_stock, availability, delivery_time, is_sponsored, rating, rating_count, store_id, images, url, and captured_at. Fields BigBasket does not show are omitted.
query_resultsarrayWith queries: per-query success, result_count, pages_fetched, has_more, stop_reason, and error.
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/products" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "milk",
  "location_key": "blr_koramangala",
  "num_results": 2
}'
Example response
{
  "success": true,
  "source": "bigbasket",
  "query": "milk",
  "location_key": "blr_koramangala",
  "requested_location": "Koramangala Bengaluru",
  "city": "Bengaluru",
  "latitude": 12.9352403,
  "longitude": 77.624532,
  "pincode": "560095",
  "store_id": "18648",
  "serviceable": true,
  "page": 1,
  "pages_fetched": 1,
  "total_results": 220,
  "has_more": true,
  "stop_reason": "max_pages_reached",
  "products": [
    {
      "platform": "bigbasket",
      "position": 1,
      "search_query": "milk",
      "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/",
      "image_url": "https://www.bbassets.com/media/uploads/p/l/40149832_2-nandini-pasteurised-toned-milk.jpg",
      "price": 25.33,
      "mrp": 25.33,
      "currency": "INR",
      "quantity": "500 ml",
      "pack_size": "500 ml",
      "pack_description": "Pouch",
      "unit_price": "5.06 per 100ml",
      "category": "Dairy",
      "sub_category": "Fresh Milk",
      "in_stock": true,
      "availability": "in_stock",
      "delivery_time": "5 mins",
      "is_sponsored": false,
      "store_id": "18648",
      "captured_at": "2026-11-15T08:37:30Z"
    },
    {
      "platform": "bigbasket",
      "position": 2,
      "search_query": "milk",
      "product_id": "40128919",
      "title": "Example Dairy Cow Milk",
      "brand": "Example Dairy",
      "is_private_label": false,
      "url": "https://www.bigbasket.com/pd/40128919/example-dairy-cow-milk-1-l/",
      "price": 68,
      "mrp": 72,
      "discount": "5% OFF",
      "discount_percentage": 5.56,
      "currency": "INR",
      "quantity": "1 L",
      "pack_size": "1 L",
      "offer_label": "5% OFF",
      "category": "Dairy",
      "sub_category": "Fresh Milk",
      "in_stock": true,
      "availability": "in_stock",
      "delivery_time": "5 mins",
      "is_sponsored": true,
      "store_id": "18648",
      "captured_at": "2026-11-15T08:37:30Z"
    }
  ],
  "time_taken": 2.54,
  "credits_used": 1
}