目录项目API v2020-12-01用例指南

亚马逊SPAPI

# API版本: 2020-12-01

# 什么是目录物品API?

使用Selling Partner API for Catalog Items (Catalog Items API),您可以检索亚马逊目录中的物品信息.参见Catalog Items API Reference (opens new window),了解有关API操作和相关数据类型和模式的详细信息.

主要特点 检索详细的项目信息目录物品API提供了关于亚马逊目录中物品的详细信息,如汇总的物品细节、产品标识符、销售排名、变化和缩略图.供应商可以检索额外的供应商-特定细节,物品的品牌所有者可以检索额外的属性和图像内容. 搜索项目目录物品API允许你使用关键字在亚马逊目录中搜索现有物品,包括产品标识符.

术语 ASIN: 亚马逊标准识别码,用于识别亚马逊目录中的物品. 变体一个目录商品的每一种颜色或尺寸都代表着一个变体,它被分配了一个不同的ASIN.它们被归类为一个父ASIN的变体.

# Tutorial: 检索亚马逊目录中某一商品的详细信息

使用本教程来检索亚马逊目录中某一商品的信息,并给定ASIN和市场.

先决条件

要完成本教程,你需要

# 步骤1:获取一个目录项目的信息

Call the getCatalogItem (opens new window) operation, passing the following parameters:

请求参数

路径参数

Parameter 实例 Description 要求
asin XXXXXXXX</code 感兴趣的物品的亚马逊标准识别码.

类型: string

是的

查询参数

Parameter 实例 Description 要求
marketplaceIds <代码>ATVPDKIKX0DER</代码 A comma-delimited list of Amazon marketplace identifiers.

请看 销售伙伴API开发者指南 的亚马逊市场标识符列表.

Type< string > array(csv)

是的
includedData summaries一个以逗号分隔的项目细节列表,用于请求.如果没有指定,将默认为返回 summaries
  • attributes
  • <代码>标识符</代码 - 外部物品标识符,如EAN、UPC、ISBN等.
  • images
  • productTypes
  • salesRanks
  • summaries
  • variations
  • vendorDetails

类型< enum (IncludedData) > array(csv)

没有
<代码>locale</代码 <代码>en_US</代码 用于检索本地化摘要的locale.默认为市场的主要locale.

类型: string

没有

示例请求

GET https://sellingpartnerapi-na.amazon.com/catalog/2020-12-01/items/XXXXXXXXXX
   .marketplaceIds=ATVPDKIKX0DER
   &amp;includedData=属性,标识符,图像,产品类型,销售排名,摘要,变化,供应商细节
1
2
3

响应

一个成功的响应包括以下内容

姓名 实例 Description
asin XXXXXXXX要求的ASIN.

类型ItemAsin

属性 参见响应示例 一个JSON对象,包含详细的目录项目数据.来自多个市场的值被卷进每个属性名称下的一个列表.

类型ItemAttributes

标识符 参见响应示例 外部标识符,如UPC、EAN等.,如果适用.

类型ItemIdentifiers

图像 参见响应示例 item.

Type的图像数据ItemImages

productTypes参见响应示例 该商品在亚马逊目录中的产品类型类别.

类型ItemProductTypes

ranks 参见响应示例 该物品在其被追踪的每个类别中的销售排名数据.

类型ItemSalesRanks

summaries 参见响应示例 Summary of item data.

Type: ItemSummaries

变体 参见响应示例 与此相关的其他ASIN,以及这个是父ASIN还是子ASIN.

类型ItemVariations

vendorDetails参见响应示例 此产品的详细供应商信息.

类型ItemVendorDetails

示例响应

