# List Category Products

List Zepto products from a /cn/.../cid/.../scid/... category URL.

- Platform: [Zepto](https://docs.upscrape.com/docs/platforms/zepto)
- Capability ID: `zepto.category.products`
- Cost: 1 credit 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 -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"limit":5,"url":"https://www.zepto.com/cn/fruits-vegetables/fresh-fruits/cid/64374cfe-d06f-4a01-898e-c07c46462c36/scid/09e63c15-e5f7-4712-9ff8-513250b79942"},"capability":"zepto.category.products"}'
```

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `category_id` | `string` | No | Zepto category ID to browse. |
| `latitude` | `number` | No | Latitude for location-based store resolution. |
| `limit` | `integer` | No | Maximum number of products to return per page. |
| `longitude` | `number` | No | Longitude for location-based store resolution. |
| `max_pages` | `integer` | No | Maximum number of pages to fetch. |
| `page_number` | `integer` | No | One-based page number to start from. |
| `store_id` | `string` | No | Zepto store ID. Defaults to the public Bangalore sample store. |
| `subcategory_id` | `string` | No | Zepto subcategory ID to browse. |
| `url` | `string` | No | Direct URL to a Zepto category page. |

### Example input

```json
{
  "limit": 5,
  "url": "https://www.zepto.com/cn/fruits-vegetables/fresh-fruits/cid/64374cfe-d06f-4a01-898e-c07c46462c36/scid/09e63c15-e5f7-4712-9ff8-513250b79942"
}
```

## 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 redacted fixture is an example, not a fixed response schema.

```json
{
  "count": 5,
  "page_number": 1,
  "pages_fetched": 1,
  "results": [
    {
      "discount_amount_paise": 8700,
      "unit_of_measure": "PIECE",
      "discounted_selling_price_paise": 7800,
      "product_type": "SELLABLESKU",
      "image_path": "cms/product_variant/fa6acfce-a598-4f3e-aa28-eb94df49d743.png",
      "weight_in_gms": 58,
      "country_of_origin": "India",
      "store_product_id": "8e03ba55-b787-5b9b-9dc6-6fafd06228cd",
      "discount_percent": 52,
      "max_allowed_quantity": 6,
      "mrp_paise": 16500,
      "description": "Custard apple is a tropical fruit that grows mostly in tropical climates. The fruits are heart-shaped with light green exterior and smooth creamy white flesh and are well-known for their exquisite taste. The fruit is high in carbs, minerals, and a good source of vitamin c.",
      "cached": true,
      "name": "Custard Apple Semi Ripe",
      "source_url": "https://bff-gateway.zepto.com/product-assortment-service/api/v2/store-products-by-store-subcategory-id?category_id=64374cfe-d06f-4a01-898e-c07c46462c36&page_number=1&store_id=b4dc8d65-ed2e-4142-81b6-373982b13500&subcategory_id=09e63c15-e5f7-4712-9ff8-513250b79942",
      "brand_id": "d396c794-de67-421c-9af1-dc36df2c2471",
      "available_quantity": 6,
      "quantity": 6,
      "pack_size": 2,
      "category_id": "64374cfe-d06f-4a01-898e-c07c46462c36",
      "l3_category_id": "5942b588-81c1-4195-afca-f776c8c4c094",
      "rank": 1,
      "brand": "Fruits",
      "formatted_pack_size": "2 pcs (360 - 450 g)",
      "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/fa6acfce-a598-4f3e-aa28-eb94df49d743.png",
      "product_variant_id": "b5cb2914-895d-4b3e-86d0-9bd9f9234428",
      "store_id": "b4dc8d65-ed2e-4142-81b6-373982b13500",
      "image_urls": [
        "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/fa6acfce-a598-4f3e-aa28-eb94df49d743.png"
      ],
      "is_primary": true,
      "primary_subcategory_id": "09e63c15-e5f7-4712-9ff8-513250b79942",
      "product_id": "31e25f4a-c334-4c8a-acce-10a6a0677aed",
      "selling_price_paise": 7800,
      "is_active": true,
      "product_url": "https://www.zepto.com/pn/custard-apple-semi-ripe/pvid/b5cb2914-895d-4b3e-86d0-9bd9f9234428",
      "shelf_life_in_hours": "4 days"
    },
    {
      "discount_amount_paise": 4100,
      "unit_of_measure": "PIECE",
      "discounted_selling_price_paise": 3100,
      "product_type": "SELLABLESKU",
      "image_path": "cms/product_variant/2ee02a46-99b9-4fc7-b389-0e881c02fe56.jpeg",
      "weight_in_gms": 200,
      "country_of_origin": "India",
      "store_product_id": "44cd61e6-c62a-5661-99c0-e2ac41309cb9",
      "discount_percent": 56,
      "max_allowed_quantity": 6,
      "mrp_paise": 7200,
      "cached": true,
      "name": "Banana Robusta",
      "source_url": "https://bff-gateway.zepto.com/product-assortment-service/api/v2/store-products-by-store-subcategory-id?category_id=64374cfe-d06f-4a01-898e-c07c46462c36&page_number=1&store_id=b4dc8d65-ed2e-4142-81b6-373982b13500&subcategory_id=09e63c15-e5f7-4712-9ff8-513250b79942",
      "brand_id": "d69ba762-dfca-47f4-8e52-d09a6d1ffbd0",
      "available_quantity": 6,
      "quantity": 6,
      "pack_size": 4,
      "category_id": "64374cfe-d06f-4a01-898e-c07c46462c36",
      "l3_category_id": "d16cc33d-74e8-480d-9414-5dc06cdb47ea",
      "rank": 2,
      "brand": "Unbranded",
      "formatted_pack_size": "4 pcs",
      "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/2ee02a46-99b9-4fc7-b389-0e881c02fe56.jpeg",
      "product_variant_id": "436c0025-de54-4748-a189-79e292f26071",
      "store_id": "b4dc8d65-ed2e-4142-81b6-373982b13500",
      "image_urls": [
        "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/2ee02a46-99b9-4fc7-b389-0e881c02fe56.jpeg"
      ],
      "is_primary": true,
      "primary_subcategory_id": "09e63c15-e5f7-4712-9ff8-513250b79942",
      "product_id": "c6bce5f8-a70b-4806-99c1-c2b8df503e1a",
      "selling_price_paise": 3100,
      "is_active": true,
      "product_url": "https://www.zepto.com/pn/banana-robusta/pvid/436c0025-de54-4748-a189-79e292f26071",
      "shelf_life_in_hours": "3 days"
    },
    {
      "discount_amount_paise": 7600,
      "unit_of_measure": "GRAM",
      "discounted_selling_price_paise": 7300,
      "product_type": "SELLABLESKU",
      "image_path": "cms/product_variant/cf8f80c4-1b42-46bc-a3cf-55360cd418e9.jpeg",
      "weight_in_gms": 500,
      "country_of_origin": "India",
      "store_product_id": "22ba089c-c0c2-5d4a-b4d6-d11d823b088f",
      "discount_percent": 51,
      "max_allowed_quantity": 6,
      "mrp_paise": 14900,
      "description": "Elaichi bananas might be small in size but are equally nutritious as any regular-sized banana. These dwarf bananas contain far lesser calories than regular bananas, which aids metabolism. Elaichi banana also helps the body maintain a regular heartbeat, lower blood pressure and a proper balance of water in the body.",
      "cached": true,
      "name": "Banana Elaichi (Yelakki)",
      "source_url": "https://bff-gateway.zepto.com/product-assortment-service/api/v2/store-products-by-store-subcategory-id?category_id=64374cfe-d06f-4a01-898e-c07c46462c36&page_number=1&store_id=b4dc8d65-ed2e-4142-81b6-373982b13500&subcategory_id=09e63c15-e5f7-4712-9ff8-513250b79942",
      "brand_id": "d69ba762-dfca-47f4-8e52-d09a6d1ffbd0",
      "available_quantity": 6,
      "quantity": 6,
      "pack_size": 500,
      "category_id": "64374cfe-d06f-4a01-898e-c07c46462c36",
      "l3_category_id": "d16cc33d-74e8-480d-9414-5dc06cdb47ea",
      "rank": 3,
      "brand": "Unbranded",
      "formatted_pack_size": "500 g",
      "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/cf8f80c4-1b42-46bc-a3cf-55360cd418e9.jpeg",
      "product_variant_id": "db471557-f745-4574-9e82-1916a88d9e6b",
      "store_id": "b4dc8d65-ed2e-4142-81b6-373982b13500",
      "image_urls": [
        "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/cf8f80c4-1b42-46bc-a3cf-55360cd418e9.jpeg"
      ],
      "is_primary": true,
      "primary_subcategory_id": "09e63c15-e5f7-4712-9ff8-513250b79942",
      "product_id": "89412b09-5a51-45b0-bb76-83a520cad0c8",
      "selling_price_paise": 7300,
      "is_active": true,
      "product_url": "https://www.zepto.com/pn/banana-elaichi-yelakki/pvid/db471557-f745-4574-9e82-1916a88d9e6b",
      "shelf_life_in_hours": "3 days"
    }
  ],
  "source_url": "https://bff-gateway.zepto.com/product-assortment-service/api/v2/store-products-by-store-subcategory-id?category_id=64374cfe-d06f-4a01-898e-c07c46462c36&page_number=1&store_id=b4dc8d65-ed2e-4142-81b6-373982b13500&subcategory_id=09e63c15-e5f7-4712-9ff8-513250b79942"
}
```
### 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 |
| `page_number` | `integer` | 1 |
| `pages_fetched` | `integer` | 1 |
| `results` | `array` | 3 items |
| `results` | `array` | 3 items |
| `source_url` | `string` | https://bff-gateway.zepto.com/product-assortment-service/api/v2/store-p… |

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

See [jobs and results](https://docs.upscrape.com/docs/api/jobs), [errors and retries](https://docs.upscrape.com/docs/api/errors), and [idempotency](https://docs.upscrape.com/docs/api/idempotency).

## Machine-readable contract

- [Capability OpenAPI 3.1](https://docs.upscrape.com/docs/platforms/zepto/zepto.category.products/openapi.json)
- [Platform OpenAPI 3.1](https://upscrape.com/scrapers/zepto/openapi.json)
- [Focused coding-agent prompt](https://upscrape.com/scrapers/zepto/capabilities/zepto.category.products/llm.md)
