# 1688 API - Get 1688 category info

## API Overview

- Get category information/subcategories/category path by category ID
- Returns all first-level categories when category ID is not provided

## API URL

`GET https://api.tmapi.io/1688/category/info`

## Request Parameters

### Query

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| cat_id | integer | Category ID | false |

> If the category ID is not passed, all first-level categories will be returned by default

## Security Auth

> Please go to [Console-Account Center](https://console.tmapi.io/account/center) to get your apiToken.

> Add your apiToken to the request parameters. Please refer to the examples below.

## Request Example

```bash

curl --request GET 'https://api.tmapi.io/1688/category/info?apiToken=xxxxxx'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "201149004",
    "name": "儿童饰品",
    "name_en": "Children's Jewelry",
    "level": 1,
    "children": [
      {
        "id": "201545016",
        "name": "儿童脚饰",
        "name_en": "Children's Anklets / Foot Jewelry",
        "level": 2,
        "has_children": false
      },
      {
        "id": "201151506",
        "name": "儿童手饰",
        "name_en": "Children's Bracelets / Rings",
        "level": 2,
        "has_children": false
      },
      {
        "id": "201151804",
        "name": "儿童耳饰",
        "name_en": "Children's Earrings",
        "level": 2,
        "has_children": false
      },
      {
        "id": "201230202",
        "name": "儿童发饰",
        "name_en": "Children's Hair Accessories",
        "level": 2,
        "has_children": false
      },
      {
        "id": "201148002",
        "name": "儿童项饰",
        "name_en": "Children's Necklaces",
        "level": 2,
        "has_children": false
      },
      {
        "id": "201229606",
        "name": "其他儿童饰品及配件",
        "name_en": "Other Children's Jewelry & Accessories",
        "level": 2,
        "has_children": false
      }
    ],
    "parent_id": "54",
    "has_children": true,
    "path": [
      {
        "id": "54",
        "name": "服饰配件、饰品",
        "name_en": "Apparel Accessories & Jewelry"
      },
      {
        "id": "201149004",
        "name": "儿童饰品",
        "name_en": "Children's Jewelry"
      }
    ]
  }
}

```