# List category products

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

- Platform: [Blinkit](https://docs.upscrape.com/docs/platforms/blinkit)
- Capability ID: `blinkit.category.products`
- 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": {
    "category_id": 96263,
    "limit": 5,
    "max_pages": 1,
    "pincode": "560102"
  },
  "capability": "blinkit.category.products"
}'
```

## 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 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.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `brand` | `string` | No | Brand filter. |
| `brands` | `array<string>` | No | Brand filters. |
| `category_id` | `integer` | No | 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. |
| `category_url` | `string` | No | Blinkit /cn category link, with a department ID alone or department/subcategory IDs; HTTPS may be omitted. |
| `include` | `array<string>` | No | Optional fields or enrichments to include. Allowed values: `fulfillment`. |
| `latitude` | `number` | No | Latitude of the delivery address. From -90 to 90. |
| `limit` | `integer` | No | Maximum products returned. 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 upstream pages fetched to satisfy offset and limit. 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. |
| `subcategory_id` | `string` | No | Blinkit subcategory ID (the second ID after /cid/; top-deal IDs may end in _td). |

### Example input

```json
{
  "category_id": 96263,
  "limit": 5,
  "max_pages": 1,
  "pincode": "560102"
}
```

## 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 output

This example shows one response. Values and optional fields vary with the data available.

```json
{
  "category_id": 96263,
  "count": 5,
  "has_more": true,
  "limit": 5,
  "pages_fetched": 1,
  "partial": false,
  "results": [
    {
      "group_id": 2167381,
      "is_sponsored": false,
      "is_sold_out": false,
      "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-10-01T08:30:36Z",
      "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": 96263,
      "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": 1,
      "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": "922",
      "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,
      "price_per_unit": 0.052,
      "rating": 4.6,
      "mrp": 52,
      "rating_count": 140000,
      "location": {
        "latitude": 12.911862,
        "longitude": 77.6445923,
        "pincode": "560102"
      },
      "fulfillment": null,
      "organic_rank": 2,
      "discount_percent": 0,
      "captured_at": "2026-10-01T08:30:36Z",
      "stock_status": "in_stock",
      "merchant_type": "express",
      "inventory": 6,
      "name": "Nandini Shubham Pasteurised Standardized Toned Milk",
      "price_per_100_unit": 5.2,
      "currency": "INR",
      "quantity": 1000,
      "price": 52,
      "category_id": 96263,
      "discount_text": null,
      "images": [
        "https://cdn.grofers.com/da/cms-assets/cms/product/c2470cb6-4493-43ac-bf0f-2a01441ca519.png",
        "https://cdn.grofers.com/da/cms-assets/cms/product/b0fa96be-db9d-4ecf-89a0-dd511c4f2c5d.png",
        "https://cdn.grofers.com/da/cms-assets/cms/product/dc826d6c-1b07-45c8-a669-7e9b0bdd1e22.png"
      ],
      "available": true,
      "rank": 2,
      "brand": "Nandini",
      "image_url": "https://cdn.grofers.com/da/cms-assets/cms/product/c2470cb6-4493-43ac-bf0f-2a01441ca519.png",
      "subcategory_name": null,
      "variant": "1 ltr",
      "subcategory_id": "922",
      "category_name": null,
      "unit": "ml",
      "product_id": 681066,
      "discount_amount": 0,
      "product_url": "https://blinkit.com/prn/nandini-shubham-pasteurised-standardized-toned-milk/prid/681066",
      "merchant_id": "40589"
    },
    {
      "group_id": 2080572,
      "is_sponsored": false,
      "is_sold_out": false,
      "price_per_unit": 0.096,
      "rating": 4.6,
      "mrp": 48,
      "rating_count": 6624,
      "location": {
        "latitude": 12.911862,
        "longitude": 77.6445923,
        "pincode": "560102"
      },
      "fulfillment": null,
      "organic_rank": 3,
      "discount_percent": 0,
      "captured_at": "2026-10-01T08:30:36Z",
      "stock_status": "in_stock",
      "merchant_type": "express",
      "inventory": 7,
      "name": "Akshayakalpa Organic Cow Milk (Pasteurized)",
      "price_per_100_unit": 9.6,
      "currency": "INR",
      "quantity": 500,
      "price": 48,
      "category_id": 96263,
      "discount_text": null,
      "images": [
        "https://cdn.grofers.com/da/cms-assets/cms/product/rc-upload-1786402542217-186.png",
        "https://cdn.grofers.com/da/cms-assets/cms/product/rc-upload-1786402542217-187.png",
        "https://cdn.grofers.com/da/cms-assets/cms/product/rc-upload-1786402542217-188.png"
      ],
      "available": true,
      "rank": 3,
      "brand": "Akshayakalpa Organic",
      "image_url": "https://cdn.grofers.com/da/cms-assets/cms/product/rc-upload-1786402542217-186.png",
      "subcategory_name": null,
      "variant": "500 ml",
      "subcategory_id": "922",
      "category_name": null,
      "unit": "ml",
      "product_id": 478885,
      "discount_amount": 0,
      "product_url": "https://blinkit.com/prn/akshayakalpa-organic-cow-milk-pasteurized/prid/478885",
      "merchant_id": "40589"
    }
  ],
  "subcategory_id": "922"
}
```
### Illustrative output fields

Derived from the sample above for orientation only. These fields are not a fixed response schema.

| Path | Observed type | Example |
| --- | --- | --- |
| `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`. 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)