Guias de uso
Documentação GlobalDeveloper HubSuporteStatus da API

Guía de casos de uso de la Catalog Items API v2020-12-01

Cómo utilizar la API de Ítems del Catálogo

Suggest Edits

Versión API: 2020-12-01

¿Qué es la Catalog Items API?

Usando la API de selling partner para items de catálogo (Catalog Items API), puede recuperar información sobre items en el catálogo de Amazon. Consulte la referencia de la API de items del catálogo para obtener detalles sobre las operaciones de la API y los tipos de datos y esquemas asociados.

Características clave

  • Recuperar información detallada de los items : la API de items del catálogo proporciona detalles sobre los items en el catálogo de Amazon, como detalles resumidos del item, identificadores de productos, clasificaciones de ventas, variaciones e imágenes en miniatura. Los vendors pueden recuperar detalles adicionales específicos del vendor y los propietarios de marcas de items pueden recuperar atributos adicionales y contenido de imagen.
  • Búsqueda por items . La API de items del catálogo le permite buscar items del catálogo de Amazon utilizando palabras clave, incluidos los identificadores de productos.

Terminología

  • ASIN : Número de Standard Identification Number que identifica un item en el catálogo de Amazon.
  • Variation : Cada color o tamaño de un item del catálogo representa una variación a la que se le asigna un ASIN diferente. Se agrupan como variaciones de un ASIN principal.

🚧

Manejo de JSON Schemas genéricos en bibliotecas cliente

Si ha generated a client library , es importante tener en cuenta que Swagger Codegen genera tipos en función de las propiedades definidas en los modelos de Swagger, y que Swagger Codegen producirá tipos vacíos o incompletos cuando un objeto se define con additionalProperties: true . Para manipular tales objetos, utilice el --import-mappings parámetro de línea de comandos para asignar estos objetos a un tipo de objeto JSON genérico o un tipo de objeto personalizado de su elección.

Ejemplo de parámetros de entrada de Swagger Codegen:

C#: --import-mappings ItemAttributes=Newtonsoft.Json.Linq.JObject
Java: --import-mappings ItemAttributes=com.google.gson.JsonObject

Tutorial: Recuperar detalles de un item individual en el catálogo de Amazon

Use este tutorial para recuperar información sobre un item en el catálogo de Amazon para el ASIN y los marketplaces dados.

requisitos previos

Para completar este tutorial, necesitará:

  • Autorización del Selling Partner para el que está llamando. Vaya a Autorización de aplicaciones API de selling partner para obtener más información.
  • Aprobación para el rol de Listado de productos en su perfil de desarrollador.
  • El rol de Listado de productos seleccionado en la página de registro de la aplicación para su aplicación.

Paso 1: Obtener información sobre un item del catálogo

Llame a la operación getCatalogItem , pasando los siguientes parámetros:

Parámetros de solicitud

Path Parameters

ParámetroTipoEjemploDescripciónRequerido
asinstringXXXXXXXXXXNúmero de Standard Identification Number para el item de interés.Sí

Query Parameters

ParámetroEjemploDescripciónRequerido
marketplaceIdsATVPDKIKX0DERUna lista comma-delimited de identificadores de marketplace de Amazon.

Consulte Marketplace IDs para obtener una lista de identificadores de marketplace de Amazon.
Tipo: array (csv)		Sí
includedDatasummariesUna lista comma-delimited de los detalles del Item que se solicitará. Si no se especifica ninguno, se devolverá por default summaries de datos.

  • attributes - Atributos de items enumerables. Disponible para el propietario de la marca del item. Contiene todos los atributos de items enumerables presentes en el Item para su tipo de producto particular. .
  • identifiers : ItemIdentifiers externos como EAN, UPC, ISBN, etc.
  • images - Imágenes de productos. Cada imagen de producto contendrá el nombre de la variante de la imagen, la resolución y un link para descargar la imagen.
  • productTypes : Datos del tipo de producto del artículo. La categoría en la que se vende este producto en el marketplace de Amazon..
  • salesRanks : -Datos de clasificación de ventas de items. Cada clasificación de ventas contendrá el nombre de la categoría, la clasificación del item y un link a la página de clasificación de ventas en el sitio web minorista.
  • summaries - Resumen de los datos del item. Atributos básicos como el nombre del item, el fabricante y la marca.
  • variations : -Datos de variación del artículo. Contiene la lista de los ASIN de los artículos relacionados con este artículo y si este artículo es un artículo secundario o principal.
  • vendorDetails : -Datos del vendor del item. Disponible para vendors. Contiene información sobre el reabastecimiento de items, la marca y el fabricante.

