searchDefinitionsProductTypes

Search for and return a list of Amazon product types that have definitions available.

Usage Plans:

Plan type	Rate (requests per second)	Burst
Default	5	10
Selling partner specific	Variable	Variable

The 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 Selling Partner API.

Request

Query Params

keywords

array[string]

optional

A comma-delimited list of keywords to search product types. Note: Cannot be used with itemName.

Example:

LUGGAGE

marketplaceIds

array[string]

required

A comma-delimited list of Amazon marketplace identifiers for the request.

Example:

["{{MARKET_USA}}"]

itemName

string

optional

The title of the ASIN to get the product type recommendation. Note: Cannot be used with keywords.

Example:

Running shoes

locale

string

optional

The locale for the display names in the response. Defaults to the primary locale of the marketplace.

Example:

en_US

searchLocale

string

optional

The locale used for the keywords and itemName parameters. Defaults to the primary locale of the marketplace.

Example:

en_US

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successfully retrieved a list of Amazon product types that have definitions available.

Headers

x-amzn-RateLimit-Limit

string

optional

Your rate limit (requests per second) for this operation.

x-amzn-RequestId

string

optional

Unique request reference identifier.

Body

A list of Amazon product types with definitions available.

productTypes

array[object (ProductType) {3}]

required

name

string

required

The name of the Amazon product type.

displayName

string

required

The human-readable and localized description of the Amazon product type.

marketplaceIds

array[string]

required

The Amazon marketplace identifiers for which the product type definition is available.

productTypeVersion

string

required

Amazon product type version identifier.

Example

{
    "productTypes": [
        {
            "name": "LUGGAGE",
            "displayName": "Luggage",
            "marketplaceIds": [
                "ATVPDKIKX0DER"
            ]
        }
    ],
    "productTypeVersion": "UHqSqmb4FNUk="
}

🟠400Bad Request

🟠403Forbidden

🟠404Record Not Found

🟠413413

🟠415415

🟠429429

🔴500Server Error

🔴503Service Unavailable