# Categories List

List the Asda Groceries category taxonomy (category > department > aisle) with product counts, derived from the catalog index facets.

- Platform: [Asda](https://docs.upscrape.com/docs/platforms/asda)
- Capability ID: `asda.categories.list`
- Cost: 1 credit per request
- Maximum runtime: 30 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":{"store_id":"4565"},"capability":"asda.categories.list"}'
```

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `store_id` | `string` | No | Asda store id used for stock boosting |

### Example input

```json
{
  "store_id": "4565"
}
```

## 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
{
  "categories": [
    {
      "children": [
        {
          "children": [
            {
              "depth": 3,
              "name": "Bedding",
              "path": "Home & Entertainment > Bed, Bath & Home > Bedding",
              "product_count": 4117
            },
            {
              "depth": 3,
              "name": "Bath Towels & Mats",
              "path": "Home & Entertainment > Bed, Bath & Home > Bath Towels & Mats",
              "product_count": 2051
            },
            {
              "depth": 3,
              "name": "Candles & Room Fragrances",
              "path": "Home & Entertainment > Bed, Bath & Home > Candles & Room Fragrances",
              "product_count": 1733
            }
          ],
          "depth": 2,
          "id": "1215334114125",
          "name": "Bed, Bath & Home",
          "path": "Home & Entertainment > Bed, Bath & Home",
          "product_count": 13238
        },
        {
          "children": [
            {
              "depth": 3,
              "name": "Books",
              "path": "Home & Entertainment > Music, Film, Games & Books > Books",
              "product_count": 6789
            },
            {
              "depth": 3,
              "name": "DVDs & Blu-rays",
              "path": "Home & Entertainment > Music, Film, Games & Books > DVDs & Blu-rays",
              "product_count": 2248
            },
            {
              "depth": 3,
              "name": "Music",
              "path": "Home & Entertainment > Music, Film, Games & Books > Music",
              "product_count": 775
            }
          ],
          "depth": 2,
          "id": "1215186489092",
          "name": "Music, Film, Games & Books",
          "path": "Home & Entertainment > Music, Film, Games & Books",
          "product_count": 10557
        },
        {
          "children": [
            {
              "depth": 3,
              "name": "Dining & Glassware",
              "path": "Home & Entertainment > Kitchen > Dining & Glassware",
              "product_count": 2719
            },
            {
              "depth": 3,
              "name": "Cooking",
              "path": "Home & Entertainment > Kitchen > Cooking",
              "product_count": 868
            },
            {
              "depth": 3,
              "name": "Food Storage Solutions",
              "path": "Home & Entertainment > Kitchen > Food Storage Solutions",
              "product_count": 779
            }
          ],
          "depth": 2,
          "id": "1215334114085",
          "name": "Kitchen",
          "path": "Home & Entertainment > Kitchen",
          "product_count": 6415
        }
      ],
      "depth": 1,
      "id": "1215135760682",
      "name": "Home & Entertainment",
      "path": "Home & Entertainment",
      "product_count": 51456
    },
    {
      "children": [
        {
          "children": [
            {
              "depth": 3,
              "name": "Sweets",
              "path": "Food Cupboard > Chocolates & Sweets > Sweets",
              "product_count": 694
            },
            {
              "depth": 3,
              "name": "Boxed Chocolates & Gifts",
              "path": "Food Cupboard > Chocolates & Sweets > Boxed Chocolates & Gifts",
              "product_count": 529
            },
            {
              "depth": 3,
              "name": "Sharing Chocolate Bars",
              "path": "Food Cupboard > Chocolates & Sweets > Sharing Chocolate Bars",
              "product_count": 360
            }
          ],
          "depth": 2,
          "id": "1215279696813",
          "name": "Chocolates & Sweets",
          "path": "Food Cupboard > Chocolates & Sweets",
          "product_count": 2518
        },
        {
          "children": [
            {
              "depth": 3,
              "name": "Sauces & Condiments",
              "path": "Food Cupboard > Condiments & Cooking Ingredients > Sauces & Condiments",
              "product_count": 455
            },
            {
              "depth": 3,
              "name": "Spices",
              "path": "Food Cupboard > Condiments & Cooking Ingredients > Spices",
              "product_count": 244
            },
            {
              "depth": 3,
              "name": "Oil & Vinegar",
              "path": "Food Cupboard > Condiments & Cooking Ingredients > Oil & Vinegar",
              "product_count": 183
            }
          ],
          "depth": 2,
          "id": "1215354523758",
          "name": "Condiments & Cooking Ingredients",
          "path": "Food Cupboard > Condiments & Cooking Ingredients",
          "product_count": 1553
        },
        {
          "children": [
            {
              "depth": 3,
              "name": "Sharing Crisps",
              "path": "Food Cupboard > Crisps, Nuts & Popcorn > Sharing Crisps",
              "product_count": 548
            },
            {
              "depth": 3,
              "name": "Multipack Crisps",
              "path": "Food Cupboard > Crisps, Nuts & Popcorn > Multipack Crisps",
              "product_count": 363
            },
            {
              "depth": 3,
              "name": "Nuts & Dried Fruit",
              "path": "Food Cupboard > Crisps, Nuts & Popcorn > Nuts & Dried Fruit",
              "product_count": 257
            }
          ],
          "depth": 2,
          "id": "1215165893478",
          "name": "Crisps, Nuts & Popcorn",
          "path": "Food Cupboard > Crisps, Nuts & Popcorn",
          "product_count": 1283
        }
      ],
      "depth": 1,
      "id": "1215337189632",
      "name": "Food Cupboard",
      "path": "Food Cupboard",
      "product_count": 12143
    },
    {
      "children": [
        {
          "children": [
            {
              "depth": 3,
              "name": "Face",
              "path": "Toiletries & Beauty > Make Up & Nails > Face",
              "product_count": 856
            },
            {
              "depth": 3,
              "name": "Nails",
              "path": "Toiletries & Beauty > Make Up & Nails > Nails",
              "product_count": 589
            },
            {
              "depth": 3,
              "name": "Lips",
              "path": "Toiletries & Beauty > Make Up & Nails > Lips",
              "product_count": 521
            }
          ],
          "depth": 2,
          "id": "1215185955607",
          "name": "Make Up & Nails",
          "path": "Toiletries & Beauty > Make Up & Nails",
          "product_count": 2612
        },
        {
          "children": [
            {
              "depth": 3,
              "name": "Shampoo & Conditioner",
              "path": "Toiletries & Beauty > Hair Care, Dye & Styling > Shampoo & Conditioner",
              "product_count": 1134
            },
            {
              "depth": 3,
              "name": "Hair Dye",
              "path": "Toiletries & Beauty > Hair Care, Dye & Styling > Hair Dye",
              "product_count": 562
            },
            {
              "depth": 3,
              "name": "Hair Accessories",
              "path": "Toiletries & Beauty > Hair Care, Dye & Styling > Hair Accessories",
              "product_count": 225
            }
          ],
          "depth": 2,
          "id": "1215431206069",
          "name": "Hair Care, Dye & Styling",
          "path": "Toiletries & Beauty > Hair Care, Dye & Styling",
          "product_count": 2132
        },
        {
          "children": [
            {
              "depth": 3,
              "name": "Face Cream & Moisturiser",
              "path": "Toiletries & Beauty > Skin Care > Face Cream & Moisturiser",
              "product_count": 328
            },
            {
              "depth": 3,
              "name": "Cleansers & Face Washes",
              "path": "Toiletries & Beauty > Skin Care > Cleansers & Face Washes",
              "product_count": 267
            },
            {
              "depth": 3,
              "name": "Hands, Lips & Foot Care",
              "path": "Toiletries & Beauty > Skin Care > Hands, Lips & Foot Care",
              "product_count": 168
            }
          ],
          "depth": 2,
          "id": "1215431252930",
          "name": "Skin Care",
          "path": "Toiletries & Beauty > Skin Care",
          "product_count": 1112
        }
      ],
      "depth": 1,
      "id": "1215135760648",
      "name": "Toiletries & Beauty",
      "path": "Toiletries & Beauty",
      "product_count": 9924
    }
  ],
  "raw": {
    "facets": {
      "": {
        "Frozen Food": 2947,
        "Baby, Toddler & Kids": 2216,
        "Other": 6763,
        "Meat, Poultry & Fish": 4107,
        "Chilled Food": 7137,
        "Valentine's Day": 4,
        "Organic": 2,
        "Better For You": 2,
        "World Food": 1403,
        "Exceptional By Asda": 6,
        "Beer, Wine & Spirits": 5079,
        "Halloween": 378,
        "Back to School": 6,
        "Pet Food & Accessories": 2141,
        "Vegan & Free From": 1,
        "Kiosk": 903,
        "Father's Day": 17,
        "Dietary & Lifestyle": 714,
        "Big Night In": 2,
        "Going to Uni": 1,
        "Fresh Fruit, Vegetables & Flowers": 943,
        "JUST ESSENTIALS": 2,
        "Vegan & Plant Based": 5,
        "Christmas": 834,
        "Sweets, Treats & Snacks": 126,
        "Drinks": 1699,
        "Home & Entertainment": 51456,
        "Toiletries & Beauty": 9924,
        "Live Better": 5,
        "Easter": 148,
        "Laundry & Household": 4157,
        "Coronation Celebration": 18,
        "Bakery": 2900,
        "Exceptional by Asda (OLD)": 1,
        "Mother's Day": 70,
        "Happy Lunar New Year": 4,
        "Rollback": 28,
        "Get Match Ready": 8,
        "Ramadan": 7,
        "Celebrate New Year": 2,
        "Veganuary": 1,
        "Free From...": 15,
        "Events & Inspiration": 108,
        "Health & Wellness": 2407,
        "Food Cupboard": 12143,
        "Garden & Outdoor": 1,
        "Price Drop": 2,
        "The Entertainer Toys": 131,
        "Summer": 14
      },
      "Food Cupboard": {
        "Better For You Food Cupboard": 1,
        "Biscuits": 936,
        "Cereals & Cereal Bars": 823,
        "Chocolates & Sweets": 2518,
        "Christmas Treats & Food Cupboard": 2,
        "Coffee, Tea & Hot Chocolate": 1019,
        "Condiments & Cooking Ingredients": 1553,
        "Cooking Sauces, Meal Kits & Sides": 938,
        "Crackers & Savoury Biscuits": 1,
        "Crisps, Nuts & Popcorn": 1283,
        "Easter Chocolate & Sweets": 2,
        "Food Cupboard": 1,
        "Free From & Organic": 2,
        "Halloween Treats & Baking": 2,
        "Home Baking": 732,
        "Jams, Spreads & Desserts": 604,
        "Noodle Pots & Instant Snacks": 420,
        "Rice, Pasta & Noodles": 436,
        "Tinned Food": 849,
        "Under 100 Calories Food Cupboard": 14,
        "World Foods": 7
      },
      "Food Cupboard > Chocolates & Sweets": {
        "Boxed Chocolates & Gifts": 529,
        "Chocolate Bags & Cartons": 354,
        "Christmas Chocolates & Sweets": 1,
        "Coming Soon for Easter": 3,
        "Confectionery Tubs, Tins & Refill Pouches": 1,
        "Dark Chocolate": 4,
        "Exceptional Chocolates & Sweets": 2,
        "Fun Size Chocolate & Sweets": 14,
        "Mints & Chewing Gum": 141,
        "Multipack Chocolate": 222,
        "Sharing Chocolate Bars": 360,
        "Small Chocolate Bars & Bags": 189,
        "Sweet Biscuits": 2,
        "Sweets": 694,
        "Valentine's Day": 2
      },
      "Food Cupboard > Condiments & Cooking Ingredients": {
        "Chutney & Pickles": 151,
        "Dry Herbs": 60,
        "Gravy": 116,
        "Marinades & Rubs": 109,
        "Oil & Vinegar": 183,
        "Passata & Tomato Puree": 4,
        "Popular Brands": 7,
        "Salad Dressing & Croutons": 47,
        "Salt & Pepper": 56,
        "Sauces & Condiments": 455,
        "Spices": 244,
        "Stock": 91,
        "Stuffing & Breadcrumbs": 30
      },
      "Food Cupboard > Crisps, Nuts & Popcorn": {
        "Healthier Snacks & Bars": 1,
        "Multipack Crisps": 363,
        "Nuts & Dried Fruit": 257,
        "Popcorn": 72,
        "Sharing Crisps": 548,
        "Tortilla Chips & Dips": 42
      },
      "Home & Entertainment": {
        "At Home with Stacey Solomon": 90,
        "Batteries & Light Bulbs": 460,
        "Bed, Bath & Home": 13238,
        "Celebrating Disney": 3,
        "Christmas": 1511,
        "DIY & Car Care": 1275,
        "Disney": 6,
        "Fathers Day": 26,
        "For The Home": 1,
        "Garden & Outdoor": 2217,
        "Greeting Cards": 1180,
        "Halloween": 838,
        "JML": 122,
        "Kids Party": 1,
        "Kitchen": 6415,
        "Mother's Day Gifts & Dine": 36,
        "Music, Film, Games & Books": 10557,
        "Party, Cards & Gift Wrap": 222,
        "Partyware & Gifting": 3291,
        "Stationery, Magazines & Stamps": 2186,
        "Technology & Electricals": 1649,
        "Toys": 5405,
        "Travel & Leisure": 723,
        "Valentine's Gifts & Decorations": 4
      },
      "Home & Entertainment > Bed, Bath & Home": {
        "Baby & Kids Bedroom": 1047,
        "Bath Towels & Mats": 2051,
        "Bathroom Accessories": 638,
        "Bedding": 4117,
        "Candles & Room Fragrances": 1733,
        "Decor & Lighting": 1681,
        "Photo Frames & Albums": 240,
        "Soft Furnishings": 1731
      },
      "Home & Entertainment > Kitchen": {
        "Baking": 231,
        "Cooking": 868,
        "Dining & Glassware": 2719,
        "Disposable Table, Drink & Foodware": 28,
        "Food Storage Solutions": 779,
        "Kids Dine": 538,
        "Kitchen Appliances": 568,
        "Laundry & Cleaning Essentials": 194,
        "Textiles & Decor": 455,
        "Water Filters & Cartridges": 35
      },
      "Home & Entertainment > Music, Film, Games & Books": {
        "Books": 6789,
        "Christmas Books, CDs & Films": 1,
        "DVDs & Blu-rays": 2248,
        "Games & Accessories": 744,
        "Music": 775
      },
      "Toiletries & Beauty": {
        "Baby & Kids Toiletries": 20,
        "Bath, Shower & Soap": 718,
        "Bladder Weakness": 112,
        "Dental Care": 547,
        "Deodorants & Body Sprays": 332,
        "Fragrance & Gifting": 5,
        "Gifting": 596,
        "Hair Care, Dye & Styling": 2132,
        "Hair Removal & Grooming": 240,
        "Health & Medicines": 84,
        "Health & Wellbeing": 4,
        "Make Up & Nails": 2612,
        "Men's Toiletries": 406,
        "Period Products": 65,
        "Skin Care": 1112,
        "Sun Care & Travel": 580,
        "Toiletries": 11,
        "Women's Toiletries": 348
      },
      "Toiletries & Beauty > Hair Care, Dye & Styling": {
        "Baby & Children's Hair Care": 1,
        "Hair Accessories": 225,
        "Hair Dye": 562,
        "Hair Protection & Treatments": 19,
        "Hairspray & Styling": 177,
        "Shampoo & Conditioner": 1134,
        "Shop By Hair Need": 1,
        "Vegan Hair Care": 1,
        "Waves, Curls & Coils": 12
      },
      "Toiletries & Beauty > Make Up & Nails": {
        "Cosmetics": 2,
        "Eyebrow": 173,
        "Eyes": 450,
        "Face": 856,
        "Get The Festival Look": 1,
        "Lips": 521,
        "Make Up & Beauty Gifts": 19,
        "Nails": 589,
        "Vegan Make Up": 1
      },
      "Toiletries & Beauty > Skin Care": {
        "Body Moisturisers & Lotions": 161,
        "Cleansers & Face Washes": 267,
        "Face Cream & Moisturiser": 328,
        "Face Masks & Strips": 145,
        "Hands, Lips & Foot Care": 168,
        "Medicated Skin Care": 2,
        "New In Skin Care": 1,
        "Popular Brands": 1,
        "Self Tan": 9,
        "Shop by Skin Type": 30
      }
    }
  },
  "store_id": "4565"
}
```
### Illustrative output fields

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

| Path | Observed type | Example |
| --- | --- | --- |
| `categories` | `array` | 3 items |
| `categories` | `array` | 3 items |
| `raw` | `object` | 1 fields |
| `raw.facets` | `object` | 13 fields |
| `store_id` | `string` | 4565 |

## 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/asda/asda.categories.list/openapi.json)
- [Platform OpenAPI 3.1](https://upscrape.com/scrapers/asda/openapi.json)
- [Focused coding-agent prompt](https://upscrape.com/scrapers/asda/capabilities/asda.categories.list/llm.md)