Tipo: < enum ( includedData ) > array(csv)		No
localeen_USConfiguración regional para recuperar summaries localizados. El valor predeterminado es la configuración regional principal del marketplace.
Tipo: string		No

solicitud de ejemplo:

GET https://sellingpartnerapi-na.amazon.com/catalog/2020-12-01/items/XXXXXXXXXX
   ?marketplaceIds=ATVPDKIKX0DER
   &includedData=attributes,identifiers,images,productTypes,salesRanks,summaries,variations,vendorDetails

Respuesta

Una respuesta exitosa incluye lo siguiente:

NombreTipoDescripción
asinXXXXXXXXXXEl ASIN solicitado.
Tipo: ItemAsin
attributesVer ejemplo de respuestaUn objeto JSON que contiene datos detallados de items del catálogo. Los valores de varios marketplaces se acumulan en una lista debajo de cada nombre de atributo.
Tipo: ItemAttributes
identifiersVer ejemplo de respuestaIdentificadores externos como UPC, EAN, etc., si corresponde.
Tipo: ItemIdentifiers
imagesVer ejemplo de respuestaDatos de imagen del item.
Tipo: ItemImages
productTypesVer ejemplo de respuestaEl tipo de producto del item dentro del catálogo de Amazon.
Tipo: ItemProductTypes
ranksVer ejemplo de respuestaLos datos de clasificación de ventas para el item en cada categoría en la que se realiza el seguimiento.
Tipo: ItemSalesRanks
summariesVer ejemplo de respuestaResumen de los datos del item.
Tipo: ItemSummaries
variationsVer ejemplo de respuestaListas de ASIN que representan los items principales o secundarios relacionados con este item.
Tipo: ItemVariations
vendorDetailsVer ejemplo de respuestaInformación detallada del vendor de este producto.
Tipo: ItemVendorDetails

Ejemplo de respuesta:

