Product Type Definitions API

You use the Product Type Definitions API to search and retrieve attribute and data requirements for product types in the Amazon catalog. Amazon Product Type Definitions describe the attribute and data requirements for items in the Amazon catalog using JSON schemas.

Refer to the Product Type Definitions API v2020-09-01 Reference for details about API operations and associated data types and schemas.

Release notes

• December 13, 2023
• November 8, 2023
• April 19, 2023

To learn more about the terms that are used on this page, refer to Terminology.

Use cases

The following use case examples are available for the Product Type Definitions API:

• Search available Product Type Definitions: Search and identify Amazon product types available in the Product Type Definitions API for a given Amazon marketplace and type of selling partner account.
• Get Product Type Definition recommendations: Get Amazon product type recommendations from the Product Type Definitions API for a given Amazon marketplace, type of selling partner account, and item name.
• Retrieve a Product Type Definition: Return Amazon Product Type Definitions and related schemas from the Product Type Definitions API for a given selling partner, Amazon product type, and Amazon marketplace.

⭐

Tip

Unless you specify a previous productTypeVersion, the Amazon Product Type Definitions always describe the latest up-to-date Amazon catalog requirements.

Roles

getDefinitionsProductType

Attribute	Value
Regions	NA, EU, FE
Required roles (need at least one)	Inventory and Order Tracking Product Listing

searchDefinitionsProductTypes

Attribute	Value
Regions	NA, EU, FE
Required roles (need at least one)	Inventory and Order Tracking Product Listing

JSON schema support

Amazon Product Type Definition JSON schemas extend JSON Schema 2019-09. If future versions of JSON Schema are adopted by the Product Type Definitions API, they will be accompanied by a new Product Type Definitions API version release and Amazon Product Type Definition Meta-Schema.

Most Amazon catalog requirements use standard JSON Schema 2019-09 vocabulary. The Amazon Product Type Definition Meta-Schema also uses custom vocabulary to fully describe Amazon catalog requirements. Custom vocabulary data validation is recommended but not required.

Validating data with custom data prevents most listings-related issues from occurring before submitting to Amazon. However, it is up to you to implement such validation.

The amount of custom code required depends on your application. Refer to the following JSON schema validation use cases for examples of when custom code is needed:

• Open-source library with validation of custom vocabulary

  • Retrieve schemas from the Product Type Definitions API
  • Implement validation of custom vocabulary
  • Integrate with the open-source library

• Open-source library without validation of custom vocabulary

  • Retrieve schemas from the Product Type Definitions API
  • Integrate with the open-source library

For more information, refer to the Amazon Product Type Definition Meta-Schema (v1) documentation, which includes example integrations with open-source libraries to validate data with a custom vocabulary in .NET (C#), Java, and JavaScript (Node.js).

Open-source libraries

There are dozens of open-source libraries and implementations available to validate data, render user interfaces, and generate code. For a complete list, refer to JSON Schema Tooling.

Amazon does not directly support or endorse any specific open-source or commercial libraries and implementations. Examples provided in this documentation are for reference only.