Category API

Category powered requests 

The Zonos Category API powers Classify by allowing users to select preset categories and subcategories to strengthen their Classify requests. The categories in this API are tied to corresponding HS codes, guiding Classify in selecting an HS code within the category and subcategory.

If you have difficulty providing rich product detail fields to generate classifications, these preset categories can be a powerful tool to enhance your classification results.

E.g., if a user’s input for a gardening pruner is something vague like tool, Classify will resolve to a construction tool classification. But if the user enriches their request with categories like Home & Garden and Other Outdoor & Garden Items, it will result in a more accurate classification within those categories.

Retrieve categories 

If you are utilizing Zonos' preset list of categories to power your classifications, use the endpoint below to retrieve a complete list of Zonos categories and subcategories. Once you retrieve the list, you can use the provided categories and subcategories to power your classification requests via Classify’s category and subcategory input fields.

GET https://api.zonos.com/v1/classify/zonosCategories

{
  "categories": [
    {
      "name": "Appliances, Parts & Accessories",
      "subCategories": [
        {
          "name": "Air Compressors"
        },
        {
          "name": "Bathroom Appliances"
        },
        {
          "name": "Clothing Iron"
        }
      ]
    },
    {
      "name": "Arts & Collectibles",
      "subCategories": [
        {
          "name": "Antique Hand-Painted & Hand-Drawn Art"
        },
        {
          "name": "Antiques Over 100 Years Old"
        },
        {
          "name": "Clothing Iron"
        }
      ]
    },
    {
      "name": "Automotive & Vehicles",
      "subCategories": [
        {
          "name": "Aircraft & Parts"
        },
        {
          "name": "Bicycles & Accessories"
        },
        {
          "name": "Car, Truck & Tractor Parts"
        }
      ]
    }
  ]
}