Flipkart Minutes Products Endpoint
Search or browse Flipkart Minutes products for one Indian delivery pincode.
Getting Started
Send your API key as a bearer token. Start with the smallest request below.
Search a Pincode
Send a product query and a 6-digit pincode.
curl -X POST "https://api.datablue.dev/v1/data/flipkart/minutes/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "milk",
"pincode": "560034",
"num_results": 2
}'{
"success": true,
"source": "flipkart_minutes",
"query": "milk",
"pincode": "560034",
"latitude": 12.9254325,
"longitude": 77.6313785,
"serviceable": true,
"store_id": "ben_017_wh_hl_01",
"delivery_eta_minutes": 8,
"total_results": 122,
"returned_count": 2,
"pages_fetched": 1
}Several Queries
Batch of Queries
Send up to 10 terms in queries. Each is searched at the same location; rows carry search_query and query_results reports each term.
curl -X POST "https://api.datablue.dev/v1/data/flipkart/minutes/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"queries": [
"milk",
"bread"
],
"pincode": "560034",
"num_results": 2
}'{
"success": true,
"source": "flipkart_minutes",
"query": "milk",
"queries": [
"milk",
"bread"
],
"query_count": 2,
"pincode": "560034",
"serviceable": true,
"store_id": "ben_017_wh_hl_01",
"delivery_eta_minutes": 8,
"returned_count": 4,
"pages_fetched": 2,
"has_more": true,
"query_results": [
{
"query": "milk",
"success": true,
"result_count": 2,
"pages_fetched": 1,
"has_more": true,
"stop_reason": "max_pages_reached"
},
{
"query": "bread",
"success": true,
"result_count": 2,
"pages_fetched": 1,
"has_more": true,
"stop_reason": "max_pages_reached"
}
],
"products": [
{
"position": 1,
"search_query": "milk",
"page_number": 1,
"product_id": "MLKEXAMPLE000001",
"title": "Example Dairy Cow Milk",
"price": 46,
"in_stock": true
},
{
"position": 1,
"search_query": "bread",
"page_number": 1,
"product_id": "BRDEXAMPLE000001",
"title": "Example Bakery Sandwich Bread",
"price": 45,
"in_stock": true
}
],
"time_taken": 3.8,
"credits_used": 2
}Browse a Category
Category ID or URL
Set category_id to a Minutes sid such as hloc/0081/0806, or pass the category page URL. Do not send query with it.
curl -X POST "https://api.datablue.dev/v1/data/flipkart/minutes/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"category_id": "hloc/0081/0806",
"pincode": "560034",
"num_results": 2
}'{
"success": true,
"source": "flipkart_minutes",
"query": "category:hloc/0081/0806",
"pincode": "560034",
"serviceable": true,
"store_id": "ben_017_wh_hl_01",
"delivery_eta_minutes": 8,
"total_results": 457,
"returned_count": 2,
"pages_fetched": 1,
"has_more": true,
"stop_reason": "max_pages_reached",
"products": [
{
"position": 1,
"page_number": 1,
"product_id": "SWTEXAMPLE000001",
"title": "Example Sweets Kaju Katli",
"price": 249,
"sponsored": true,
"in_stock": true
},
{
"position": 2,
"page_number": 1,
"product_id": "SWTEXAMPLE000002",
"title": "Example Sweets Rasgulla",
"price": 120,
"sponsored": false,
"in_stock": true
}
],
"time_taken": 2.4,
"credits_used": 1
}More Pages
Read Several Pages
Set max_pages (1-5) and raise num_results (up to 200). Each page holds up to 40 products; has_more tells you whether Flipkart had more.
curl -X POST "https://api.datablue.dev/v1/data/flipkart/minutes/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"category_id": "hloc/0081/0806",
"pincode": "560034",
"num_results": 45,
"max_pages": 2
}'{
"success": true,
"source": "flipkart_minutes",
"query": "category:hloc/0081/0806",
"pincode": "560034",
"serviceable": true,
"total_results": 457,
"returned_count": 45,
"pages_fetched": 2,
"has_more": true,
"stop_reason": "max_pages_reached",
"products": [
{
"position": 45,
"page_number": 2,
"product_id": "SWTEXAMPLE000045",
"title": "Example Sweets Soan Papdi",
"price": 99,
"in_stock": true
}
],
"time_taken": 3.7,
"credits_used": 2
}Exact Delivery Point
Latitude and Longitude
Set latitude and longitude together to search from an exact point. Assortment and prices can change inside a pincode.
curl -X POST "https://api.datablue.dev/v1/data/flipkart/minutes/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "milk",
"pincode": "560034",
"latitude": 12.9352,
"longitude": 77.6245,
"num_results": 2
}'{
"success": true,
"source": "flipkart_minutes",
"query": "milk",
"pincode": "560034",
"latitude": 12.9254325,
"longitude": 77.6313785,
"serviceable": true,
"store_id": "ben_017_wh_hl_01",
"delivery_eta_minutes": 8,
"total_results": 122,
"returned_count": 2,
"pages_fetched": 1
}Timeout
Set a Deadline
Set timeout_ms to limit the total wait (3000-60000). The default is 30000.
curl -X POST "https://api.datablue.dev/v1/data/flipkart/minutes/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "milk",
"pincode": "560034",
"num_results": 2,
"timeout_ms": 15000
}'{
"success": true,
"source": "flipkart_minutes",
"query": "milk",
"pincode": "560034",
"latitude": 12.9254325,
"longitude": 77.6313785,
"serviceable": true,
"store_id": "ben_017_wh_hl_01",
"delivery_eta_minutes": 8,
"total_results": 122,
"returned_count": 2,
"pages_fetched": 1
}Unserved Locations
Location Not Served
Check serviceable. Unserved locations return success: false and are not charged.
curl -X POST "https://api.datablue.dev/v1/data/flipkart/minutes/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "milk",
"pincode": "175131"
}'{
"success": false,
"source": "flipkart_minutes",
"query": "milk",
"pincode": "175131",
"latitude": 32.2470694,
"longitude": 77.1825135,
"serviceable": false,
"returned_count": 0,
"products": [],
"time_taken": 1.1,
"error": "Flipkart Minutes does not deliver to this location."
}Response
Read success first, then use only the fields requested by your operation.
Error Handling
Handle 401 for authentication, 422 for invalid input, 429 for limits, and retry only transient failures.
