Flipkart Products Endpoint
Search Flipkart products by keyword or category URL.
Getting Started
Send your API key as a bearer token. Start with the smallest request below.
Run Flipkart Products
Send the smallest useful request and read the structured response.
curl -X POST "https://api.datablue.dev/v1/data/flipkart/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "lipstick",
"num_results": 10,
"page": 1,
"include_product_details": true
}'Example response
{
"success": true,
"source": "flipkart",
"query": "lipstick",
"page": 1,
"pages_fetched": 1,
"requested_count": 10,
"returned_count": 10,
"is_complete": true,
"has_more": true,
"stop_reason": "requested_count_reached",
"time_taken": 1.62,
"products": [
{
"position": 1,
"pid": "LSTEXAMPLE",
"title": "Matte Lipstick",
"url": "https://www.flipkart.com/example/p/itm...",
"price": "₹499",
"price_value": 499,
"original_price": "₹699",
"discount_percent": 29,
"rating": 4.2,
"rating_count": 1240,
"review_count": 156,
"is_sponsored": false
}
]
}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/flipkart/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "web scraping tools",
"num_results": 10,
"page": 1,
"include_product_details": true,
"url": "https://example.com/products/widget"
}'Example response
{
"success": true,
"source": "flipkart",
"query": "lipstick",
"page": 1,
"pages_fetched": 1,
"requested_count": 10,
"returned_count": 10,
"is_complete": true,
"has_more": true,
"stop_reason": "requested_count_reached",
"time_taken": 1.62,
"products": [
{
"position": 1,
"pid": "LSTEXAMPLE",
"title": "Matte Lipstick",
"url": "https://www.flipkart.com/example/p/itm...",
"price": "₹499",
"price_value": 499,
"original_price": "₹699",
"discount_percent": 29,
"rating": 4.2,
"rating_count": 1240
}
]
}Results and Pagination
Control how many records or pages are returned.
curl -X POST "https://api.datablue.dev/v1/data/flipkart/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "lipstick",
"num_results": 20,
"page": 1,
"include_product_details": true,
"page_limit": "automatic"
}'Example response
{
"success": true,
"source": "flipkart",
"query": "lipstick",
"page": 1,
"pages_fetched": 1,
"requested_count": 10,
"returned_count": 10,
"is_complete": true,
"has_more": true,
"stop_reason": "requested_count_reached",
"time_taken": 1.62,
"products": [
{
"position": 1,
"pid": "LSTEXAMPLE",
"title": "Matte Lipstick",
"url": "https://www.flipkart.com/example/p/itm...",
"price": "₹499",
"price_value": 499,
"original_price": "₹699",
"discount_percent": 29,
"rating": 4.2,
"rating_count": 1240
}
]
}Details and Enrichment
Choose the additional detail, related records, or media included in the response.
curl -X POST "https://api.datablue.dev/v1/data/flipkart/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "lipstick",
"num_results": 10,
"page": 1,
"include_product_details": true
}'Example response
{
"success": true,
"source": "flipkart",
"query": "lipstick",
"page": 1,
"pages_fetched": 1,
"requested_count": 10,
"returned_count": 10,
"is_complete": true,
"has_more": true,
"stop_reason": "requested_count_reached",
"time_taken": 1.62,
"products": [
{
"position": 1,
"pid": "LSTEXAMPLE",
"title": "Matte Lipstick",
"url": "https://www.flipkart.com/example/p/itm...",
"price": "₹499",
"price_value": 499,
"original_price": "₹699",
"discount_percent": 29,
"rating": 4.2,
"rating_count": 1240
}
]
}Request Controls
Set device, timeout, and request-specific controls.
curl -X POST "https://api.datablue.dev/v1/data/flipkart/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "lipstick",
"num_results": 10,
"page": 1,
"include_product_details": true,
"timeout_ms": 60000
}'Example response
{
"success": true,
"source": "flipkart",
"query": "lipstick",
"page": 1,
"pages_fetched": 1,
"requested_count": 10,
"returned_count": 10,
"is_complete": true,
"has_more": true,
"stop_reason": "requested_count_reached",
"time_taken": 1.62,
"products": [
{
"position": 1,
"pid": "LSTEXAMPLE",
"title": "Matte Lipstick",
"url": "https://www.flipkart.com/example/p/itm...",
"price": "₹499",
"price_value": 499,
"original_price": "₹699",
"discount_percent": 29,
"rating": 4.2,
"rating_count": 1240
}
]
}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.