Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation

Deprecation Notice:

Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.

Amazon MWS Documentation

GetProductCategoriesForSKU

Returns the parent product categories that a product belongs to, based on SellerSKU.

Description

The GetProductCategoriesForSKU operation returns the product category name and identifier that a product belongs to, including parent categories back to the root for the marketplace.

Availability

This operation is available in all marketplaces.

Throttling

Maximum request quota Restore rate Hourly request quota
20 requests One request every five seconds 720 requests per hour
This quota and restore rate is shared with GetProductCategoriesForASIN. Operations in the Products API section that send lists of items as input parameters have restore rates that are measured by item. For information on per-item throttling, see Throttling in the Products API. For definitions of throttling terminology and for a complete explanation of throttling, see Throttling: Limits to how often you can submit requests in the Amazon MWS Developer Guide.

Request parameters

For more information about the request parameters that are required for all Amazon MWS operations, see Required request parameters in the Amazon MWS Developer Guide.

Name Description Required Valid values
MarketplaceId A marketplace identifier. Specifies the marketplace from which category structures are returned.

Type: xs:string

Yes For a list of MarketplaceId values, see Amazon MWS endpoints and MarketplaceId values in the Amazon MWS Developer Guide.
SellerSKU Used to identify products in the given marketplace. SellerSKU is qualified by your SellerId, which is included with every Amazon Marketplace Web Service (Amazon MWS) operation that you submit.

Type: xs:string

Yes  

Response elements

Name Description
Self Contains the ProductCategoryId for the product that you submitted. Also contains a ProductCategoryId for each of the parent categories of the product, up to the root for the Marketplace.
ProductCategoryId Identifier for a product category (or browse node).
ProductCategoryName Name of a product category (or browse node).

Examples

Example query request

For information about standard request requirements, see Required request parameters.

Show example code Hide example code

POST /Products/2011-10-01 HTTP/1.1
Content-Type: x-www-form-urlencoded
Host: mws.amazonservices.com
User-Agent: <Your User Agent Header>

AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ
&Action=GetProductCategoriesForSKU
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&MarketplaceId=ATVPDKIKX0DER
&SellerId=A1IMEXAMPLEWRC
&SellerSKU=SKU2468
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2012-12-04T22%3A48%3A25Z
&Version=2011-10-01
&Signature=nLBMEXAMPLE6ASMKD1YTcNk7E8vW6Qzha8cEXAMPLEY%3D

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<?xml version="1.0"?>
<GetProductCategoriesForSKUResponse
    xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
    <GetProductCategoriesForSKUResult>
        <Self>
            <ProductCategoryId>271578011</ProductCategoryId>
            <ProductCategoryName>Project Management</ProductCategoryName>
            <Parent>
                <ProductCategoryId>2675</ProductCategoryId>
                <ProductCategoryName>Management &#x26; Leadership</ProductCategoryName>
                <Parent>
                    <ProductCategoryId>3</ProductCategoryId>
                    <ProductCategoryName>Business &#x26; Investing</ProductCategoryName>
                    <Parent>
                        <ProductCategoryId>1000</ProductCategoryId>
                        <ProductCategoryName>Subjects</ProductCategoryName>
                        <Parent>
                            <ProductCategoryId>283155</ProductCategoryId>
                            <ProductCategoryName>Subjects</ProductCategoryName>
                        </Parent>
                    </Parent>
                </Parent>
            </Parent>
        </Self>
        <Self>
            <ProductCategoryId>684248011</ProductCategoryId>
            <ProductCategoryName>Management</ProductCategoryName>
            <Parent>
                <ProductCategoryId>468220</ProductCategoryId>
                <ProductCategoryName>Business &#x26; Finance</ProductCategoryName>
                <Parent>
                    <ProductCategoryId>465600</ProductCategoryId>
                    <ProductCategoryName>New, Used &#x26; Rental Textbooks</ProductCategoryName>
                    <Parent>
                        <ProductCategoryId>2349030011</ProductCategoryId>
                        <ProductCategoryName>Specialty Boutique</ProductCategoryName>
                        <Parent>
                            <ProductCategoryId>283155</ProductCategoryId>
                            <ProductCategoryName>Specialty Boutique</ProductCategoryName>
                        </Parent>
                    </Parent>
                </Parent>
            </Parent>
        </Self>
    </GetProductCategoriesForSKUResult>
    <ResponseMetadata>
        <RequestId>e058aabd-b4c3-48ba-9bfa-EXAMPLE9a267</RequestId>
    </ResponseMetadata>
</GetProductCategoriesForSKUResponse>

↑ Top