Meesho
India's value marketplace: MRP and selling price kept apart, the reseller shop behind each listing, per-size stock.
/meesho/v1/search1 creditSearch meesho.com by keyword, up to 100 products per call: product code, title, INR price with Meesho's own struck price and discount where it publishes them, the offer line, rating and rating count, images, the product attributes and size/fabric text, free-delivery and express flags, the supplier's state, Meesho Mall status and listing date. Narrow with meesho.com's own filters (colour, price band, rating, discount, fabric, size, category, gender) and sort the way the site does. A no-result query is reported as one instead of returning the unrelated products meesho.com pads it with.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | What to search for on meesho.com, in English (e.g. 'kurti', 'bluetooth earbuds', 'bedsheet double bed'). |
| limit = 20 | optional | 1–100 | Rows per call, 1-100. meesho.com honours every value up to 100 in ONE request. |
| page = 1 | optional | 1–10 | Result page, 1-10. meesho.com pages by cursor, not by number, so a page above 1 is reached by walking the pages here (one upstream call each). Pass the `cursor` from the previous response instead and any depth costs one call. |
| cursor | optional | — | `pagination.cursor` from the previous response — the cheap way to page. Without it a page number re-serves page one. |
| sort = relevance | optional | relevance · newest | Sort order, taken from `sort_options` in `search/filters` for the same query. meesho.com publishes 'relevance' and 'newest' on web search; there is no price sort. |
| filters | optional | — | Filters from meesho.com's own list — 'Color=Beige', 'Price=Under ₹ 199', 'Rating=4.0 And Above', 'Discount=30% And Above', 'Fabric=Cotton', 'Size=M', or a bare value id such as '2322'. Call `search/filters` with the same query for everything that exists for it. A value meesho.com does not know is refused, because it answers one by returning the UNFILTERED set. |
| include_fallback_results = false | optional | — | meesho.com fills a no-result search with unrelated products. Off (default) those rows are withheld and `fallback_results` says so; on, they are returned, still flagged. |
| max_rotations = 3 | optional | 1–6 | How many fresh Indian exits one upstream call may try before giving up. |
/meesho/v1/product/detail2 creditsThe full Meesho product record by product code or URL: title, INR price with the MRP meesho.com publishes and the discount against it, the special-offer breakdown, stock, every size variant with its own price and availability, the reseller shop (name, handle, shop URL, its own rating, rating count and products sold), rating breakdown, image gallery, the structured attribute table, description, category breadcrumb, delivery estimate and cash-on-delivery flag, and the return options with their prices.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_id | required | — | The Meesho product code — the short code in the URL (meesho.com/<slug>/p/**hs4ysq**), which every search row returns as `product_id`. A full product URL is accepted too. |
| max_rotations = 3 | optional | 1–6 | How many fresh Indian exits one upstream call may try before giving up. |
/meesho/v1/product/reviews1 creditA product's ratings and reviews as meesho.com serves them: the 1-5 star breakdown, the average, the rating and review counts, and the review rows with star rating, text, date, helpful count, the reviewer display name meesho.com shows and any photos attached. Pages with the cursor the response returns.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_id | required | — | The Meesho product code — the short code in the URL (meesho.com/<slug>/p/**hs4ysq**), which every search row returns as `product_id`. A full product URL is accepted too. |
| cursor | optional | — | `pagination.cursor` from the previous response — the cheap way to page. Without it a page number re-serves page one. |
| max_rotations = 3 | optional | 1–6 | How many fresh Indian exits one upstream call may try before giving up. |
/meesho/v1/category/browse2 creditsBrowse a meesho.com category page: the same product rows as search plus the struck price, which this listing publishes somewhat more often, together with the category's own title, description, breadcrumb and lowest price. Take the category from `categories`.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| category | required | — | A category page from `categories` — its `url` (https://www.meesho.com/sarees/pl/3iy) or the 'slug/pl/page_id' pair. The slug and the page id must be the pair meesho.com publishes; a mismatched slug is redirected and refused. |
| limit = 20 | optional | 1–20 | Rows to return, 1-20. A meesho.com category page server-renders ONE page of about 20 products; this trims that page, it does not fetch more. |
| max_rotations = 3 | optional | 1–6 | How many fresh Indian exits one upstream call may try before giving up. |
/meesho/v1/categoriesfreeMeesho's whole browsable taxonomy, three levels deep, each node carrying the slug and page id that `category/browse` takes, plus the shortcut links the site puts in its own navigation.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| max_rotations = 3 | optional | 1–6 | How many fresh Indian exits one upstream call may try before giving up. |
/meesho/v1/search/filtersfreeThe filters and sort orders meesho.com itself offers for a query — colour, price band, rating, discount, fabric, size, category, gender and whatever else that query exposes, with every value it accepts. These are the only values `search` will send: meesho.com answers an unknown filter by returning the unfiltered set.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | What to search for on meesho.com, in English (e.g. 'kurti', 'bluetooth earbuds', 'bedsheet double bed'). |
| max_rotations = 3 | optional | 1–6 | How many fresh Indian exits one upstream call may try before giving up. |
/meesho/v1/search/suggestfreeMeesho's own search-box completions for a partial keyword, plus the searches it is currently promoting as popular.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | A partial keyword to complete, as typed into Meesho's search box. |
| max_rotations = 3 | optional | 1–6 | How many fresh Indian exits one upstream call may try before giving up. |
curl -X POST https://api.reefapi.com/meesho/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"kurti","limit":20}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}