# Category tree

Retrieve Meesho navigation categories.

- Platform: [Meesho Catalog](https://docs.upscrape.com/docs/platforms/meesho)
- Capability ID: `catalog.categories`
- 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 --request POST \
  --url https://data.upscrape.com/execute \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Prefer: wait=30" \
  --data '{
  "input": {},
  "capability": "catalog.categories"
}'
```

## Input

This capability accepts an empty input object.

### Example input

```json
{}
```

## 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
{
  "navUrls": [
    {
      "title": "Top Brands",
      "url": "/top-brands/pl/3u77"
    },
    {
      "title": "Shimla Apples",
      "url": "/shimla-apples/pl/6myd"
    },
    {
      "title": "Jewellery",
      "url": "/jewellery/pl/9tx"
    }
  ],
  "payload": {
    "level_1": [
      {
        "category_icon": "https://images.meesho.com/images/android/popular_images.png",
        "id": 20,
        "level_2": [
          {
            "id": 61,
            "level_3": [
              {
                "category_icon": "https://images.meesho.com/images/marketing/1727197481998.png",
                "id": 709,
                "page": {
                  "page_id": "3u77",
                  "slug": "top-brands",
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "Top Brands"
              },
              {
                "category_icon": "https://images.meesho.com/images/marketing/1755006760129.png",
                "id": 710,
                "page": {
                  "page_id": "6myd",
                  "slug": "shimla-apples",
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "Shimla Apples"
              }
            ],
            "title": "Featured On Meesho"
          },
          {
            "id": 62,
            "level_3": [
              {
                "category_icon": "https://images.meesho.com/images/marketing/1697424924417.jpg",
                "id": 711,
                "page": {
                  "page_id": "9tx",
                  "slug": "jewellery",
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "Jewellery"
              },
              {
                "category_icon": "https://images.meesho.com/images/marketing/1697424940664.jpg",
                "id": 712,
                "page": {
                  "page_id": "1iue",
                  "slug": "men-fashion",
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "Men Fashion"
              },
              {
                "category_icon": "https://images.meesho.com/images/marketing/1697424958218.jpg",
                "id": 713,
                "page": {
                  "page_id": "9ok",
                  "slug": "kids-clothing",
                  "ss_id": [
                    "1141",
                    "4398",
                    "4439"
                  ],
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "Kids"
              }
            ],
            "title": "All Popular"
          }
        ],
        "title": "Popular"
      },
      {
        "category_icon": "https://images.meesho.com/images/android/women_ethnic_images.png",
        "id": 21,
        "level_2": [
          {
            "id": 63,
            "level_3": [
              {
                "category_icon": "https://images.meesho.com/images/marketing/1663324521306.png",
                "id": 725,
                "page": {
                  "page_id": "3iy",
                  "slug": "sarees",
                  "ss_id": [
                    "1004"
                  ],
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "All Sarees"
              },
              {
                "category_icon": "https://images.meesho.com/images/marketing/1663325138869.png",
                "id": 726,
                "page": {
                  "page_id": "3m1",
                  "slug": "georgette-sarees",
                  "ss_id": [
                    "1004"
                  ],
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "Georgette Sarees"
              },
              {
                "category_icon": "https://images.meesho.com/images/marketing/1663325379522.png",
                "id": 727,
                "page": {
                  "page_id": "1ocy",
                  "slug": "chiffon-saree",
                  "ss_id": [
                    "1004"
                  ],
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "Chiffon Sarees"
              }
            ],
            "title": "Sarees"
          },
          {
            "id": 64,
            "level_3": [
              {
                "category_icon": "https://images.meesho.com/images/marketing/1661506236402.png",
                "id": 733,
                "page": {
                  "page_id": "3j0",
                  "slug": "women-kurtis",
                  "ss_id": [
                    "1001"
                  ],
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "All Kurtis"
              },
              {
                "category_icon": "https://images.meesho.com/images/marketing/1661506126751.png",
                "id": 734,
                "page": {
                  "page_id": "4pn",
                  "slug": "anarkali-kurtis",
                  "ss_id": [
                    "1001"
                  ],
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "Anarkali Kurtis"
              },
              {
                "category_icon": "https://images.meesho.com/images/marketing/1661506138169.png",
                "id": 735,
                "page": {
                  "page_id": "1n49",
                  "slug": "women-rayon-kurtis",
                  "ss_id": [
                    "5616",
                    "1001"
                  ],
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "Rayon Kurtis"
              }
            ],
            "title": "Kurtis"
          },
          {
            "id": 65,
            "level_3": [
              {
                "category_icon": "https://images.meesho.com/images/marketing/1661506167398.png",
                "id": 739,
                "page": {
                  "page_id": "1oqs",
                  "slug": "men-kurta-sets",
                  "ss_id": [
                    "3038",
                    "1201"
                  ],
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "All Kurta Sets"
              },
              {
                "category_icon": "https://images.meesho.com/images/marketing/1661506072465.png",
                "id": 740,
                "page": {
                  "page_id": "889",
                  "slug": "kurta-palazzo-set",
                  "ss_id": [
                    "1139",
                    "1003"
                  ],
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "Kurta Palazzo Sets"
              },
              {
                "category_icon": "https://images.meesho.com/images/marketing/1661506060517.png",
                "id": 741,
                "page": {
                  "page_id": "88k",
                  "slug": "kurta-pant-set",
                  "ss_id": [
                    "1139",
                    "1003"
                  ],
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "Kurta Pant Sets"
              }
            ],
            "title": "Kurta Sets"
          }
        ],
        "page": {
          "page_id": "4aus",
          "slug": "western-wear-women",
          "ss_id": [
            "79",
            "1289",
            "1024"
          ],
          "type": "PRODUCT_LISTING_PAGE"
        },
        "title": "Kurti, Saree & Lehenga"
      },
      {
        "category_icon": "https://images.meesho.com/images/android/women_western_wear_images.png",
        "id": 22,
        "level_2": [
          {
            "id": 72,
            "level_3": [
              {
                "category_icon": "https://images.meesho.com/images/marketing/1628494884141.png",
                "id": 769,
                "page": {
                  "page_id": "4aus",
                  "slug": "western-wear-women",
                  "ss_id": [
                    "79",
                    "1289",
                    "1024"
                  ],
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "All Topwear"
              },
              {
                "category_icon": "https://images.meesho.com/images/marketing/1628494936705.png",
                "id": 770,
                "page": {
                  "page_id": "3ja",
                  "slug": "tops-ladies",
                  "ss_id": [
                    "1020"
                  ],
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "Tops & Tunics"
              },
              {
                "category_icon": "https://images.meesho.com/images/marketing/1628496536829.png",
                "id": 771,
                "page": {
                  "page_id": "4ah",
                  "slug": "dresses-women",
                  "ss_id": [
                    "1025"
                  ],
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "Dresses"
              }
            ],
            "title": "Topwear"
          },
          {
            "id": 73,
            "level_3": [
              {
                "category_icon": "https://images.meesho.com/images/marketing/1628498099046.png",
                "id": 778,
                "page": {
                  "page_id": "4auu",
                  "slug": "bottom-western-wear-women",
                  "ss_id": [
                    "1032",
                    "1033",
                    "1034"
                  ],
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "All Bottomwear"
              },
              {
                "category_icon": "https://images.meesho.com/images/marketing/1627307893747.png",
                "id": 779,
                "page": {
                  "page_id": "3ant",
                  "slug": "regular-fit-jeans-jeggings",
                  "ss_id": [
                    "1154",
                    "1033",
                    "1032"
                  ],
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "Jeans & Jeggings"
              },
              {
                "category_icon": "https://images.meesho.com/images/marketing/1628498166606.png",
                "id": 780,
                "page": {
                  "page_id": "3jb",
                  "slug": "palazzo-pants",
                  "ss_id": [
                    "1039"
                  ],
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "Palazzos"
              }
            ],
            "title": "Bottom Wear"
          },
          {
            "id": 74,
            "level_3": [
              {
                "category_icon": "https://images.meesho.com/images/marketing/1731634354390.png",
                "id": 784,
                "page": {
                  "page_id": "3tcy",
                  "slug": "jackets-women",
                  "ss_id": [
                    "1023"
                  ],
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "Jackets"
              },
              {
                "category_icon": "https://images.meesho.com/images/marketing/1731634457033.png",
                "id": 785,
                "page": {
                  "page_id": "8hf",
                  "slug": "sweatshirts-women",
                  "ss_id": [
                    "1028"
                  ],
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "Sweatshirts"
              },
              {
                "category_icon": "https://images.meesho.com/images/marketing/1731634542294.png",
                "id": 786,
                "page": {
                  "page_id": "8jb",
                  "slug": "sweaters-women",
                  "ss_id": [
                    "1026"
                  ],
                  "type": "PRODUCT_LISTING_PAGE"
                },
                "title": "Sweaters"
              }
            ],
            "title": "Winterwear"
          }
        ],
        "title": "Women Western"
      }
    ]
  }
}
```
### Illustrative output fields

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

| Path | Observed type | Example |
| --- | --- | --- |
| `navUrls` | `array` | 3 items |
| `navUrls` | `array` | 3 items |
| `payload` | `object` | 1 fields |
| `payload.level_1` | `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`. 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)
