Skip to documentation
Browse documentation

List category products

List products from a Blinkit shelf, department default shelf or supported category URL for a chosen location.

Capability ID blinkit.category.products
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 subcategory_id for an exact shelf, category_url for a Blinkit category link, or category_id for a department’s default shelf. An explicit shelf takes precedence over a department ID. Filter by brand or brands.

Use include to request fulfillment details where available.

brand string optional

Brand filter.

brands array<string> optional

Brand filters.

category_id integer optional

Department ID from blinkit.categories, or a legacy category ID. Used to resolve a default shelf only when subcategory_id is omitted. An explicit shelf takes precedence; category_id then preserves caller context without validating its parent. At least 1.

Example 96263
category_url string optional

Blinkit /cn category link, with a department ID alone or department/subcategory IDs; HTTPS may be omitted.

include array<string> optional

Optional fields or enrichments to include. Allowed values: `fulfillment`.

Available values fulfillment
latitude number optional

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

limit integer optional

Maximum products returned. 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 upstream pages fetched to satisfy offset and limit. From 1 to 20. Default: `3`.

Example 1
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
subcategory_id string optional

Blinkit subcategory ID (the second ID after /cid/; top-deal IDs may end in _td).

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.

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
category_id integer 96263
count integer 5
has_more boolean true
limit integer 5
pages_fetched integer 1
partial boolean false
results array 3 items
results array 3 items
subcategory_id string 922

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