{ "opencollection": "1.0.0", "info": { "name": "Selling Partner API for Product Type Definitions API", "version": "2020-09-01" }, "items": [ { "info": { "name": "definitions", "type": "folder" }, "items": [ { "info": { "name": "searchDefinitionsProductTypes", "type": "http" }, "http": { "method": "GET", "url": "https://sellingpartnerapi-na.amazon.com/definitions/2020-09-01/productTypes", "params": [ { "name": "keywords", "value": "", "type": "query", "description": "A comma-delimited list of keywords to search product types. **Note:** Cannot be used with `itemName`." }, { "name": "marketplaceIds", "value": "", "type": "query", "description": "A comma-delimited list of Amazon marketplace identifiers for the request." }, { "name": "itemName", "value": "", "type": "query", "description": "Title of ASIN to get product type recommendation. **Note:** Cannot be used with `keywords`." }, { "name": "locale", "value": "", "type": "query", "description": "Locale for display names in response. Defaults to primary locale of the marketplace." }, { "name": "searchLocale", "value": "", "type": "query", "description": "Language used for `keywords` or `itemName` parameters. Defaults to primary locale of the marketplace." } ] }, "docs": "Search for and return a list of Amazon product types that have definitions available.\n\n**Usage Plans:**\n\n| Plan type | Rate (requests per second) | Burst |\n| ---- | ---- | ---- |\n|Default| 5 | 10 |\n|Selling partner specific| Variable | Variable |\n\nThe x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, " }, { "info": { "name": "getDefinitionsProductType", "type": "http" }, "http": { "method": "GET", "url": "https://sellingpartnerapi-na.amazon.com/definitions/2020-09-01/productTypes/:productType", "params": [ { "name": "productType", "value": "", "type": "path", "description": "The Amazon product type name." }, { "name": "sellerId", "value": "", "type": "query", "description": "A selling partner identifier. When provided, seller-specific requirements and values are populated within the product type definition schema, such as brand names associated with the selling partner." }, { "name": "marketplaceIds", "value": "", "type": "query", "description": "A comma-delimited list of Amazon marketplace identifiers for the request.\nNote: This parameter is limited to one marketplaceId at this time." }, { "name": "productTypeVersion", "value": "", "type": "query", "description": "The version of the Amazon product type to retrieve. Defaults to \"LATEST\". Prerelease versions of product type definitions may be retrieved with \"RELEASE_CANDIDATE\". If no prerelease version is currently available, the \"LATEST\" live version will be provided." }, { "name": "requirements", "value": "", "type": "query", "description": "The name of the requirements set to retrieve requirements for." }, { "name": "requirementsEnforced", "value": "", "type": "query", "description": "Identifies if the required attributes for a requirements set are enforced by the product type definition schema. Non-enforced requirements enable structural validation of individual attributes without all the required attributes being present (such as for partial updates)." }, { "name": "locale", "value": "", "type": "query", "description": "Locale for retrieving display labels and other presentation details. Defaults to the default language of the first marketplace in the request." }, { "name": "parentageLevel", "value": "", "type": "query", "description": "The parentage level of the listing to retrieve a schema for. When provided, the schema is simplified by resolving all conditional logic related to the specified parentage level, resulting in a smaller schema with fewer conditions." } ] }, "docs": "Retrieve an Amazon product type definition.\n\n**Usage Plans:**\n\n| Plan type | Rate (requests per second) | Burst |\n| ---- | ---- | ---- |\n|Default| 5 | 10 |\n|Selling partner specific| Variable | Variable |\n\nThe x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see [Usage Plans and Rate Limits in the Se" } ] } ], "bundled": true }