Flipkart category
A category or browse listing on Flipkart (India): the products of a category page with title, price, MRP, discount, rating, ratings and reviews counts, stock, Flipkart Assured flag, key specs and images, with the category's sort options and breadcrumbs. Pass next_page back as page; it is null on the last page (Flipkart shows at most 25 pages). Filter with brand, rating_min, discount_min, assured, in_stock and filters; facets lists every filter of the page with its values, counts and the filter string to pass back.
Every response includes credits_used: the credits this call cost.
Parameters
| name | type | description |
|---|---|---|
urlrequired | string | A flipkart.com category page URL, e.g. https://www.flipkart.com/mobiles/pr?sid=tyy,4io (sid works in place of url). Example: https://www.flipkart.com/mobiles/pr?sid=tyy,4io |
page | integer | Page number. Pass next_page from the previous response; next_page is null on the last page. |
sort | relevance | popularity | price_asc | price_desc | recency_desc | price_asc / price_desc: by price; recency_desc: newest first. |
min_price | integer | Lowest price, whole rupees (INR). |
max_price | integer | Highest price, whole rupees (INR). |
brand | string | Brand names to keep, comma-separated, e.g. Samsung,Apple. |
rating_min | 3 | 4 | 4 (4 stars and above) or 3 (3 stars and above). |
discount_min | string | Lowest discount in percent: 10, 20, 30, 40, 50 … 90. |
assured | true | false | true: Flipkart Assured products only. |
in_stock | true | false | true: leave out products that are out of stock. |
filters | string | Any other filters of the page, as listed in facets[].values[].filter, e.g. facets.ram[]=8 GB and Above; several separated by ;. |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/flipkart/v1/category?url=https%3A%2F%2Fwww.flipkart.com%2Fmobiles%2Fpr%3Fsid%3Dtyy%2C4io" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/flipkart/v1/category",
params={"url": "https://www.flipkart.com/mobiles/pr?sid=tyy,4io"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/flipkart/v1/category");
url.searchParams.set("url", "https://www.flipkart.com/mobiles/pr?sid=tyy,4io");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).