Skip to documentation
Browse documentation

Search products

Search Blinkit products by keyword and location, with brand filters, prices, stock and sponsored-placement flags.

Capability ID blinkit.search
Maximum runtime 60 seconds
View raw

POST /execute Shared execution endpoint

Input parameters

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.

brand string optional

Return only products whose normalized brand matches this value.

brands array<string> optional

Return products matching any normalized brand in this list.

include array<string> optional

Optional product enrichments. Allowed values: `fulfillment`.

Available values fulfillment
latitude number optional

Latitude of the delivery address. From -90 to 90.

limit integer optional

Maximum number of products to return. From 1 to 100. Default: `20`.

Example 5
location_query string optional

Free-text Indian location resolved before fetching location-dependent Blinkit data.

longitude number optional

Longitude of the delivery address. From -180 to 180.

max_pages integer optional

Maximum number of pages to fetch. From 1 to 20. Default: `3`.

offset integer optional

Number of deduplicated products to skip. From 0 to 10000. Default: `0`.

pincode string optional

Six-digit Indian pincode; surrounding whitespace is allowed and trimmed. Do not combine with coordinates.

Example 560102
query string required

Search query string.

Example 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 The example response is shown in the response panel.

Illustrative output fields

Values illustrate one response. Read the guidance above for missing values and limits; fields can vary with the requested operation and the data available.

PathObserved typeExample
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.

Overview, pricing and sample data for every endpoint: Blinkit API