Important
New shipment package stream endpoint is available

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

HomeGuidesAPI ReferenceChangelogSupport Request
Guides

Trendyol Category List

The categoryId information will be obtained using this service.

  • You need to send "storeFrontCode" as Header Parameter.
  • In order to retrieve category tree in Romanian, Greek and Arabic language, you can add "Accept-Language" as Header Parameter.
    • ro is used for retrieving in the Romanian language on the RO storefront
    • el is used for listing in the Greek language on the GR storefront
    • ar is used for retrieving in the Arabic language on the SA and AE storefronts
    • In case you don't add Accept-Language as Header Parameter or you put en; data will be returned in English.
  • 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