Product Type Definitions API FAQ
Frequently asked questions about the Product Type Definitions API.
How up-to-date are Amazon Product Type Definitions?
Select to expand the answer.
The Amazon Product Type Definitions describe the latest up-to-date Amazon catalog requirements. To specify a previous version, include productTypeVersion in your request.
What JSON schema version is the Product Type JSON Schema based on?
Select to expand the answer.
Amazon Product Type Definition JSON schemas extend JSON Schema 2019-09. For more information, refer to Amazon Product Type Definition Meta-Schema (v1).
How will future JSON schema versions be implemented?
Select to expand the answer.
Amazon will release a new version of the Product Type Definitions API and the Amazon Product Type Definition Meta-Schema if the JSON schema version is updated. This is because any future schema versions will not be supported by existing versions of the Product Type Definitions API or the Amazon Product Type Definition Meta-Schema.
Is custom vocabulary data validation required?
Select to expand the answer.
Custom validation is recommended but not required. Most Amazon catalog requirements use standard JSON Schema 2019-09 vocabulary. However, some requirements involve extending the JSON schema with custom vocabulary. For more information, refer to the Amazon Product Type Definition Meta-Schema (v1) documentation.
Do I need to implement validation for custom vocabulary?
Select to expand the answer.
No. The Amazon Product Type Definition Meta-Schema (v1) uses custom vocabulary to fully describe Amazon catalog requirements. You have the option to validate the data with custom data before you submit it, which can prevent most listings-related issues.
Do I need custom code to use JSON schemas?
Select to expand the answer.
Yes. The amount of custom code 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
What open-source libraries are available?
Select to expand the answer.
Dozens of open-source libraries and implementations are 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.
What examples are available for validating data with product type schemas?
Select to expand the answer.
The accompanying Amazon Product Type Definition Meta-Schema (v1) documentation includes example integrations with open-source libraries to validate data with a custom vocabulary in .NET (C#), Java, and JavaScript (Node.js).
How do I report issues with Amazon Product Type Definitions?
Select to expand the answer.
For issues that are specific to the Product Type Definitions API or the content of Amazon Product Type Definition JSON schemas, contact Developer Support.
Updated 2 days ago