Important
New shipment package stream endpoint is available

For large-scale scanning and synchronization flows, please prefer getShipmentPackagesStream.

HomeGuidesAPI ReferenceChangelogSupport Request
Guides

6. Trendyol Category List

The categoryId information will be obtained using this service.

  • You need to send "storeFrontCode" as Header Parameter.
  • There is no additional query param for this request.
  • Category ID information should be used at the lowest level ("subCategories": []) to create createProduct. If there are subcategories of the category you select, you cannot transfer products with this category.
❗️

Stage and prod environment have different ids. For instance categoryId information in stage and prod can differ. You should use our prod services while mapping your ids for the prod environment

🟩

The product category tree is updated at regular time periods. If you use an outdated category tree, you may enter incomplete or incorrect data. For this reason, you must use the up-to-date category tree before each transaction.

HTTP method: GET

Sample Service Response

{
  "id": 368,
  "name": "Accessory",
  "parentId": null,
  "subCategories": [
    {
      "id": 387,
      "name": "Watch",
      "parentId": 368,
      "subCategories": []
    },
    {
      "id": 384,
      "name": "Beanie",
      "parentId": 368,
      "subCategories": []
    },
    {
      "id": 396,
      "name": "Ornaments & Jewelry",
      "parentId": 1162,
      "subCategories": [
        {
          "id": 397,
          "name": "Wristbands",
          "parentId": 396,
          "subCategories": [
            {
              "id": 1238,
              "name": "Gold Bracelet",
              "parentId": 397,
              "subCategories": []
            }
          ]
        }
      ]
    }
  ]
}

Filter Parameter

ParametreDescription
nameCategory Name

You can use the name parameter to filter categories using a specific keyword. The response will return the category names at all levels where the keyword you entered appears.


Filter Parameters

ParameterDescription
IdCategory's ID in Trendyol platform
ParentIdUpper-level category ID
NameCategory Name
subcategoriesLowest level categories