{
  "asin": "B07N4M94X4",
  "属性": {
    "total_hdmi_ports": [
      {
        "值": 4,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "决议": [
      {
        "language_tag": "en_US",
        "值": "4K",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "item_weight": [
      {
        "单位": "磅",
        "值": 107.6,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "product_subcategory": [
      {
        "值": "50400150",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "item_dimensions": [
      {
        "宽度": {
          "单位": "英寸",
          "值": 72.4
        },
        "长度": {
          "单位": "英寸",
          "值": 2.4
        },
        "高度": {
          "单位": "英寸",
          "值": 41.4
        },
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "品牌": [
      {
        "language_tag": "en_US",
        "值": "三星电子"
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "generic_keyword": [
      {
        "language_tag": "en_US",
        "值": "智能电视;4K电视;ROKU电视;LG电视;OLED电视;65英寸智能电视;65英寸4K电视;LG智能电视;Nvidia盾牌电视2018;电视4K;OLED电视65;索尼4K电视;4K智能电视;4K HDR电视;Nvidia盾牌电视;游戏电视;LG 65英寸4K电视;电视65英寸智能电视4K;65英寸4K电视;索尼65英寸4K电视;VIZIO 4K电视;UHD电视;UHD电视4K"
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "LG OLED;65英寸智能电视;三星QLED 75英寸电视;85英寸4K电视;LG智能电视;4K电视65英寸;三星QLED 82英寸电视;8K电视;LG OLED 65;LG智能电视;三星QLED 65英寸;80英寸4K电视;索尼4K电视;Nvidia Shield电视2018"
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "三星q9fn qled 2018; vizio; lg oled; lg 4k; sony 4k; sony oled; toshiba; antenna; dvd player; outdoor tv; kitchen tv; fire tv; firetv; hdtv; hd tv; android; shield tv; gaming; deals; tv ears; roku; dvr; speakers; digital tv antenna; apple TV; android tv; frame; mount",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "4K高清电视;70英寸电视;NVIDIA盾牌电视;90英寸电视;游戏电视;75英寸电视;LG 65英寸4K电视;65英寸智能电视4K;65英寸4K电视;Sony 65英寸4K电视;Vizio 4K电视;UHD电视;UHD电视4K;"
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "control_method": [
      {
        "值": "语音",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    " item_package_dimensions": [
      {
        "长度": {
          "单位": "cmeters",
          "值": 26.67
        },
        "宽度": {
          "单位": "厘米",
          "值": 121.92
        },
        "高度": {
          "单位": "厘米",
          "值": 203.2
        },
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "image_aspect_ratio": [
      {
        "language_tag": "en_US",
        "value": "16:9",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "part_number": [
      {
        "值": "qn82q60rafxza",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "including_remote": [
      {
        "value": true,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "item_type_name": [
      {
        "language_tag": "en_US",
        "值": "TV",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "电池": [
      {
        "cell_composition": [
          {
            "值""碱性"
          }
        ],
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "制造商": [
      {
        "language_tag": "en_US",
        "值": "三星",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "number_of_boxes": [
      {
        "值": 1,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "total_usb_ports": [
      {
        "值": 2,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "model_number": [
      {
        "值": "qn82q60rafxza",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "supplier_declared_dg_hz_regulation": [
      {
        "值": "not_applicable",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "num_batteries": [
      {
        "数量": 2,
        "类型": "aaa",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "California_proposition_65": [
      {
        "compliance_type": "on_product_combined_cancer_reproductive",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "compliance_type": "化学"
        "chemical_names": [
          "2-乙基己基邻苯二甲酸二酯"
        ],
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "显示": [
      {
        "resolution_maximum": [
          {
            "单位": "像素",
            "language_tag": "en_US",
            "值": "3840 x 2160"
          }
        ],
        "size": [
          {
            "单位": "英寸",
            "值": 82
          }
        ],
        "类型": [
          {
            "language_tag": "en_US",
            "值": "QLED"
          }
        ],
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "item_name": [
      {
        "language_tag": "en_US",
        "value": "Samsung QN82Q60RAFXZA Flat 82-Inch QLED 4K Q60 Series (2019) Ultra HD Smart TV with HDR and Alexa Compatibility",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "list_price": [
      {
        "货币": "USD",
        "价值": 3799.99,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "batteries_required": [
      {
        "value": false,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "包括可充电电池": [
      {
        "value": false,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "product_site_launch_date": [
      {
        "值": "2019-03-11T08:00:01.000Z",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "Product_category": [
      {
        "值": "50400100",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "batteries_included": [
      {
        "value": false,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "connectivity_technology": [
      {
        "language_tag": "en_US",
        "值": "蓝牙",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "USB",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "无线",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "HDMI",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "included_components": [
      {
        "language_tag": "en_US",
        "值": "QLED标准智能遥控器",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "电力电缆",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "Stand",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "三星智能控制",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "规格_met": [
      {
        "language_tag": "en_US",
        "值": "",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "cpsia_cautionary_statement": [
      {
        "值": "no_warning_applicable",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    " item_type_keyword": [
      {
        "值": "qled-televisions",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "number_of_items": [
      {
        "值": 1,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "保修_描述": [
      {
        "language_tag": "en_US",
        "值": "1年制造商",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "max_resolution": [
      {
        "单位": "像素",
        "值": 8.3,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    " item_package_weight": [
      {
        "单位": "kgograms",
        "值": 62.142,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "supported_internet_services": [
      {
        "language_tag": "en_US",
        "值": "Amazon Instant Video",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "YouTube",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "Netflix",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "Hulu",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "浏览器",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "tuner_technology": [
      {
        "language_tag": "en_US",
        "值": "模拟调谐器",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "wireless_communication_technology": [
      {
        "language_tag": "en_US",
        "值": "Wi-Fi::Wi-Fi Direct::Bluetooth",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "model_year": [
      {
        "值": 2019年
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "power_source_type": [
      {
        "language_tag": "en_US",
        "值": "Corded Electric",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "street_date": [
      {
        "值": "2019-03-21T00:00:01Z",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "刷新率": [
      {
        "单位": "hertz",
        "language_tag": "en_US",
        "值": "120",
        "marketplace_id": "atvpdkikx0der"
      }
    ]
  },
  "标识符": [
    {
      "marketplaceId": "atvpdkikx0der",
      "标识符": [
        {
          "identifier": "0887276302195",
          "标识符类型": "EAN"
        },
        {
          "标识符": "00887276302195",
          "标识符类型": "GTIN"
        },
        {
          "标识符": "887276302195",
          "标识符类型": "UPC"
        }
      ]
    }
  ],
  "图像"[
    {
      "marketplaceId": "atvpdkikx0der",
      "图像": [
        {
          "variant": "MAIN",
          "link": "https://m.media-amazon.com/images/I/51DZzp3w3vL.jpg",
          "高度": 333,
          "宽度": 500
        }
      ]
    }
  ],
  "productTypes": [
    {
      "marketplaceId": "atvpdkikx0der",
      "产品类型": "电视"
    }
  ],
  "等级": [
    {
      "marketplaceId": "atvpdkikx0der",
      "等级": [
        {
          "标题": "电子",
          "链接": "http://www.amazon.com/gp/bestsellers/electronics"
          "值": 61667
        },
        {
          "标题": "QLED电视"
          "链接": "http://www.amazon.com/gp/bestsellers/electronics/21489946011",
          "值": 84
        }
      ]
    }
  ],
  "summaries": [
    {
      "marketplaceId": "atvpdkikx0der",
      "brandName": "三星电子",
      "colorName": "黑色"
      "itemName": "Samsung QN82Q60RAFXZA Flat 82-Inch QLED 4K Q60 Series (2019) Ultra HD Smart TV with HDR and Alexa Compatibility",
      "制造商": "三星",
      "modelNumber": "qn82q60rafxza",
      "尺寸名称": "82-Inch",
      "styleName": "仅限电视"
    }
  ],
  "变化": [
    {
      "marketplaceId": "atvpdkikx0der",
      "asins": [
        "B08J7TQ9FL"
      ],
      "variationType": "儿童"
    }
  ],
  "vendorDetails": [
    {
      "marketplaceId": "atvpdkikx0der",
      "brandCode": "SAMF9",
      "categoryCode": "50400100",
      "制造商代码": "SAMF9",
      "manufacturerCodeParent": "SAMF9",
      "产品组": "家庭娱乐",
      "RepenishmentCategory": "OBSOLETE",
      "subcategoryCode": "50400150"
    }
  ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501

# Tutorial: 搜索亚马逊目录中的物品

使用本教程来搜索亚马逊目录中的物品.

先决条件

要完成本教程,你需要 *来自您所呼叫的销售伙伴的授权.更多信息请参见销售伙伴API开发者指南 (opens new window)

  • 在您的开发者档案中批准产品列表角色.
  • 在应用程序注册页面中为您的应用程序选择的产品列表角色.

# 步骤1:获得一个目录项目和相关信息的列表

要搜索并返回一个带有您指定的可选相关信息的目录项目列表,请调用 searchCatalogItems 操作.

Call the searchCatalogItems (opens new window) operation, passing the following parameters:

请求参数

查询参数

Parameter 实例 Description 要求
关键词 <代码>鞋子</代码></代码 一个以逗号分隔的单词或物品标识符的列表,用于搜索亚马逊目录.

类型< string > array(csv)

是的
<代码>marketplaceIds</代码 <代码>ATVPDKIKX0DER</代码 A comma-delimited list of Amazon marketplace identifiers.

请看 销售伙伴API开发者指南 的亚马逊市场标识符列表.

Type< string > array(csv)

是的
includedData summaries一个以逗号分隔的项目细节列表,用于请求.如果没有指定,将默认为返回 summaries
  • <代码>识别码</代码 -外部物品标识符,如EAN、UPC、ISBN等.
  • images
  • productTypes
  • salesRanks
  • summaries
  • variations
  • vendorDetails

类型< enum (IncludedData) > array(csv)

没有
品牌名称 <代码>美丽的船</代码 A comma-delimited list of brand names to limit the search to.

Type: < string > array(csv)

No
classificationIds12345678 A comma-delimited list of classification identifiers to limit the search to.

Type: < string > array(csv)

No
pageSize <代码>9</代码 每页要返回的结果数.

默认: 10

类型: 整数

没有
pageToken 见示例响应. 当有多个页面的结果时,获取某个页面的令牌.

类型: string

No
<代码>keywordsLocale</代码 <代码>en-US</代码 关键词所提供的语言.如果两者不同,关键词将被翻译成用于搜索的响应语言.

类型: string

没有
locale <代码>es-US</代码 以这种语言返回结果,如果有的话.如果没有指定这个参数,结果将以市场上的默认语言返回.

类型: string

没有

示例请求

GET https://sellingpartnerapi-na.amazon.com/catalog/2020-12-01/items
   .关键字=红色,马球,衬衫
   &amp;marketplaceIds=ATVPDKIKX0DER
   &amp;includedData=summaries
   &amp;pageSize=5
1
2
3
4
5

响应

一个成功的响应包括以下内容

姓名 实例 Description
numberOfResults <代码>3097</代码 搜索查询所匹配的产品总数(每次请求只返回不超过页数限制的结果,而不考虑找到的数量).

类型: integer

pagination参见响应示例 一个包含一个或多个页面标记的JSON对象,可用于获取下一页或上一页的结果.

类型Pagination

refinements 参见响应示例 一个包含键的JSON对象,可用于将搜索结果细化到某些品牌或类别.

类型Refinements

items 参见响应示例 A list of items from the Amazon catalog.

Type: < Item > array

示例响应

{
    "numberOfResults": 12247,
    "分页"{
        "nextToken": "9HkIVcuuPmX_bm51o3-igBfN45pxW4Ru7ElIM6GCECYCuXJKzT26f-AlJJZYjIPp8wkOEmQdma1wt_JvE7qiRmNsKy7hH"
    },
    "细化"{
        "品牌": [
            {
                "numberOfResults": 91,
                "brandName": "Polo Ralph Lauren"
            },
            {
                "numberOfResults": 79,
                "brandName": "Eddie Bauer"
            },
            {
                "numberOfResults": 46,
                "brandName": "Cutter &amp; Buck"
            },
            {
                "numberOfResults": 39,
                "brandName": "FILA"
            },
            {
                "numberOfResults": 37,
                "brandName": "Orvis"
            }
        ],
        "分类": [
            {
                "numberOfResults": 1243,
                "displayName": "服装、鞋和珠宝",
                "classificationId": "7141124011"
            },
            {
                "numberOfResults": 126,
                "displayName": "运动与户外",
                "classificationId": "3375301"
            }
        ]
    },
    "项目": [
        {
            "asin": "B002N36Q3M",
            "summaries": [
                {
                    "marketplaceId": "atvpdkikx0der",
                    "brandName": "Fred Perry",
                    "colorName": "Wht/Brt Red/Nvy",
                    "itemName": "Fred Perry Men's Twin Tipped Polo Shirt-M1200, WHT/BRT RED/NVY, X-Large",
                    "制造商": "Fred Perry Men's Apparel",
                    "modelNumber": "M1200",
                    "sizeName": "X-Large",
                    "styleName": "Twin Tipped Polo Shirt-m1200"
                }
            ]
        },
        {
            "asin": "B002N3ABSI",
            "summaries": [
                {
                    "marketplaceId": "atvpdkikx0der",
                    "brandName": "Fred Perry",
                    "colorName": "White/Bright Red/Navy",
                    "itemName": "Fred Perry Men's Twin Tipped Polo, White/Bright Red/Navy, SM",
                    "制造商": "Fred Perry Apparel Mens",
                    "modelNumber": "M1200-748",
                    "sizeName": "SM",
                    "styleName": "Twin Tipped Fred Perry Polo"
                }
            ]
        },
        {
            "asin": "B01N5B3598"
            "summaries": [
                {
                    "marketplaceId": "atvpdkikx0der",
                    "brandName": "NHL",
                    "colorName": "Red",
                    "itemName": "NHL新泽西魔鬼队男式马球,小号,红色"
                    "制造商": "Knight's Apparel",
                    "modelNumber": "H0MEE3ZAMZ",
                    "sizeName": "小号"
                }
            ]
        },
        {
            "asin": "B00HIVDUXI"
            "summaries": [
                {
                    "marketplaceId": "atvpdkikx0der",
                    "brandName": "adidas",
                    "colorName": "Bold Red/White",
                    "itemName": "Adidas Golf Men's Puremotion Textured Stripe Polo, Bold Red/White, Large",
                    "制造商": "TaylorMade - Adidas Golf Apparel"
                    "modelNumber": "TM3010S4",
                    "sizeName": "大号"
                }
            ]
        },
        {
            "asin": "B005ZZ12YS",
            "summaries": [
                {
                    "marketplaceId": "atvpdkikx0der",
                    "brandName": "Ralph lauren",
                    "colorName": "Black / Red Pony",
                    "itemName": "Polo Ralph Lauren男士长袖T-衬衫/睡衣/保暖内衣,黑色,红色小马驹(Large / L)"
                    "sizeName": "大号"
                }
            ]
        }
    ]
}


## 在搜索亚马逊目录中物品的响应中分页
当调用[searchCatalogItems](https://spapi.cyou/zh/references/catalog-items-api-v2020-12-01-reference.html#get-catalog2020-12-01items)操作产生的响应超过`pageSize'时,就会发生分页.这意味着响应被分成独立的页面,每一页在连续的调用中被返回.要检索下一页或前一页,你必须在下一个请求中传递`nextToken'值或`previousToken'值作为`pageToken'参数.

当你调用searchCatalogItems操作并没有提供页面令牌时,你会得到第一页的结果. 然后你会使用连续响应中提供的`nextToken`页面令牌来迭代其余的页面.

页面令牌是特殊的值,通过解码来确定请求的是哪一页,以及前后有多少页.

如果下一个或前一个页面不可用,相应的页面令牌属性(`nextToken`或`previousToken`分别)将不会出现在`pagination`对象中.

例子

当响应不超过 "pageSize "时,没有分页,所以没有 "nextToken "或 "previousToken"

```plain
"分页": {
},
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132

当响应超过`pageSize'而发生分页

对于第一页,没有前一页,所以没有previousToken

"分页": {
  "nextToken": "XXXXX"
},
1
2
3

对于最后一页,没有下一页,所以没有nextToken

"分页": {
  "previousToken": "XXXXX"
},
1
2
3

对于所有其他页面

"分页": {
  "nextToken": "XXXXX",
  "previousToken": "XXXXX"
},
1
2
3
4

注意:即使可以有超过1000个符合搜索条件的ASINs,但可以返回和分页的最大结果数量被限制在1000. 例如,如果调用者将pageSize设置为10,可能的最大分页数量为100.

Last Updated: 2022/10/20 下午11:58:42