{
  "asin": "B07N4M94X4",
  "attributes": {
    "total_hdmi_ports": [
      {
        "value": 4,
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "resolution": [
      {
        "language_tag": "en_US",
        "value": "4K",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "item_weight": [
      {
        "unit": "pounds",
        "value": 107.6,
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "product_subcategory": [
      {
        "value": "50400150",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "item_dimensions": [
      {
        "width": {
          "unit": "inches",
          "value": 72.4
        },
        "length": {
          "unit": "inches",
          "value": 2.4
        },
        "height": {
          "unit": "inches",
          "value": 41.4
        },
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "brand": [
      {
        "language_tag": "en_US",
        "value": "Samsung Electronics",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "generic_keyword": [
      {
        "language_tag": "en_US",
        "value": "smart tv; 4k tv; roku tv ;lg tv; oled tv; 65 inch smart tv; 4k tv 65 inch; lg smart tv; nvidia shield tv 2018; tv 4k; oled tv 65; sony 4k tv; 4k smart tv; 4k hdr tv; nvidia shield tv; gaming tv; lg 65 inch 4k tv; tv 65 inch smart tv 4k; 65 inch 4k tv; sony 65 inch 4k tv; vizio 4k tv; uhd tv; uhd tv 4k",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "language_tag": "en_US",
        "value": "lg oled; 65 inch smart tv; samsung qled 75 inch tv; 85 inch 4k tv; lg smart tv; 4k tv 65 inch; samsung qled 82 inch tv; 8k tv; lg oled 65; lg smart tv; qled samsung 65 inch; 80 inch tv 4k; sony 4k tv; nvidia shield tv 2018",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "language_tag": "en_US",
        "value": "samsung 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",
        "value": "4k hdr tv; 70" tv; nvidia shield tv; 90 inch tv; gaming tv; 75" tv; lg 65 inch 4k tv; tv 65 inch smart tv 4k; 65 inch 4k tv; sony 65 inch 4k tv; vizio 4k tv; uhd tv; uhd tv 4k;",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "control_method": [
      {
        "value": "voice",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "item_package_dimensions": [
      {
        "length": {
          "unit": "centimeters",
          "value": 26.67
        },
        "width": {
          "unit": "centimeters",
          "value": 121.92
        },
        "height": {
          "unit": "centimeters",
          "value": 203.2
        },
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "image_aspect_ratio": [
      {
        "language_tag": "en_US",
        "value": "16:9",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "part_number": [
      {
        "value": "QN82Q60RAFXZA",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "includes_remote": [
      {
        "value": true,
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "item_type_name": [
      {
        "language_tag": "en_US",
        "value": "TV",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "battery": [
      {
        "cell_composition": [
          {
            "value": "alkaline"
          }
        ],
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "manufacturer": [
      {
        "language_tag": "en_US",
        "value": "Samsung",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "number_of_boxes": [
      {
        "value": 1,
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "total_usb_ports": [
      {
        "value": 2,
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "model_number": [
      {
        "value": "QN82Q60RAFXZA",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "supplier_declared_dg_hz_regulation": [
      {
        "value": "not_applicable",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "num_batteries": [
      {
        "quantity": 2,
        "type": "aaa",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "california_proposition_65": [
      {
        "compliance_type": "on_product_combined_cancer_reproductive",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "compliance_type": "chemical",
        "chemical_names": [
          "di_2_ethylhexyl_phthalate_dehp"
        ],
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "display": [
      {
        "resolution_maximum": [
          {
            "unit": "pixels",
            "language_tag": "en_US",
            "value": "3840 x 2160"
          }
        ],
        "size": [
          {
            "unit": "inches",
            "value": 82
          }
        ],
        "type": [
          {
            "language_tag": "en_US",
            "value": "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": [
      {
        "currency": "USD",
        "value": 3799.99,
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "batteries_required": [
      {
        "value": false,
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "includes_rechargable_battery": [
      {
        "value": false,
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "product_site_launch_date": [
      {
        "value": "2019-03-11T08:00:01.000Z",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "product_category": [
      {
        "value": "50400100",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "batteries_included": [
      {
        "value": false,
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "connectivity_technology": [
      {
        "language_tag": "en_US",
        "value": "Bluetooth",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "language_tag": "en_US",
        "value": "USB",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "language_tag": "en_US",
        "value": "Wireless",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "language_tag": "en_US",
        "value": "HDMI",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "included_components": [
      {
        "language_tag": "en_US",
        "value": "QLED Standard Smart Remote",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "language_tag": "en_US",
        "value": "Power Cable",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "language_tag": "en_US",
        "value": "Stand",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "language_tag": "en_US",
        "value": "Samsung Smart Control",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "specification_met": [
      {
        "language_tag": "en_US",
        "value": "",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "cpsia_cautionary_statement": [
      {
        "value": "no_warning_applicable",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "item_type_keyword": [
      {
        "value": "qled-televisions",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "number_of_items": [
      {
        "value": 1,
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "warranty_description": [
      {
        "language_tag": "en_US",
        "value": "1 year manufacturer",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "max_resolution": [
      {
        "unit": "pixels",
        "value": 8.3,
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "item_package_weight": [
      {
        "unit": "kilograms",
        "value": 62.142,
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "supported_internet_services": [
      {
        "language_tag": "en_US",
        "value": "Amazon Instant Video",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "language_tag": "en_US",
        "value": "YouTube",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "language_tag": "en_US",
        "value": "Netflix",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "language_tag": "en_US",
        "value": "Hulu",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "language_tag": "en_US",
        "value": "Browser",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "tuner_technology": [
      {
        "language_tag": "en_US",
        "value": "Analog Tuner",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "wireless_communication_technology": [
      {
        "language_tag": "en_US",
        "value": "Wi-Fi::Wi-Fi Direct::Bluetooth",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "model_year": [
      {
        "value": 2019,
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "power_source_type": [
      {
        "language_tag": "en_US",
        "value": "Corded Electric",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "street_date": [
      {
        "value": "2019-03-21T00:00:01Z",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "refresh_rate": [
      {
        "unit": "hertz",
        "language_tag": "en_US",
        "value": "120",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ]
  },
  "identifiers": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "identifiers": [
        {
          "identifier": "0887276302195",
          "identifierType": "EAN"
        },
        {
          "identifier": "00887276302195",
          "identifierType": "GTIN"
        },
        {
          "identifier": "887276302195",
          "identifierType": "UPC"
        }
      ]
    }
  ],
  "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"
    }
  ],
  "ranks": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "ranks": [
        {
          "title": "Electronics",
          "link": "http://www.amazon.com/gp/bestsellers/electronics",
          "value": 61667
        },
        {
          "title": "QLED TVs",
          "link": "http://www.amazon.com/gp/bestsellers/electronics/21489946011",
          "value": 84
        }
      ]
    }
  ],
  "summaries": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "brandName": "Samsung Electronics",
      "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"
      ],
      "variationType": "CHILD"
    }
  ],
  "vendorDetails": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "brandCode": "SAMF9",
      "categoryCode": "50400100",
      "manufacturerCode": "SAMF9",
      "manufacturerCodeParent": "SAMF9",
      "productGroup": "Home Entertainment",
      "replenishmentCategory": "OBSOLETE",
      "subcategoryCode": "50400150"
    }
  ]
}

Tutorial: Buscar item en el catálogo de Amazon

Busque y devuelva una lista de items del catálogo de Amazon e información asociada, ya sea por identificador o por
palabras clave.

requisitos previos

Para completar con éxito este tutorial, debe tener:

  • Autorización del Selling Partner para el que está llamando. Vaya a Autorización de aplicaciones API de selling partner para obtener más información.
  • Aprobación para el rol de Listado de productos en su perfil de desarrollador.
  • El rol de Listado de productos seleccionado en la página de registro de la aplicación para su aplicación.

Paso 1: obtener una lista de item del catálogo e información asociada

Llame a la operación searchCatalogItems con los siguientes parámetros:

Parámetros de solicitud

Parámetros de consulta

ParámetroEjemploDescripciónRequerido
keywordsshoesUna lista comma-delimited de palabras clave para buscar en el catálogo de Amazon.
Tipo: array (csv)		No
marketplaceIdsATVPDKIKX0DERUna lista comma-delimited de identificadores de marketplace de Amazon para la solicitud.

Consulte la Guía para desarrolladores de API de Selling Partnerpara ver la lista de identificadores de marketplace de Amazon.
Tipo: array (csv)		Sí
includedDatasummariesUna lista comma-delimited de los detalles del Item que se solicitará. Si no se especifica ninguno, se devolverá por default summaries de datos.

  • attributes - Atributos de items enumerables. Disponible para el propietario de la marca del item. Contiene todos los atributos de items enumerables presentes en el Item para su tipo de producto particular. .
  • identifiers : ItemIdentifiers externos como EAN, UPC, ISBN, etc.
  • images - Imágenes de productos. Cada imagen de producto contendrá el nombre de la variante de la imagen, la resolución y un link para descargar la imagen.
  • productTypes : Datos del tipo de producto del artículo. La categoría en la que se vende este producto en el marketplace de Amazon..
  • salesRanks : -Datos de clasificación de ventas de items. Cada clasificación de ventas contendrá el nombre de la categoría, la clasificación del item y un link a la página de clasificación de ventas en el sitio web minorista.
  • summaries - Resumen de los datos del item. Atributos básicos como el nombre del item, el fabricante y la marca.
  • variations : -Datos de variación del artículo. Contiene la lista de los ASIN de los artículos relacionados con este artículo y si este artículo es un artículo secundario o principal.
  • vendorDetails : -Datos del vendor del item. Disponible para vendors. Contiene información sobre el reabastecimiento de items, la marca y el fabricante.

Tipo: < enum ( includedData ) > array(csv)		No
brandNamesBeautiful BoatsUna lista comma-delimited de marcas para refinar los resultados de búsqueda.
Tipo: array (csv)		No
classificationIds12345678Una lista comma-delimited de identificadores de clasificación para refinar los resultados de búsqueda.
Tipo: array (csv)		No
pageSize9Número de resultados a devolver por página.
Tipo: integer		No
pageTokenVer ejemplo de respuesta.Un token para buscar una página determinada cuando hay varias páginas de resultados.
Tipo: string		No
keywordsLocaleen_USLa configuración regional de las palabras clave proporcionadas, por default es la configuración regional del marketplace.
Tipo: string		No
localeen_USConfiguración regional para recuperar summaries localizados. El valor predeterminado es la configuración regional principal del marketplace.
Tipo: string		No

Ejemplo de solicitud:

GET https://sellingpartnerapi-na.amazon.com/catalog/2020-12-01/items
   ?keywords=red,polo,shirt
   &marketplaceIds=ATVPDKIKX0DER
   &includedData=summaries
   &pageSize=5

Respuesta

Una respuesta exitosa incluye lo siguiente:

NombreEjemploDescripción
numberOfResults3097El número total de productos que coinciden con la consulta de búsqueda. Solo se devolverán los resultados hasta el límite de recuento de páginas por solicitud, independientemente del número encontrado.
Tipo: integer
paginationVer ejemplo de respuestaUn objeto JSON que contiene uno o más tokens de página que se pueden usar para obtener la página de resultados siguiente o anterior.
Tipo: Pagination
refinementsVer ejemplo de respuestaUn objeto JSON que contiene refinamientos de búsqueda de marca y clasificación.
Tipo: Refinements
itemsVer ejemplo de respuestaUna lista de items del catálogo de Amazon.
Tipo: < Item > array

Ejemplo de respuesta:

{
    "numberOfResults": 12247,
    "pagination": {
        "nextToken": "9HkIVcuuPmX_bm51o3-igBfN45pxW4Ru7ElIM6GCECYCuXJKzT26f-AlJJZYjIPp8wkOEmQdma1wt_JvE7qiRmNsKy7hH"
    },
    "refinements": {
        "brands": [
            {
                "numberOfResults": 91,
                "brandName": "Polo Ralph Lauren"
            },
            {
                "numberOfResults": 79,
                "brandName": "Eddie Bauer"
            },
            {
                "numberOfResults": 46,
                "brandName": "Cutter & Buck"
            },
            {
                "numberOfResults": 39,
                "brandName": "FILA"
            },
            {
                "numberOfResults": 37,
                "brandName": "Orvis"
            }
        ],
        "classifications": [
            {
                "numberOfResults": 1243,
                "displayName": "Clothing, Shoes & Jewelry",
                "classificationId": "7141124011"
            },
            {
                "numberOfResults": 126,
                "displayName": "Sports & Outdoors",
                "classificationId": "3375301"
            }
        ]
    },
    "items": [
        {
            "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",
                    "manufacturer": "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",
                    "manufacturer": "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 New Jersey Devils Men's Polo, Small, Red",
                    "manufacturer": "Knight's Apparel",
                    "modelNumber": "H0MEE3ZAMZ",
                    "sizeName": "Small"
                }
            ]
        },
        {
            "asin": "B00HIVDUXI",
            "summaries": [
                {
                    "marketplaceId": "ATVPDKIKX0DER",
                    "brandName": "adidas",
                    "colorName": "Bold Red/White",
                    "itemName": "Adidas Golf Men's Puremotion Textured Stripe Polo, Bold Red/White, Large",
                    "manufacturer": "TaylorMade - Adidas Golf Apparel",
                    "modelNumber": "TM3010S4",
                    "sizeName": "Large"
                }
            ]
        },
        {
            "asin": "B005ZZ12YS",
            "summaries": [
                {
                    "marketplaceId": "ATVPDKIKX0DER",
                    "brandName": "RALPH LAUREN",
                    "colorName": "Black / Red Pony",
                    "itemName": "Polo Ralph Lauren Men's Long-sleeved T-shirt / Sleepwear / Thermal in Black, Red Pony (Large / L)",
                    "sizeName": "Large"
                }
            ]
        }
    ]
}

Paginación en la respuesta a una búsqueda de items en el catálogo de Amazon

Cuando una llamada a la operación searchCatalogItems produce una respuesta que excede el pageSize, se produce la paginación. Esto significa que la respuesta se divide en páginas individuales, donde cada página se devuelve en llamadas sucesivas. Para recuperar la página siguiente o la página anterior, debe pasar el valor o el valor nextToken o el valor previousToken como parámetro pageToken en la siguiente solicitud.

Obtiene la primera página de resultados cuando llama al operación searchCatalogItems y no proporciona ningún token de página. Luego itera a través del resto de las páginas usando el token de página nextToken proporcionado en respuestas sucesivas.

Los tokens de página son valores especiales que se decodifican para determinar qué página se solicita y cuántas páginas hay antes o después.

Si la página siguiente o anterior no está disponible, el atributo de token de página correspondiente (nextToken o anteriorToken respectivamente) no estará presente en el objeto pagination .

Ejemplos:

Cuando la respuesta no supera la pageSize , no hay paginación, por lo que no hay nextToken o previousToken :

"pagination": {
},

Cuando la respuesta excede la pageSize y paginación ocurre:

Para la primera página, no hay página anterior, por lo que no hay previousToken :

"pagination": {
  "nextToken": "XXXXXX"
},

Para la última página, no hay página siguiente, por lo que no hay nextToken :

"pagination": {
  "previousToken": "XXXXXX"
},

Para todas las demás páginas:

"pagination": {
  "nextToken": "XXXXXX",
  "previousToken": "XXXXXX"
},

Nota: Aunque puede haber más de 1000 ASIN que coincidan con los criterios de búsqueda, la cantidad máxima de resultados que se pueden devolver y hojear está limitada a 1000. Por ejemplo, si la persona que llama establece el pageSize a 10, el número máximo de páginas posibles es 100.

Updated over 1 year ago