---
title: "Categories"
description: "AliExpress categories — accepted parameters and what comes back."
---

```
GET|POST /v1/aliexpress/categories
```

**Price** $0.001 per call. [List price](https://apinoa.com/en/pricing); the rate steps down above 1,000 calls a day.

| Parameter | Type | Required | Notes |
|---|---|---|---|
| `categoryId` | string |  | Parent category id. Omit for the top-level categories. |

```bash
curl "https://gateway.apinoa.com/v1/aliexpress/categories" -H "x-api-key: YOUR_API_KEY"
```

One call returns the entire taxonomy -- 564 categories with their parents -- so both the roots and
any category's children come back from a single call. There are no paging or locale parameters: every
other shared parameter 400s by name rather than being accepted and ignored.