# Category tree

Retrieve Meesho navigation categories.

- Platform: [Meesho Catalog](https://docs.upscrape.com/docs/platforms/meesho)
- Capability ID: `meesho.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 $UPSCRAPE_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Prefer: wait=30" \
  --data '{
  "input": {},
  "capability": "meesho.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
{
  "categories": [
    {
      "children": [
        {
          "children": [
            {
              "icon_url": "https://images.meesho.com/images/marketing/1727197481998.png",
              "id": 709,
              "page_id": "3u77",
              "page_path": "top-brands",
              "title": "Top Brands"
            },
            {
              "icon_url": "https://images.meesho.com/images/marketing/1755006760129.png",
              "id": 710,
              "page_id": "6myd",
              "page_path": "shimla-apples",
              "title": "Shimla Apples"
            }
          ],
          "id": 61,
          "title": "Featured On Meesho"
        },
        {
          "children": [
            {
              "icon_url": "https://images.meesho.com/images/marketing/1697424924417.jpg",
              "id": 711,
              "page_id": "9tx",
              "page_path": "jewellery",
              "title": "Jewellery"
            },
            {
              "icon_url": "https://images.meesho.com/images/marketing/1697424940664.jpg",
              "id": 712,
              "page_id": "1iue",
              "page_path": "men-fashion",
              "title": "Men Fashion"
            },
            {
              "icon_url": "https://images.meesho.com/images/marketing/1697424958218.jpg",
              "id": 713,
              "page_id": "9ok",
              "page_path": "kids-clothing",
              "title": "Kids"
            }
          ],
          "id": 62,
          "title": "All Popular"
        }
      ],
      "icon_url": "https://images.meesho.com/images/android/popular_images.png",
      "id": 20,
      "title": "Popular"
    },
    {
      "children": [
        {
          "children": [
            {
              "icon_url": "https://images.meesho.com/images/marketing/1663324521306.png",
              "id": 725,
              "page_id": "3iy",
              "page_path": "sarees",
              "title": "All Sarees"
            },
            {
              "icon_url": "https://images.meesho.com/images/marketing/1663325138869.png",
              "id": 726,
              "page_id": "3m1",
              "page_path": "georgette-sarees",
              "title": "Georgette Sarees"
            },
            {
              "icon_url": "https://images.meesho.com/images/marketing/1663325379522.png",
              "id": 727,
              "page_id": "1ocy",
              "page_path": "chiffon-saree",
              "title": "Chiffon Sarees"
            }
          ],
          "id": 63,
          "title": "Sarees"
        },
        {
          "children": [
            {
              "icon_url": "https://images.meesho.com/images/marketing/1661506236402.png",
              "id": 733,
              "page_id": "3j0",
              "page_path": "women-kurtis",
              "title": "All Kurtis"
            },
            {
              "icon_url": "https://images.meesho.com/images/marketing/1661506126751.png",
              "id": 734,
              "page_id": "4pn",
              "page_path": "anarkali-kurtis",
              "title": "Anarkali Kurtis"
            },
            {
              "icon_url": "https://images.meesho.com/images/marketing/1661506138169.png",
              "id": 735,
              "page_id": "1n49",
              "page_path": "women-rayon-kurtis",
              "title": "Rayon Kurtis"
            }
          ],
          "id": 64,
          "title": "Kurtis"
        },
        {
          "children": [
            {
              "icon_url": "https://images.meesho.com/images/marketing/1661506167398.png",
              "id": 739,
              "page_id": "1oqs",
              "page_path": "men-kurta-sets",
              "title": "All Kurta Sets"
            },
            {
              "icon_url": "https://images.meesho.com/images/marketing/1661506072465.png",
              "id": 740,
              "page_id": "889",
              "page_path": "kurta-palazzo-set",
              "title": "Kurta Palazzo Sets"
            },
            {
              "icon_url": "https://images.meesho.com/images/marketing/1661506060517.png",
              "id": 741,
              "page_id": "88k",
              "page_path": "kurta-pant-set",
              "title": "Kurta Pant Sets"
            }
          ],
          "id": 65,
          "title": "Kurta Sets"
        }
      ],
      "icon_url": "https://images.meesho.com/images/android/women_ethnic_images.png",
      "id": 21,
      "page_id": "4aus",
      "page_path": "western-wear-women",
      "title": "Kurti, Saree & Lehenga"
    },
    {
      "children": [
        {
          "children": [
            {
              "icon_url": "https://images.meesho.com/images/marketing/1628494884141.png",
              "id": 769,
              "page_id": "4aus",
              "page_path": "western-wear-women",
              "title": "All Topwear"
            },
            {
              "icon_url": "https://images.meesho.com/images/marketing/1628494936705.png",
              "id": 770,
              "page_id": "3ja",
              "page_path": "tops-ladies",
              "title": "Tops & Tunics"
            },
            {
              "icon_url": "https://images.meesho.com/images/marketing/1628496536829.png",
              "id": 771,
              "page_id": "4ah",
              "page_path": "dresses-women",
              "title": "Dresses"
            }
          ],
          "id": 72,
          "title": "Topwear"
        },
        {
          "children": [
            {
              "icon_url": "https://images.meesho.com/images/marketing/1628498099046.png",
              "id": 778,
              "page_id": "4auu",
              "page_path": "bottom-western-wear-women",
              "title": "All Bottomwear"
            },
            {
              "icon_url": "https://images.meesho.com/images/marketing/1627307893747.png",
              "id": 779,
              "page_id": "3ant",
              "page_path": "regular-fit-jeans-jeggings",
              "title": "Jeans & Jeggings"
            },
            {
              "icon_url": "https://images.meesho.com/images/marketing/1628498166606.png",
              "id": 780,
              "page_id": "3jb",
              "page_path": "palazzo-pants",
              "title": "Palazzos"
            }
          ],
          "id": 73,
          "title": "Bottom Wear"
        },
        {
          "children": [
            {
              "icon_url": "https://images.meesho.com/images/marketing/1731634354390.png",
              "id": 784,
              "page_id": "3tcy",
              "page_path": "jackets-women",
              "title": "Jackets"
            },
            {
              "icon_url": "https://images.meesho.com/images/marketing/1731634457033.png",
              "id": 785,
              "page_id": "8hf",
              "page_path": "sweatshirts-women",
              "title": "Sweatshirts"
            },
            {
              "icon_url": "https://images.meesho.com/images/marketing/1731634542294.png",
              "id": 786,
              "page_id": "8jb",
              "page_path": "sweaters-women",
              "title": "Sweaters"
            }
          ],
          "id": 74,
          "title": "Winterwear"
        }
      ],
      "icon_url": "https://images.meesho.com/images/android/women_western_wear_images.png",
      "id": 22,
      "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 |
| --- | --- | --- |
| `categories` | `array` | 3 items |
| `categories` | `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)
