Docs / API reference

POST/v1/data/flipkart/products

Flipkart Products

Search Flipkart products by keyword or direct search/category URL. Returns normalized product rows with price, discount, rating, review count, specifications, availability, and sponsored flag.

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.

Parameters

NameTypeRequirementDescription
querystringOptionalProduct search query. Required unless url is supplied.
url / startUrlstringOptionalDirect Flipkart search/category URL. Required unless query is supplied.
num_results / results_wanted / resultsWantednumberOptionalMaximum products to return (1-100).
pagenumberOptionalStarting Flipkart result page (1-20).
timeout_msnumberOptionalProvider timeout in milliseconds (3000-60000).

Response fields

FieldTypeDescription
successbooleanWhether the Flipkart request completed successfully.
productsarrayProduct rows with pid, title, URL, image, price, original price, discount, rating, rating_count, review_count, specs, warranty, availability, and sponsored flag.
pages_fetchednumberNumber of pages fetched.
time_takennumberAPI response time in seconds.

Request and 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
}'
Example response
{
  "success": true,
  "source": "flipkart",
  "query": "lipstick",
  "page": 1,
  "pages_fetched": 1,
  "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
    }
  ]
}