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
}'{
"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"
}'{
"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
}'{
"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
}'{
"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"
}'{
"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
}'{
"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"
}'{
"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.
