Skip to main content
POST /v1/data/instamart/products/run Pricing: $0.001 per product ($1.00 per 1,000). Search by query, browse a category and sub-category, or fetch one or more specific product URLs.

Ways to call it

  • Search: set query (optional: city, pincode, store_id, lat, lon, maxResults)
  • Category: set category, sub_category (optional: city, pincode, store_id, lat, lon, maxResults)
  • Brand: set brand (optional: city, pincode, store_id, lat, lon, maxResults)
  • URL: set urls (optional: city, pincode, store_id, lat, lon)

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
What to search for (e.g. milk, chocolate).
string
Top-level category (e.g. Cold Drinks & Juices).36 allowed values, for example Atta, Rice and Dal, Baby Care, Bath and Body, Biscuits and Cakes, Cereals and Breakfast, Chips and Namkeens, Chocolates, Cleaners and Repellents, Cold Drinks and Juices, Dairy, Bread and Eggs. Fetch the full list with GET /v1/data/instamart/products?expand=options.
string
Sub-category within it (e.g. Soft Drinks).526 allowed values, for example Atta, Basmati Rice, Besan, Sooji and Maida, High Protein Atta, Millets & Daliya, Other Flours, Poha & Puffed Rice, Premium Brands, Rajma, Chola and Others, Ready to Cook Flour Mix. Fetch the full list with GET /v1/data/instamart/products?expand=options.
string
Brand as spelled on Instamart. Pick from the list. The brand’s URL slug is accepted too.4846 allowed values, for example &Circus (&circus), 1000 Farms (1000-farms), 10on, 10on10foods, 1868 BY TATA Tea (1868-by-tata-tea), 1950 Origins (1950-origins), 1st Step (1st-step), 24 Mantra (24-mantra), 24BITES (24bites), 28 BLACK (28-black). Fetch the full list with GET /v1/data/instamart/products?expand=options.
string[]
One or more product page URLs (one per line).
string
Dark store - pick a city and pincode first.1197 allowed values, for example 1386719 (1386719 (110002, New Delhi)), 1261842 (1261842 (110003, New Delhi)), 1383851 (1383851 (110003, New Delhi)), 1403207 (1403207 (110005, New Delhi)), 1404594 (1404594 (110007, New Delhi)), 1402776 (1402776 (110007, New Delhi)), 1381835 (1381835 (110008, New Delhi)), 816651 (816651 (110009, New Delhi)), 1325203 (1325203 (110009, New Delhi)), 1229997 (1229997 (110012, New Delhi)). Fetch the full list with GET /v1/data/instamart/products?expand=options.
number
Or target by coordinates: latitude (use with longitude).Min -90; max 90; use together with lon.
number
Or target by coordinates: longitude (use with latitude).Min -180; max 180; use together with lat.
string
City - filters the pincode and store lists.145 allowed values, for example New Delhi, Faridabad, Gurugram, Rohtak, Sonipat, Karnal, Panipat, Ambala, Panchkula, Kurukshetra. Fetch the full list with GET /v1/data/instamart/products?expand=options.
string
Pincode - pick a city first; filters the store list.816 allowed values, for example 110002 (110002 (New Delhi)), 110003 (110003 (New Delhi)), 110005 (110005 (New Delhi)), 110007 (110007 (New Delhi)), 110008 (110008 (New Delhi)), 110009 (110009 (New Delhi)), 110012 (110012 (New Delhi)), 110014 (110014 (New Delhi)), 110015 (110015 (New Delhi)), 110016 (110016 (New Delhi)). Fetch the full list with GET /v1/data/instamart/products?expand=options.
integer
How many products to return. Use 0 for all.

Example

Response fields

Each row in data is one product, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
Same record shape as blinkit/products and zepto/products, so the three can be compared row for row.