# Flipkart API

> Flipkart returns product listings, prices, ratings, offers, and details as a workflow and API.

Flipkart's Search products method returns listings from a keyword, with optional price range and sort order. Get product returns available product details from a name or link, with an optional PIN code for delivery estimates.

- Page: https://fous.com/tools/flipkart
- Handle: `@flipkart`
- Category: [Commerce](https://fous.com/tools/category/commerce)
- Source website: https://flipkart.com
- Last verified: Sep 29, 2026

## Methods

### Get product

Operation `get_product`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get a Flipkart product’s price, offers, seller, ratings, specifications, images and delivery estimate from its name or link. Delivery estimates depend on location and may be unavailable for some PIN codes.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `product` | string | yes | `"Samsung Galaxy S25"` | Product name or Flipkart product link, for example Samsung Galaxy S25. |
| `pin_code` | string | no | `"560001"` | Indian delivery PIN code, for example 560001. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "product"
  ],
  "properties": {
    "product": {
      "type": "string",
      "description": "Product name or Flipkart product link, for example Samsung Galaxy S25.",
      "examples": [
        "Samsung Galaxy S25",
        "https://www.flipkart.com/samsung-galaxy-s25-5g-snapdragon-silver-shadow-128-gb/p/itm957543a944c80?pid=MOBHQDMKYG8JCE4R",
        "Apple iPhone 15"
      ]
    },
    "pin_code": {
      "type": "string",
      "default": "",
      "description": "Indian delivery PIN code, for example 560001.",
      "examples": [
        "560001"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "product": "Samsung Galaxy S25",
      "pin_code": "560001"
    },
    {
      "product": "https://www.flipkart.com/samsung-galaxy-s25-5g-snapdragon-silver-shadow-128-gb/p/itm957543a944c80?pid=MOBHQDMKYG8JCE4R"
    },
    {
      "product": "Apple iPhone 15"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `offers` | array |  |  |
| `in_stock` | boolean | `true` |  |
| `price_inr` | number | `69999` |  |
| `highlights` | array |  |  |
| `image_links` | array |  |  |
| `seller_name` | string or null | `"Truenet Commerce"` |  |
| `star_rating` | number or null | `4.6` |  |
| `product_link` | string | `"https://www.flipkart.com/samsung-galaxy-s25-5g-snapdragon-silver-shadow-128-gb/p/itm957543a944c80?pid=MOBHQDMKYG8JCE4R"` |  |
| `product_name` | string | `"Samsung Galaxy S25 5G Snapdragon (Silver Shadow, 128 GB)"` |  |
| `seller_rating` | number or null | `4.5` |  |
| `specifications` | array |  |  |
| `specifications[].name` | string | `"Battery Capacity"` |  |
| `specifications[].value` | string | `"4000 mAh"` |  |
| `discount_percent` | integer or null | `33` |  |
| `delivery_estimate` | string or null | `"Delivery by Friday, 2 Oct"` |  |
| `number_of_ratings` | integer or null | `6704` |  |
| `number_of_reviews` | integer or null | `964` |  |
| `original_price_inr` | number or null | `104999` |  |
| `flipkart_product_id` | string or null | `"MOBHQDMKYG8JCE4R"` |  |

**Example input**

```json
{
  "product": "Samsung Galaxy S25",
  "pin_code": "560001"
}
```

**Example output**

```json
{
  "offers": [
    "Exchange offer: Up to ₹42,750 (Not available at this Pincode)",
    "Bank offers: ₹3,500 off",
    "EMI: ₹11,666 x 6m • Pay ₹69,999 • No Cost EMI"
  ],
  "in_stock": true,
  "price_inr": 69999,
  "highlights": [
    "12 GB RAM | 128 GB ROM",
    "8 Elite for Galaxy | Octa Core Processor | 4.47 GHz Clock Speed",
    "50MP + 10MP + 12MP Rear Camera"
  ],
  "image_links": [
    "https://rukmini1.flixcart.com/image/1500/1500/xif0q/mobile/w/u/u/-original-imahrkzh2m2rfyy4.jpeg?q=70",
    "https://rukmini1.flixcart.com/image/1500/1500/xif0q/mobile/o/m/n/-original-imahrkfukc2vhwpz.jpeg?q=70",
    "https://rukmini1.flixcart.com/image/1500/1500/xif0q/mobile/z/r/y/-original-imahrkfuhzdcuv7u.jpeg?q=70"
  ],
  "seller_name": "Truenet Commerce",
  "star_rating": 4.6,
  "product_link": "https://www.flipkart.com/samsung-galaxy-s25-5g-snapdragon-silver-shadow-128-gb/p/itm957543a944c80?pid=MOBHQDMKYG8JCE4R",
  "product_name": "Samsung Galaxy S25 5G Snapdragon (Silver Shadow, 128 GB)",
  "seller_rating": 4.5,
  "specifications": [
    {
      "name": "Battery Capacity",
      "value": "4000 mAh"
    },
    {
      "name": "Battery Type",
      "value": "Lithium Ion"
    },
    {
      "name": "Dual Battery",
      "value": "No"
    }
  ],
  "discount_percent": 33,
  "delivery_estimate": "Delivery by Friday, 2 Oct",
  "number_of_ratings": 6704,
  "number_of_reviews": 964,
  "original_price_inr": 104999,
  "flipkart_product_id": "MOBHQDMKYG8JCE4R"
}
```

### Search products

Operation `search_products`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Search Flipkart products by keyword, optional price range, and sort order. Returns current listings in site order; product details may be unavailable for some listings.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `sort` | string | no | `"price_low_to_high"` | Listing order, for example price_low_to_high. |
| `query` | string | yes | `"boAt earbuds"` | Product search words, for example boAt earbuds. |
| `max_price` | number or null | no | `2000` | Maximum listed price in rupees, for example 2000. |
| `min_price` | number or null | no | `500` | Minimum listed price in rupees, for example 500. |
| `max_results` | integer | no | `60` | Maximum number of products to return, for example 20. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "sort": {
      "enum": [
        "relevance",
        "price_low_to_high",
        "price_high_to_low",
        "newest"
      ],
      "type": "string",
      "default": "relevance",
      "description": "Listing order, for example price_low_to_high.",
      "examples": [
        "price_low_to_high"
      ]
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Product search words, for example boAt earbuds.",
      "examples": [
        "boAt earbuds",
        "iPhone 15"
      ]
    },
    "max_price": {
      "type": [
        "number",
        "null"
      ],
      "default": null,
      "minimum": 0,
      "description": "Maximum listed price in rupees, for example 2000.",
      "examples": [
        2000
      ]
    },
    "min_price": {
      "type": [
        "number",
        "null"
      ],
      "default": null,
      "minimum": 0,
      "description": "Minimum listed price in rupees, for example 500.",
      "examples": [
        500
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 60,
      "minimum": 1,
      "description": "Maximum number of products to return, for example 20.",
      "x-fous-developer": true,
      "examples": [
        60,
        5
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "query": "boAt earbuds"
    },
    {
      "sort": "price_low_to_high",
      "query": "boAt earbuds",
      "max_price": 2000,
      "min_price": 500,
      "max_results": 60
    },
    {
      "query": "iPhone 15",
      "max_results": 5
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `products` | array |  | Products in Flipkart listing order. |
| `products[].price` | number | `699` | Current price in Indian rupees. |
| `products[].currency` | string | `"INR"` | Currency for the prices. |
| `products[].photo_link` | string or null | `"https://rukminim2.flixcart.com/image/612/612/xif0q/headphone/k/k/r/-original-imaha9pgxwpfewtb.jpeg?q=70"` | Product image link, when shown. |
| `products[].star_rating` | number or null | `4.1` | Star rating out of five, when shown. |
| `products[].product_link` | string | `"https://www.flipkart.com/mivi-duopods-b1-just-launched-45hrs-playtime-ai-enc-hd-call-fast-charging-5-3-bluetooth/p/itmb` | Flipkart product page link. |
| `products[].product_name` | string | `"Mivi Duopods B1 (Just Launched)45Hrs Playtime, AI ENC for HD Call, Fast Charging, 5.3 Bluetooth"` | Full product name. |
| `products[].original_price` | number or null | `2999` | Original price in Indian rupees, when shown. |
| `products[].discount_percent` | number or null | `76` | Displayed discount percentage, when shown. |
| `products[].flipkart_assured` | boolean | `true` | Whether the listing shows the Flipkart Assured badge. |
| `products[].number_of_ratings` | integer or null | `71808` | Number of customer ratings, when shown. |
| `products[].flipkart_product_id` | string | `"ACCH8Z35ZAJSR9CU"` | Flipkart product identifier. |

**Example input**

```json
{
  "query": "boAt earbuds"
}
```

**Example output**

```json
{
  "products": [
    {
      "price": 699,
      "currency": "INR",
      "photo_link": "https://rukminim2.flixcart.com/image/612/612/xif0q/headphone/k/k/r/-original-imaha9pgxwpfewtb.jpeg?q=70",
      "star_rating": 4.1,
      "product_link": "https://www.flipkart.com/mivi-duopods-b1-just-launched-45hrs-playtime-ai-enc-hd-call-fast-charging-5-3-bluetooth/p/itmb88189abeb525?pid=ACCH8Z35ZAJSR9CU",
      "product_name": "Mivi Duopods B1 (Just Launched)45Hrs Playtime, AI ENC for HD Call, Fast Charging, 5.3 Bluetooth",
      "original_price": 2999,
      "discount_percent": 76,
      "flipkart_assured": true,
      "number_of_ratings": 71808,
      "flipkart_product_id": "ACCH8Z35ZAJSR9CU"
    },
    {
      "price": 599,
      "currency": "INR",
      "photo_link": "https://rukminim2.flixcart.com/image/612/612/xif0q/headphone/p/h/f/-original-imagpxh2rengq8re.jpeg?q=70",
      "star_rating": 3.9,
      "product_link": "https://www.flipkart.com/mivi-duopods-k2-40hrs-pt-hd-call-fast-charging-50ms-latency-ipx4-voice-asst-5-3v-bluetooth/p/itmabd533764a913?pid=ACCGPFCNAYFWRE9E",
      "product_name": "Mivi Duopods K2, 40Hrs PT, HD Call, Fast Charging, 50ms Latency,IPX4, Voice Asst.5.3v Bluetooth",
      "original_price": 2999,
      "discount_percent": 80,
      "flipkart_assured": true,
      "number_of_ratings": 128899,
      "flipkart_product_id": "ACCGPFCNAYFWRE9E"
    }
  ]
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@flipkart",
  "visibility": "public",
  "operation": "get_product",
  "version": 1,
  "input": {
    "product": "Samsung Galaxy S25",
    "pin_code": "560001"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@flipkart\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_product\",\n  \"version\": 1,\n  \"input\": {\n    \"product\": \"Samsung Galaxy S25\",\n    \"pin_code\": \"560001\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@flipkart",
  "visibility": "public",
  "operation": "get_product",
  "version": 1,
  "input": {
    "product": "Samsung Galaxy S25",
    "pin_code": "560001"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/flipkart`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_product`: Get product. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `search_products`: Search products. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-flipkart https://api.fous.com/mcp/tools/flipkart --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Compare prices across product listings
- Find products within a price range
- Review product ratings and reviews
- Check seller details, offers, and stock
- Estimate delivery using a PIN code

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Flipkart tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Flipkart account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from flipkart.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

### What products match a keyword and price range?

Search products returns listings for a keyword, with optional minimum and maximum prices and sort order.

### What is a product's current price and seller?

Get product returns available price, seller, offers, ratings, and other details for a product name or link.

### Can I check a product's delivery estimate?

Get product can return a delivery estimate when you provide an Indian PIN code; estimates may be unavailable for some PIN codes.

## Related

- [Walmart API](https://fous.com/tools/walmart.md): Walmart helps shoppers find products from Walmart and marketplace sellers, view details, prices, ratings and reviews; availability uses Walmart’s default location, not ZIP codes.
- [Best Buy API](https://fous.com/tools/best-buy.md): Best Buy returns US electronics and appliance listings, prices, deals, specifications, images, reviews, and nearby store pickup and shipping details; prices and availability can change by location and before checkout.
- [Amazon API](https://fous.com/tools/amazon.md): Amazon returns publicly shown product listings, prices, details, ratings, reviews, current best sellers, and Today's Deals; availability and content vary by store, location, and access.
- [AliExpress API](https://fous.com/tools/aliexpress.md): AliExpress returns product listings and selected product details, including prices, variants, reviews, and destination-specific shipping options shown for the displayed variant.
- [Kohl's API](https://fous.com/tools/kohls.md): Shop products and deals on Kohl's.
- [Google Shopping API](https://fous.com/tools/google-shopping.md): Google Shopping shows product offers, prices, ratings, delivery and store links; results vary by country and listings, totals need shown shipping, and typical ranges may be missing.
- [Nordstrom API](https://fous.com/tools/nordstrom.md): Search clothing, shoes, and beauty products at Nordstrom.
- [Newegg API](https://fous.com/tools/newegg.md): Newegg provides US computer and electronics listings, with product details and selected public offers whose prices, availability, stock, and shipping can change or may not be displayed.
- [All Commerce tools](https://fous.com/tools/category/commerce)