Flipkart Products

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

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

Name	Type	Requirement	Description
query	string	optional	Product search query. Required unless url is supplied.
url / startUrl	string	optional	Direct Flipkart search/category URL. Required unless query is supplied.
num_results / results_wanted / resultsWanted	number	optional	Maximum products to return (1-100).
page	number	optional	Starting Flipkart result page (1-20).
timeout_ms	number	optional	Provider timeout in milliseconds (3000-60000).

Response Fields

Field	Type	Description
success	boolean	Whether the Flipkart request completed successfully.
runtime	string	Runtime path, usually http_html_candidate.
classification	string	HTTP page quality classification.
products	array	Product rows with pid, title, URL, image, price, original price, discount, rating, rating_count, review_count, specs, warranty, availability, and sponsored flag.
search_url	string	Flipkart URL used.
pages_fetched	number	Number of pages fetched.
time_taken	number	API response time in seconds.

cURL Example

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
}'

System Responses

200 OK

Request processed successfully.

401 UNAUTHORIZED

Missing or invalid API key.

429 RATE LIMIT

System capacity exceeded.

500 SYSTEM FAILURE

Internal core exception.

EXAMPLE RESPONSE

{
  "success": true,
  "source": "flipkart",
  "runtime": "http_html_candidate",
  "query": "lipstick",
  "page": 1,
  "pages_fetched": 1,
  "time_taken": 1.62,
  "classification": "products",
  "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
    }
  ]
}