searchCatalogItems

搜索并返回亚马逊目录项目及相关信息的列表。

使用计划：

速率（每秒请求数）	突发
2	2

x-amzn-RateLimit-Limit 响应头返回请求的操作所应用的使用计划速率限制（如果可用）。上表指示了该操作的默认速率和突发值。出于商业需求需要更高吞吐量的销售合作伙伴，可能会看到比此处显示的更高的速率和突发值。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

请求参数

Query 参数

keywords

array[string]

必需

一个用逗号分隔的单词或项目标识符列表，用于在亚马逊目录中进行搜索。

示例值:

shoes

marketplaceIds

array[string]

必需

请求的以逗号分隔的亚马逊市场标识符列表。

<= 1 items

示例值:

ATVPDKIKX0DER

includedData

array[string]

可选

要包括在响应中的数据集的逗号分隔列表。默认值：摘要。

枚举值:

identifiersimagesproductTypessalesRankssummariesvariationsvendorDetails

默认值:

summaries

示例值:

summaries

brandNames

array[string]

可选

以逗号分隔的品牌名称列表，用于限制搜索范围。

示例值:

Beautiful Boats

classificationIds

array[string]

可选

一个以逗号分隔的分类标识符列表，用于限制搜索范围。

示例值:

12345678

pageSize

integer

可选

每页返回的结果数量。

<= 20

默认值:

示例值:

pageToken

string

可选

一个令牌，用于在存在多个结果页面时获取特定页面。

示例值:

sdlkj234lkj234lksjdflkjwdflkjsfdlkj234234234234

keywordsLocale

string

可选

关键词提供的语言。默认为市场的主要语言环境。

示例值:

en_US

locale

string

可选

用于检索本地化摘要的区域设置。默认为市场的主要区域设置。

示例值:

en_US

返回响应

🟢200成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

您对此操作的速率限制（每秒请求数量）。

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

亚马逊目录中的商品及其相关元数据。

numberOfResults

integer

必需

根据搜索查询匹配的估计总产品数量（每次请求仅返回到页面计数限制的结果，无论找到的数量如何）。

注意：可以返回和分页的最大项目（ASIN）数量为1000。

pagination

object (Pagination)

必需

当请求产生的响应超过 pageSize 时，就会发生分页。这意味着响应被划分为单独的页面。要获取下一页或上一页，您必须在下一个请求中将 nextToken 值或 previousToken 值作为 pageToken 参数传递。当您收到最后一页时，分页对象中将没有 nextToken 键。

nextToken

string

可选

可以用来获取下一页的令牌。

previousToken

string

可选

一个可以用来获取上一页的令牌。

refinements

object (Refinements)

搜索优化。

必需

brands

array[object (BrandRefinement) {2}]

品牌搜索优化。

必需

classifications

array[object (ClassificationRefinement) {3}]

分类搜索细化。

必需

items

array[object (Item) {9}]

必需

亚马逊目录中的物品清单。

asin

string

必需

亚马逊标准识别码（ASIN）是亚马逊目录中物品的唯一标识符。

attributes

object (ItemAttributes)

可选

一个包含按属性名称键入的结构化项目属性数据的JSON对象。目录项目属性仅对品牌所有者可用，并符合销售合作伙伴API中可用的相关产品类型定义。

identifiers

array[object (ItemIdentifiersByMarketplace) {2}]

可选

与亚马逊目录中该项目相关的标识符，例如UPC和EAN标识符。

images

array[object (ItemImagesByMarketplace) {2}]

可选

亚马逊目录中商品的图像。所有图像变体都提供给品牌所有者。否则，将提供“主”图像变体的缩略图。

productTypes

array[object (ItemProductTypeByMarketplace) {2}]

可选

与亚马逊目录项相关的产品类型。

salesRanks

array[object (ItemSalesRanksByMarketplace) {2}]

可选

亚马逊目录商品的销售排名。

summaries

