# Search products Search Blinkit products by keyword and location, with brand filters, prices, stock and sponsored-placement flags. - Platform: [Blinkit](https://docs.upscrape.com/docs/platforms/blinkit) - Capability ID: `blinkit.search` - Cost: 1–9 credits per request - Maximum runtime: 60 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": { "limit": 5, "pincode": "560102", "query": "milk" }, "capability": "blinkit.search" }' ``` ## Input Choose exactly one location: a six-digit pincode, a place name in location_query, or both latitude and longitude. Do not combine location modes. A pincode represents one delivery point, not every address in the area. Provide a nonblank query. Use brand for one brand or brands for several; filters match normalized brand names. Include fulfillment to request the supported extra context. | Field | Type | Required | Description | | --- | --- | --- | --- | | `brand` | `string` | No | Return only products whose normalized brand matches this value. | | `brands` | `array` | No | Return products matching any normalized brand in this list. | | `include` | `array` | No | Optional product enrichments. Allowed values: `fulfillment`. | | `latitude` | `number` | No | Latitude of the delivery address. From -90 to 90. | | `limit` | `integer` | No | Maximum number of products to return. From 1 to 100. Default: `20`. | | `location_query` | `string` | No | Free-text Indian location resolved before fetching location-dependent Blinkit data. | | `longitude` | `number` | No | Longitude of the delivery address. From -180 to 180. | | `max_pages` | `integer` | No | Maximum number of pages to fetch. From 1 to 20. Default: `3`. | | `offset` | `integer` | No | Number of deduplicated products to skip. From 0 to 10000. Default: `0`. | | `pincode` | `string` | No | Six-digit Indian pincode; surrounding whitespace is allowed and trimmed. Do not combine with coordinates. | | `query` | `string` | Yes | Search query string. | ### Example input ```json { "limit": 5, "pincode": "560102", "query": "milk" } ``` ## Response Successful output is returned in `results[0].data`. Prices, MRP and inventory can be null when Blinkit provides no value. A real zero stays zero. Keep stock_status (in_stock, low_stock, out_of_stock or unknown), available and is_sold_out separate from price. Missing or conflicting availability signals must remain unknown. Use offset to skip deduplicated products and max_pages to bound the pages read. Check partial, partial_reason and has_more before treating a result as complete. A partial response can contain useful products; a requested limit does not guarantee that many matches or exhaustive coverage. Search absence is not a stockout. Check the exact product at the same location before concluding it is unavailable. A placement without classification must not be counted as organic. ### Illustrative sample output This example shows one response. Values and optional fields vary with the data available. ```json { "count": 5, "has_more": true, "limit": 5, "query": "milk", "results": [ { "group_id": 1946467, "is_sponsored": true, "is_sold_out": false, "query": "milk", "price_per_unit": 0.108889, "rating": 4.6, "mrp": 59, "rating_count": 15155, "location": { "latitude": 12.911862, "longitude": 77.6445923, "pincode": "560102" }, "fulfillment": null, "organic_rank": null, "discount_percent": 16.95, "captured_at": "2026-09-24T08:19:47Z", "stock_status": "in_stock", "merchant_type": "express", "inventory": 4, "name": "Country Delight Buffalo Fresh Milk", "price_per_100_unit": 10.8889, "currency": "INR", "quantity": 450, "price": 49, "category_id": null, "discount_text": "16% OFF", "images": [ "https://cdn.grofers.com/da/cms-assets/cms/product/6e7eba87-a136-409a-9aab-7022ca4051be.png", "https://cdn.grofers.com/da/cms-assets/cms/product/f0078aa7-c2cb-4039-8760-69234ec7f299.png", "https://cdn.grofers.com/da/cms-assets/cms/product/e2bee74c-b726-41cd-8d9a-a3bab64b4679.png" ], "available": true, "rank": 1, "brand": "Country Delight", "image_url": "https://cdn.grofers.com/da/cms-assets/cms/product/6e7eba87-a136-409a-9aab-7022ca4051be.png", "subcategory_name": null, "variant": "450 ml", "subcategory_id": null, "category_name": null, "unit": "ml", "product_id": 637879, "discount_amount": 10, "product_url": "https://blinkit.com/prn/country-delight-buffalo-fresh-milk/prid/637879", "merchant_id": "40589" }, { "group_id": 2167381, "is_sponsored": false, "is_sold_out": false, "query": "milk", "price_per_unit": 0.048, "rating": 4.5, "mrp": 24, "rating_count": 120000, "location": { "latitude": 12.911862, "longitude": 77.6445923, "pincode": "560102" }, "fulfillment": null, "organic_rank": 1, "discount_percent": 0, "captured_at": "2026-09-24T08:19:47Z", "stock_status": "in_stock", "merchant_type": "express", "inventory": 12, "name": "Nandini Toned Milk", "price_per_100_unit": 4.8, "currency": "INR", "quantity": 500, "price": 24, "category_id": null, "discount_text": null, "images": [ "https://cdn.grofers.com/da/cms-assets/cms/product/be666ef4-a87d-4ff7-8461-38f3a9682078.png", "https://cdn.grofers.com/da/cms-assets/cms/product/c0fb2f12-6b62-43b4-bd93-b5061a17beae.jpg", "https://cdn.grofers.com/da/cms-assets/cms/product/cb1ba444-abf2-4093-bc86-4bf061d05de6.jpg" ], "available": true, "rank": 2, "brand": "Nandini", "image_url": "https://cdn.grofers.com/da/cms-assets/cms/product/be666ef4-a87d-4ff7-8461-38f3a9682078.png", "subcategory_name": null, "variant": "500 ml", "subcategory_id": null, "category_name": null, "unit": "ml", "product_id": 37083, "discount_amount": 0, "product_url": "https://blinkit.com/prn/nandini-toned-milk/prid/37083", "merchant_id": "40589" }, { "group_id": 2908874, "is_sponsored": false, "is_sold_out": false, "query": "milk", "price_per_unit": 0.054, "rating": 4.6, "mrp": 27, "rating_count": 140000, "location": { "latitude": 12.911862, "longitude": 77.6445923, "pincode": "560102" }, "fulfillment": null, "organic_rank": 2, "discount_percent": 0, "captured_at": "2026-09-24T08:19:47Z", "stock_status": "in_stock", "merchant_type": "express", "inventory": 12, "name": "Nandini Shubham Pasteurised Standardized Toned Milk", "price_per_100_unit": 5.4, "currency": "INR", "quantity": 500, "price": 27, "category_id": null, "discount_text": null, "images": [ "https://cdn.grofers.com/da/cms-assets/cms/product/fb28768e-6f5a-4047-9ad8-159bbe60959c.png", "https://cdn.grofers.com/da/cms-assets/cms/product/03d3311a-97d9-431d-954c-5522ce46b2e8.png", "https://cdn.grofers.com/da/cms-assets/cms/product/a480cbac-a461-49b7-abb0-d91dbe1a6237.png" ], "available": true, "rank": 3, "brand": "Nandini", "image_url": "https://cdn.grofers.com/da/cms-assets/cms/product/fb28768e-6f5a-4047-9ad8-159bbe60959c.png", "subcategory_name": null, "variant": "500 ml", "subcategory_id": null, "category_name": null, "unit": "ml", "product_id": 309921, "discount_amount": 0, "product_url": "https://blinkit.com/prn/nandini-shubham-pasteurised-standardized-toned-milk/prid/309921", "merchant_id": "40589" } ] } ``` ### Illustrative output fields Derived from the sample above for orientation only. These fields are not a fixed response schema. | Path | Observed type | Example | | --- | --- | --- | | `count` | `integer` | 5 | | `has_more` | `boolean` | true | | `limit` | `integer` | 5 | | `query` | `string` | milk | | `results` | `array` | 3 items | | `results` | `array` | 3 items | ## 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)