# Search local products Search local Minutes listings with observed prices, stock and bounded pagination. Recommendations may accompany keyword matches. - Platform: [Flipkart Minutes](https://docs.upscrape.com/docs/platforms/flipkart-minutes) - Capability ID: `flipkart-minutes.products.search` - Cost: 8 credits per request - Maximum runtime: 180 seconds - Execute endpoint: `POST https://data.upscrape.com/execute` ## Request Use the exact public capability ID in the shared execute envelope. ```bash curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "input": { "city": "Bengaluru", "latitude": 12.9352403, "longitude": 77.624532, "max_pages": 2, "neighbourhood": "Koramangala", "pincode": "560034", "query": "milk", "state": "Karnataka" }, "capability": "flipkart-minutes.products.search" }' ``` ## Input | Field | Type | Required | Description | | --- | --- | --- | --- | | `city` | `string` | Yes | City name. | | `latitude` | `number` | Yes | Latitude in decimal degrees. From -90 to 90. | | `limit` | `integer` | No | Maximum number of results to return. From 1 to 500. Default: `100`. | | `longitude` | `number` | Yes | Longitude in decimal degrees. From -180 to 180. | | `max_pages` | `integer` | No | Maximum number of result pages to fetch. From 1 to 6. Default: `1`. | | `neighbourhood` | `string` | Yes | | | `pincode` | `string` | Yes | Postal code (PIN) that sets the delivery location. | | `query` | `string` | Yes | Search query. | | `state` | `string` | Yes | State or region name. | ### Example input ```json { "city": "Bengaluru", "latitude": 12.9352403, "longitude": 77.624532, "max_pages": 2, "neighbourhood": "Koramangala", "pincode": "560034", "query": "milk", "state": "Karnataka" } ``` ## Response Successful output is returned in `results[0].data`. Raw platform output is intentionally open-ended and may evolve with the upstream source. ### Illustrative sample output This example shows one response. Values and optional fields vary with the data available. ```json { "categories": [], "observed_at": "2026-10-04T10:26:53Z", "pagination": { "has_more": true, "pages_fetched": 2, "raw_rows": 20, "stop_reason": "page_limit", "truncated": true }, "products": [ { "brand": "Amul", "currency": "INR", "discount_amount": 0, "discount_percentage": 0, "discount_source": "price_mrp", "eta_seconds": 473, "images": [ "https://rukminim1.flixcart.com/image/800/800/xif0q/milk/v/y/k/[redacted:token].png?q=80", "https://rukminim1.flixcart.com/image/800/800/xif0q/milk/p/m/r/[redacted:token].jpeg?q=80", "https://rukminim1.flixcart.com/image/800/800/xif0q/milk/6/k/e/[redacted:token].jpeg?q=80" ], "is_sponsored": null, "listing_id": "LSTMLKHFR86C8QNQPT8KJVBSL", "mrp": 34, "offers": [ { "label": "Bank Offer", "type": "BANK_OFFER" } ], "order_limit": 6, "pack": "500 ml", "price": 34, "product_id": "MLKHFR86C8QNQPT8", "stock": "IN_STOCK", "store_id": "ben_017_wh_hl_01", "store_provenance": "product", "title": "Amul Gold Milky Milk", "unit_price": 68, "unit_qualifier": "L", "url": "https://www.flipkart.com/amul-gold-milky-milk/p/itm44f0b035724de?lid=LSTMLKHFR86C8QNQPT8KJVBSL&marketplace=HYPERLOCAL&pid=MLKHFR86C8QNQPT8&shopId=ben_017_wh_hl_01", "variant_product_ids": [ "MLKHFR86C8QNQPT8" ] }, { "brand": "Akshayakalpa", "currency": "INR", "discount_amount": 0, "discount_percentage": 0, "discount_source": "price_mrp", "eta_seconds": 473, "images": [ "https://rukminim1.flixcart.com/image/800/800/xif0q/milk/2/k/z/-original-imahr4gvacapehzq.jpeg?q=80", "https://rukminim1.flixcart.com/image/800/800/xif0q/milk/k/w/k/-original-imahr5cj2pzgdsh4.jpeg?q=80", "https://rukminim1.flixcart.com/image/800/800/xif0q/milk/x/u/s/-original-imahr5cjpekr5zb6.jpeg?q=80" ], "is_sponsored": true, "listing_id": "LSTMLKHZ8SFPVBZ2SRVAMX8SB", "mrp": 50, "offers": [ { "label": "Buy More, Save More", "type": "BUY_MORE_SAVE_MORE" }, { "label": "Bank Offer", "type": "BANK_OFFER" } ], "order_limit": 6, "pack": "500 ml", "price": 50, "product_id": "MLKHZ8SFPVBZ2SRV", "stock": "IN_STOCK", "store_id": "ben_017_wh_hl_01", "store_provenance": "location", "title": "Amrutha Organic Cow Milk", "unit_price": 100, "unit_qualifier": "L", "url": "https://www.flipkart.com/akshayakalpa-amrutha-organic-cow-milk/p/itmc17dd1f15bd0a?lid=LSTMLKHZ8SFPVBZ2SRVAMX8SB&marketplace=HYPERLOCAL&pid=MLKHZ8SFPVBZ2SRV", "variant_product_ids": [ "MLKHZ8SFPVBZ2SRV" ] }, { "brand": "Amul", "currency": "INR", "discount_amount": 0, "discount_percentage": 0, "discount_source": "price_mrp", "eta_seconds": 473, "images": [ "https://rukminim1.flixcart.com/image/800/800/xif0q/milk/q/y/l/-[redacted:token].png?q=80", "https://rukminim1.flixcart.com/image/800/800/xif0q/milk/u/n/s/-original-imahhrhghzzaameu.jpeg?q=80", "https://rukminim1.flixcart.com/image/800/800/xif0q/milk/r/e/3/-original-imahhrhgpkdn3zey.jpeg?q=80" ], "is_sponsored": null, "listing_id": "LSTMLKHFR86BF77KGXZNIJ2RI", "mrp": 29, "offers": [ { "label": "Bank Offer", "type": "BANK_OFFER" } ], "order_limit": 6, "pack": "500 ml", "price": 29, "product_id": "MLKHFR86BF77KGXZ", "stock": "IN_STOCK", "store_id": "ben_017_wh_hl_01", "store_provenance": "product", "title": "Taaza Toned Milk", "unit_price": 58, "unit_qualifier": "L", "url": "https://www.flipkart.com/amul-taaza-toned-milk/p/itm8a494bf913753?lid=LSTMLKHFR86BF77KGXZNIJ2RI&marketplace=HYPERLOCAL&pid=MLKHFR86BF77KGXZ&shopId=ben_017_wh_hl_01", "variant_product_ids": [ "MLKHFR86BF77KGXZ" ] } ], "sections": [ { "position": 1, "type": "content" }, { "position": 2, "type": "products" }, { "position": 3, "type": "products" } ], "store": { "eta_seconds": 473, "store_id": "ben_017_wh_hl_01" } } ``` ### Illustrative output fields Derived from the sample above for orientation only. These fields are not a fixed response schema. | Path | Observed type | Example | | --- | --- | --- | | `categories` | `array` | 0 items | | `observed_at` | `string` | 2026-10-04T10:26:53Z | | `pagination` | `object` | 5 fields | | `pagination.has_more` | `boolean` | true | | `pagination.pages_fetched` | `integer` | 2 | | `pagination.raw_rows` | `integer` | 20 | | `pagination.stop_reason` | `string` | page_limit | | `pagination.truncated` | `boolean` | true | | `products` | `array` | 3 items | | `products` | `array` | 3 items | | `sections` | `array` | 3 items | | `sections` | `array` | 3 items | | `store` | `object` | 2 fields | | `store.eta_seconds` | `integer` | 473 | | `store.store_id` | `string` | ben_017_wh_hl_01 | ## Execution behavior A `200` response completed inline. A `202` response was queued; poll `GET /jobs/{id}` until the job reaches `completed` or `failed`. Use an `Idempotency-Key` when retrying must not create a duplicate logical job. ## Related documentation - [Authentication](https://docs.upscrape.com/docs/api/authentication) - [Jobs and results](https://docs.upscrape.com/docs/api/jobs) - [Errors and retries](https://docs.upscrape.com/docs/api/errors) - [Idempotency](https://docs.upscrape.com/docs/api/idempotency)