array[object (ItemSummaryByMarketplace) {9}]

可选

亚马逊目录商品的摘要详情。

variations

array[object (ItemVariationsByMarketplace) {3}]

可选

亚马逊目录项目的市场变体详细信息（变体关系）。

vendorDetails

array[object (ItemVendorDetailsByMarketplace) {8}]

可选

与亚马逊目录项相关的供应商详细信息。供应商详细信息仅对供应商可用。

示例

{
    "numberOfResults": 3097,
    "pagination": {
        "nextPage": "xsdflkj324lkjsdlkj3423klkjsdfkljlk2j34klj2l3k4jlksdjl234",
        "previousPage": "ilkjsdflkj234lkjds234234lkjl234lksjdflkj234234lkjsfsdflkj333d"
    },
    "refinements": {
        "brands": [
            {
                "numberOfResults": 1,
                "brandName": "Truly Teague"
            },
            {
                "numberOfResults": 20,
                "brandName": "Always Awesome Apparel"
            }
        ],
        "categories": [
            {
                "numberOfResults": 300,
                "displayName": "Electronics",
                "classificationId": "493964"
            },
            {
                "numberOfResults": 4000,
                "displayName": "Tools & Home Improvement",
                "classificationId": "468240"
            }
        ]
    },
    "items": [
        {
            "asin": "B07N4M94X4",
            "identifiers": [
                {
                    "marketplaceId": "ATVPDKIKX0DER",
                    "identifiers": [
                        {
                            "type": "ean",
                            "identifier": "0887276302195"
                        },
                        {
                            "type": "upc",
                            "identifier": "887276302195"
                        }
                    ]
                }
            ],
            "images": [
                {
                    "marketplaceId": "ATVPDKIKX0DER",
                    "images": [
                        {
                            "variant": "MAIN",
                            "link": "https://m.media-amazon.com/images/I/51DZzp3w3vL.jpg",
                            "height": 333,
                            "width": 500
                        }
                    ]
                }
            ],
            "productTypes": [
                {
                    "marketplaceId": "ATVPDKIKX0DER",
                    "productType": "TELEVISION"
                }
            ],
            "salesRanks": [
                {
                    "marketplaceId": "ATVPDKIKX0DER",
                    "ranks": [
                        {
                            "title": "OLED TVs",
                            "link": "http://www.amazon.com/gp/bestsellers/electronics/6463520011",
                            "rank": 3
                        },
                        {
                            "title": "Electronics",
                            "link": "http://www.amazon.com/gp/bestsellers/electronics",
                            "rank": 1544
                        }
                    ]
                }
            ],
            "summaries": [
                {
                    "marketplaceId": "ATVPDKIKX0DER",
                    "brandName": "Samsung Electronics",
                    "browseNode": "6463520011",
                    "colorName": "Black",
                    "itemName": "Samsung QN82Q60RAFXZA Flat 82-Inch QLED 4K Q60 Series (2019) Ultra HD Smart TV with HDR and Alexa Compatibility",
                    "manufacturer": "Samsung",
                    "modelNumber": "QN82Q60RAFXZA",
                    "sizeName": "82-Inch",
                    "styleName": "TV only"
                }
            ],
            "variations": [
                {
                    "marketplaceId": "ATVPDKIKX0DER",
                    "asins": [
                        "B08J7TQ9FL"
                    ],
                    "type": "PARENT"
                }
            ],
            "vendorDetails": [
                {
                    "marketplaceId": "ATVPDKIKX0DER",
                    "brandCode": "SAMF9",
                    "categoryCode": "50400100",
                    "manufacturerCode": "SAMF9",
                    "manufacturerCodeParent": "SAMF9",
                    "productGroup": "Home Entertainment",
                    "replenishmentCategory": "NEW_PRODUCT",
                    "subcategoryCode": "50400150"
                }
            ]
        }
    ]
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

请求参数

示例代码

返回响应