Guía de casos de uso de la Catalog Items API v2022-04-01

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

Versión API: 2022-04-01

¿Qué es la API de items del catálogo?

Usando la API de selling partner para items de catálogo (API de items de catálogo), 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 del catálogo de Amazon, como
- Summarized item details
- Attributes
- Product identifiers
- Sales rankings
- Relationships
- Images
  Los Vendors pueden recuperar detalles adicionales de vendor-specific.
Búsqueda por identificadores o palabras clave . La API de items del catálogo le permite buscar items del catálogo de Amazon e información asociada ya sea por identificadores (como identificadores UPC o EAN, hasta 20 por solicitud) o por palabras clave. Los mismos detalles del item están disponibles al realizar una consulta de búsqueda o al recuperar items explícitamente por ASIN.

Terminología

ASIN : Número de Standard Identification Number que identifica un item en el catálogo de Amazon.
SKU : unidad de mantenimiento de existencias Selling partner-supplied que identifica a un seller o lista de vendors. Los datos de uno o más listados de selling partner se reconcilian en items en el catálogo de Amazon.
Variation : Las variaciones son un tipo de relación entre los items del catálogo de Amazon que agrupan items que varían por color, tamaño u otros atributos. Se utiliza un Item principal del catálogo de Amazon para agrupar los items secundarios en la familia de variantes. Por ejemplo, una camisa se puede ofrecer en varios tamaños y colores. En este escenario, cada combinación distinta de tamaño y color se representa como su propio item en el catálogo de Amazon con un item principal que los agrupa para proporcionar una única página de detalles en los websites minoristas de Amazon.

🚧
Manejo de JSON Schemas genéricos en bibliotecas cliente
Si ha generó una biblioteca cliente , 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 por su identificador (ASIN)

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:

Path Parameters

Parámetro	Tipo	Ejemplo	Descripción	Requerido
`asin`	string	`XXXXXXXXXX`	Número de Standard Identification Number para el item de interés.	Sí

Query Parameters

Parámetro	Tipo	Ejemplo	Descripción	Requerido
`marketplaceIds`	array (csv)	`ATVPDKIKX0DER`	Una lista comma-delimited de identificadores de marketplace de Amazon. Consulte Marketplace IDs para obtener una lista de identificadores de marketplace de Amazon.	Sí
`includedData`	< enum ( includedData ) > array(csv)	`summaries`	Una 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. Consulte la API de definiciones de tipos de productos para obtener más información sobre la recuperación de JSON Schemas que describen el formato de los atributos devueltos. `dimensions` : dimensiones del item y del paquete. `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` : tipo de producto del item. Los atributos y requisitos de datos para un item se definen por su tipo de producto, que se puede recuperar mediante la API de definiciones de tipo de producto . `relationships` : datos de relaciones de items. Contiene listas de ASIN que representan los items principales o secundarios relacionados con este item. `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 website minorista. `summaries` - Resumen de los datos del item. Atributos básicos como el nombre del item, el fabricante y la marca. `vendorDetails` : datos del vendor del item. Disponible para vendors. Contiene información sobre el reabastecimiento de items, la marca y el fabricante.	No
`locale`	string	`en_US`	Configuración regional para recuperar summaries localizados. El valor predeterminado es la configuración regional principal del marketplace.	No

solicitud de ejemplo:

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

Respuesta

Una respuesta exitosa incluye lo siguiente:

Nombre	Tipo	Descripción
`como en`	itemAsin	El ASIN solicitado.
`attributes`	ItemAttributes	Un 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. Consulte la Guía de casos de uso de la API de definiciones de tipos de productos para obtener más información.
`dimensions`	ItemDimensions	Dimensiones normalizadas de items y package.
`identifiers`	ItemIdentifiers	Identificadores externos como UPC, EAN, etc., si corresponde.
`images`	ItemImages	Datos de imagen del item.
`productTypes`	ItemProductTypes	El tipo de producto del item dentro del catálogo de Amazon. Consulte la API de definiciones de tipos de productos para obtener más información.
`ranks`	ItemSalesRanks	Los datos de clasificación de ventas para el item en cada categoría en la que se realiza el seguimiento.
`relationships`	ItemRelationships	Listas de ASIN que representan los items principales o secundarios relacionados con este item.
`summaries`	ItemSummaries	Resumen de los datos del item.
`vendorDetails`	ItemVendorDetails	Información detallada del vendor de este producto.

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": "50400120",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "bullet_point": [
      {
        "language_tag": "en_US",
        "value": "SMART TV WITH UNIVERSAL GUIDE: Simple on-screen Guide is an easy way to find streaming content and live TV shows",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "language_tag": "en_US",
        "value": "100% COLOR VOLUME WITH QUANTUM DOTS: Powered by Quantum dots, Samsung’s 4K QLED TV offers over a billion shades of brilliant color and 100% color volume for exceptional depth of detail that will draw you in to the picture for the best 4K TV experience",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "language_tag": "en_US",
        "value": "QUANTUM PROCESSOR 4K: Intelligently powered processor instantly upscales content to 4K for sharp detail and refined color",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "language_tag": "en_US",
        "value": "QUANTUM HDR 4X: 4K depth of detail with high dynamic range powered by HDR10+ delivers the lightest to darkest colors, scene by scene, for amazing picture realism",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "language_tag": "en_US",
        "value": "AMBIENT MODE: Customizes and complements your living space by turning a blank screen of this big screen TV into enticing visuals including décor, info, photos and artwork",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "language_tag": "en_US",
        "value": "SMART TV FEATURES: OneRemote to control all compatible devices, Bixby voice command, on-screen universal guide, SmartThings to control compatible home appliances and devices, smart speaker expandability with Alexa and Google Assistant compatibility, and more",
        "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",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "generic_keyword": [
      {
        "language_tag": "en_US",
        "value": "oled 65 inch smart tv qled 75 inch tv 85 inch 4k tv smart tv 4k tv 65 inch qled 82 inch tv 8k tv oled 65 smart tv qled 65 inch 80 inch tv 4k 4k tv shield tv 2018",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "language_tag": "en_US",
        "value": "q9fn qled 2018 oled 4k 4k oled toshiba antenna dvd player outdoor tv kitchen tv fire tv firetv hdtv hd tv android shield tv gaming deals tv ears dvr speakers digital tv antenna tv android tv frame mount",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "language_tag": "en_US",
        "value": "4k hdr tv 70 tv shield tv 90 inch tv gaming tv 75 tv 65 inch 4k tv tv 65 inch smart tv 4k 65 inch 4k tv 65 inch 4k tv 4k tv uhd tv uhd tv 4k",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "language_tag": "en_US",
        "value": "smart tv 4k tv tv tv oled tv 65 inch smart tv 4k tv 65 inch smart tv shield tv 2018 tv 4k oled tv 65 4k tv 4k smart tv 4k hdr tv shield tv gaming tv 65 inch 4k tv tv 65 inch smart tv 4k 65 inch 4k tv 65 inch 4k tv 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"
      }
    ],
    "style": [
      {
        "language_tag": "en_US",
        "value": "TV only",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "item_type_name": [
      {
        "language_tag": "en_US",
        "value": "TV",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "battery": [
      {
        "cell_composition": [
          {
            "value": "alkaline"
          }
        ],
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "image_contrast_ratio": [
      {
        "language_tag": "en_US",
        "value": "QLED 4K",
        "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"
      }
    ],
    "parental_control_technology": [
      {
        "value": "V-Chip",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "power_consumption": [
      {
        "unit": "watts",
        "value": 120,
        "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"
      }
    ],
    "color": [
      {
        "language_tag": "en_US",
        "value": "Black",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "screen_surface_description": [
      {
        "language_tag": "en_US",
        "value": "Flat",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "item_package_weight": [
      {
        "unit": "kilograms",
        "value": 62.142,
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "speaker_type": [
      {
        "language_tag": "en_US",
        "value": "2CH",
        "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"
      }
    ],
    "controller_type": [
      {
        "language_tag": "en_US",
        "value": "SmartThings",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "language_tag": "en_US",
        "value": "Voice Control",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "special_feature": [
      {
        "language_tag": "en_US",
        "value": "100% Color Volume with Quantum Dot; Quantum Processor 4K; Ambient Mode; Quantum HDR 4X; Real Game Enhancer",
        "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"
      }
    ],
    "mounting_type": [
      {
        "language_tag": "en_US",
        "value": "Table Mount",
        "marketplace_id": "ATVPDKIKX0DER"
      },
      {
        "language_tag": "en_US",
        "value": "Wall Mount",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "refresh_rate": [
      {
        "unit": "hertz",
        "language_tag": "en_US",
        "value": "120",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ]
  },
  "dimensions": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "item": {
        "height": {
          "unit": "inches",
          "value": 41.4
        },
        "length": {
          "unit": "inches",
          "value": 2.4
        },
        "weight": {
          "unit": "pounds",
          "value": 107.6
        },
        "width": {
          "unit": "inches",
          "value": 72.4
        }
      },
      "package": {
        "height": {
          "unit": "inches",
          "value": 10.49999998929
        },
        "length": {
          "unit": "inches",
          "value": 79.9999999184
        },
        "weight": {
          "unit": "kilograms",
          "value": 62.142
        },
        "width": {
          "unit": "inches",
          "value": 47.99999995104
        }
      }
    }
  ],
  "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/91uohwV+k3L.jpg",
          "height": 1707,
          "width": 2560
        },
        {
          "variant": "MAIN",
          "link": "https://m.media-amazon.com/images/I/51DZzp3w3vL.jpg",
          "height": 333,
          "width": 500
        },
        {
          "variant": "PT01",
          "link": "https://m.media-amazon.com/images/I/81w2rTVShlL.jpg",
          "height": 2560,
          "width": 2560
        },
        {
          "variant": "PT01",
          "link": "https://m.media-amazon.com/images/I/41Px9eq9tkL.jpg",
          "height": 500,
          "width": 500
        },
        {
          "variant": "PT02",
          "link": "https://m.media-amazon.com/images/I/51NTNhdhPyL.jpg",
          "height": 375,
          "width": 500
        },
        {
          "variant": "PT03",
          "link": "https://m.media-amazon.com/images/I/51o4zpL+A3L.jpg",
          "height": 375,
          "width": 500
        },
        {
          "variant": "PT04",
          "link": "https://m.media-amazon.com/images/I/71ux2k9GAZL.jpg",
          "height": 1000,
          "width": 1000
        },
        {
          "variant": "PT04",
          "link": "https://m.media-amazon.com/images/I/61UUX63yw1L.jpg",
          "height": 500,
          "width": 500
        },
        {
          "variant": "PT05",
          "link": "https://m.media-amazon.com/images/I/61LwHkljX-L.jpg",
          "height": 1000,
          "width": 1000
        },
        {
          "variant": "PT05",
          "link": "https://m.media-amazon.com/images/I/51wJTQty3PL.jpg",
          "height": 500,
          "width": 500
        },
        {
          "variant": "PT06",
          "link": "https://m.media-amazon.com/images/I/61uvoB4VvoL.jpg",
          "height": 1000,
          "width": 1000
        },
        {
          "variant": "PT06",
          "link": "https://m.media-amazon.com/images/I/51ZexIO628L.jpg",
          "height": 500,
          "width": 500
        },
        {
          "variant": "PT07",
          "link": "https://m.media-amazon.com/images/I/7121MGd2ncL.jpg",
          "height": 1000,
          "width": 1000
        },
        {
          "variant": "PT07",
          "link": "https://m.media-amazon.com/images/I/61QK+JBMrGL.jpg",
          "height": 500,
          "width": 500
        },
        {
          "variant": "PT08",
          "link": "https://m.media-amazon.com/images/I/61ECcGlG4IL.jpg",
          "height": 1080,
          "width": 1920
        },
        {
          "variant": "PT08",
          "link": "https://m.media-amazon.com/images/I/31TxwfqvB5L.jpg",
          "height": 281,
          "width": 500
        },
        {
          "variant": "PT09",
          "link": "https://m.media-amazon.com/images/I/41B5vgmp4IL.jpg",
          "height": 375,
          "width": 500
        },
        {
          "variant": "PT10",
          "link": "https://m.media-amazon.com/images/I/51S5IY3AV0L.jpg",
          "height": 375,
          "width": 500
        },
        {
          "variant": "PT11",
          "link": "https://m.media-amazon.com/images/I/41-6bmPtUlL.jpg",
          "height": 375,
          "width": 500
        },
        {
          "variant": "PT12",
          "link": "https://m.media-amazon.com/images/I/41s9Q6gWJ7L.jpg",
          "height": 448,
          "width": 500
        },
        {
          "variant": "PT13",
          "link": "https://m.media-amazon.com/images/I/519nG0mRzuL.jpg",
          "height": 314,
          "width": 500
        },
        {
          "variant": "PT14",
          "link": "https://m.media-amazon.com/images/I/71sHhrGMc7L.jpg",
          "height": 1097,
          "width": 1500
        },
        {
          "variant": "PT14",
          "link": "https://m.media-amazon.com/images/I/41CH6gKtU5L.jpg",
          "height": 366,
          "width": 500
        },
        {
          "variant": "PT15",
          "link": "https://m.media-amazon.com/images/I/21-s7QYrTxL.jpg",
          "height": 500,
          "width": 175
        },
        {
          "variant": "EEGL",
          "link": "https://m.media-amazon.com/images/I/61i3dsKD09L.jpg",
          "height": 1375,
          "width": 370
        },
        {
          "variant": "EEGL",
          "link": "https://m.media-amazon.com/images/I/41E7ku-qdGL.jpg",
          "height": 500,
          "width": 135
        },
        {
          "variant": "EGUS",
          "link": "https://m.media-amazon.com/images/I/61i3dsKD09L.jpg",
          "height": 1375,
          "width": 370
        },
        {
          "variant": "EGUS",
          "link": "https://m.media-amazon.com/images/I/41E7ku-qdGL.jpg",
          "height": 500,
          "width": 135
        }
      ]
    }
  ],
  "productTypes": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "productType": "TELEVISION"
    }
  ],
  "salesRanks": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "classificationRanks": [
        {
          "classificationId": "21489946011",
          "title": "QLED TVs",
          "link": "http://www.amazon.com/gp/bestsellers/electronics/21489946011",
          "rank": 113
        }
      ],
      "displayGroupRanks": [
        {
          "websiteDisplayGroup": "ce_display_on_website",
          "title": "Electronics",
          "link": "http://www.amazon.com/gp/bestsellers/electronics",
          "rank": 72855
        }
      ]
    }
  ],
  "summaries": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "brand": "SAMSUNG",
      "browseClassification": {
        "displayName": "QLED TVs",
        "classificationId": "21489946011"
      },
      "color": "Black",
      "itemClassification": "BASE_PRODUCT",
      "itemName": "Samsung QN82Q60RAFXZA Flat 82-Inch QLED 4K Q60 Series (2019) Ultra HD Smart TV with HDR and Alexa Compatibility",
      "manufacturer": "Samsung",
      "modelNumber": "QN82Q60RAFXZA",
      "packageQuantity": 1,
      "partNumber": "QN82Q60RAFXZA",
      "size": "82-Inch",
      "style": "TV only",
      "websiteDisplayGroup": "ce_display_on_website"
    }
  ],
  "relationships": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "relationships": [
        {
          "type": "VARIATION",
          "parentAsins": [
            "B08J7TQ9FL"
          ],
          "variationTheme": {
            "attributes": [
              "color",
              "size"
            ],
            "theme": "SIZE_NAME/COLOR_NAME"
          }
        }
      ]
    }
  ],
  "vendorDetails": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "brandCode": "SAMF9",
      "manufacturerCode": "SAMF9",
      "manufacturerCodeParent": "SAMF9",
      "productCategory": {
        "displayName": "Televisions",
        "value": "50400100"
      },
      "productGroup": "Home Entertainment",
      "productSubcategory": {
        "displayName": "Plasma TVs",
        "value": "50400120"
      },
      "replenishmentCategory": "OBSOLETE"
    }
  ]
}

Tutorial: busque uno o más items por ASIN o identificadores de productos

Utilice este tutorial para recuperar información sobre varios items en el catálogo de Amazon para los ASIN o product identifiers.

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: Buscar items

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

Parámetros de consulta

Parámetro	Tipo	Ejemplo	Descripción	Requerido
`identifiers`	array (csv)	`0887276302195`	Una lista comma-delimited de identificadores de productos para buscar en el catálogo de Amazon. Nota: No se puede utilizar con `keywords`.	No
`identifiersType`	string	`ISBN`	Tipo de identificadores de productos para buscar en el catálogo de Amazon. Nota: Requerido cuando se proporcionan `identifiers` . `ASIN` : número de Standard Identification Number. `EAN` - Número de item europeo. `GTIN` - Número mundial de item comercial. `ISBN` - Número de libro estándar internacional. `JAN` - Número de item japonés. `MINSAN` - Código Minsan. `SKU` - Unidad de mantenimiento de existencias. `UPC` - Códigos únicos de productos.	No
`marketplaceIds`	array (csv)	`ATVPDKIKX0DER`	Una lista comma-delimited de identificadores de marketplace de Amazon para la solicitud.	Sí
`includedData`	< enum ( includedData ) > array(csv)	`summaries`	Una 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. Consulte la API de definiciones de tipos de productos para obtener más información sobre la recuperación de JSON Schemas que describen el formato de los atributos devueltos. `dimensions` : dimensiones del item y del paquete. `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` : tipo de producto del item. Los atributos y requisitos de datos para un item se definen por su tipo de producto, que se puede recuperar mediante la API de definiciones de tipo de producto . `relationships` : datos de relaciones de items. Contiene listas de ASIN que representan los items principales o secundarios relacionados con este item. `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 website minorista. `summaries` - Resumen de los datos del item. Atributos básicos como el nombre del item, el fabricante y la marca. `vendorDetails` : datos del vendor del item. Disponible para vendors. Contiene información sobre el reabastecimiento de items, la marca y el fabricante.	No
`locale`	string	`en_US`	Configuración regional para recuperar summaries localizados. El valor predeterminado es la configuración regional principal del marketplace.	No
`sellerId`	string	`XXXXXXXXXXXX`	Un identificador de selling partner, como una cuenta de seller o un código de vendor. Nota: Requerido cuando `identifiersType` es `SKU` .	No
`pageSize`	integer	`10`	Número de resultados a devolver por página.	No
`pageToken`	string		Un token para buscar una página determinada cuando hay varias páginas de resultados.	No

Utilizar el parámetro pageToken para paginar los resultados. Consulte Paginación en la respuesta a una búsqueda de items en el catálogo de Amazon para obtener más información.

solicitud de ejemplo:

GET https://sellingpartnerapi-na.amazon.com/catalog/2022-04-01/items
  ?identifiers=XXXXXXXXX,YYYYYYYY,ZZZZZZZZ
  &identifiersType=ASIN
  &marketplaceIds=ATVPDKIKX0DER

Respuesta

Una respuesta exitosa incluye lo siguiente:

Nombre	Tipo	Descripción
`numberOfResults`	integer	El 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.
`pagination`	Pagination	Un 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.
`items`	< Item > array	Una lista de items del catálogo de Amazon. La información incluida para cada ítem depende del argumento dado para `includedData` . Consulte la referencia de la API de items del catálogo para obtener más información.

Ejemplo de respuesta:

{
  "numberOfResults": 3,
  "items": [
    {
      "asin": "XXXXXXXXXX",
      "summaries": [
        {
          "marketplaceId": "ATVPDKIKX0DER",
          "brand": "Fred Perry",
          "color": "Wht/Brt Red/Nvy",
          "itemClassification": "BASE_PRODUCT",
          "itemName": "Fred Perry Men's Twin Tipped Polo Shirt-M1200, WHT/BRT RED/NVY, X-Large",
          "manufacturer": "Fred Perry Men's Apparel",
          "modelNumber": "M1200",
          "packageQuantity": 1,
          "partNumber": "M1200-748",
          "size": "X-Large",
          "style": "Twin Tipped Polo Shirt-m1200",
          "websiteDisplayGroup": "apparel_display_on_website"
        }
      ]
    },
    {
      "asin": "YYYYYYYYYYY",
      "summaries": [
        {
          "marketplaceId": "ATVPDKIKX0DER",
          "brand": "Universal",
          "itemClassification": "BASE_PRODUCT",
          "itemName": "Dr. Seuss' The Lorax",
          "manufacturer": "Universal",
          "modelNumber": "ALE BOOK",
          "packageQuantity": 1,
          "partNumber": "MCAD61118810D",
          "websiteDisplayGroup": "dvd_display_on_website"
        }
      ]
    },
    {
      "asin": "ZZZZZZZZZZZ",
      "summaries": [
        {
          "marketplaceId": "ATVPDKIKX0DER",
          "brand": "Muck Boot",
          "itemClassification": "VARIATION_PARENT",
          "itemName": "Muck Boot Women's Muckster 2 Ankle Snow Boot, black",
          "manufacturer": "Muck Boot",
          "style": "Muckster 2 Ankle",
          "websiteDisplayGroup": "shoes_display_on_website"
        }
      ]
    }
  ]
}

Tutorial: Buscar items por palabras clave

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: Buscar items

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

Parámetros de consulta

Parámetro	Tipo	Ejemplo	Descripción	Requerido
`brandNames`	array (csv)	`Samsung`	Una lista comma-delimited de marcas para refinar los resultados de búsqueda.	No
`classificationIds`	array (csv)	`7141124011`	Una lista comma-delimited de identificadores de clasificación para refinar los resultados de búsqueda.	No
`keywords`	array (csv)	`hello`	Una lista comma-delimited de palabras clave para buscar en el catálogo de Amazon. Nota: No se puede utilizar con `identifiers`	No
`keywordsLocale`	string	`en_US`	La configuración regional de las palabras clave proporcionadas, por default es la configuración regional del marketplace.	No
`marketplaceIds`	array (csv)	`ATVPDKIKX0DER`	Una lista comma-delimited de identificadores de marketplace de Amazon para la solicitud.	Sí
`includedData`	< enum ( includedData ) > array(csv)	`summaries`	Una 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. Consulte la API de definiciones de tipos de productos para obtener más información sobre la recuperación de JSON Schemas que describen el formato de los atributos devueltos. `dimensions` : dimensiones del item y del paquete. `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` : tipo de producto del item. Los atributos y requisitos de datos para un item se definen por su tipo de producto, que se puede recuperar mediante la API de definiciones de tipo de producto . `relationships` : datos de relaciones de items. Contiene listas de ASIN que representan los items principales o secundarios relacionados con este item. `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 website minorista. `summaries` - Resumen de los datos del item. Atributos básicos como el nombre del item, el fabricante y la marca. `vendorDetails` : datos del vendor del item. Disponible para vendors. Contiene información sobre el reabastecimiento de items, la marca y el fabricante.	No
`locale`	string	`en_US`	Configuración regional para recuperar summaries localizados. El valor predeterminado es la configuración regional principal del marketplace.	No
`sellerId`	string	`XXXXXXXXXXXX`	Un identificador de selling partner, como una cuenta de seller o un código de vendor. Nota: Requerido cuando `identifiersType` es `SKU` .	No
`pageSize`	integer	`10`	Número de resultados a devolver por página.	No
`pageToken`	string	Ver el`nextToken` en la respuesta de ejemplo.	Un token para buscar una página determinada cuando hay varias páginas de resultados.	No

Utilizar el parámetro pageToken para paginar los resultados. Consulte Paginación en la respuesta a una búsqueda de items en el catálogo de Amazon para obtener más información.

Ejemplo de solicitud:

GET https://sellingpartnerapi-na.amazon.com/catalog/2022-04-01/items
  ?keywords=hello
  &marketplaceIds={{marketplaceIds}}
  &includedData=summaries
  &pageSize=10

Respuesta

Una respuesta exitosa incluye lo siguiente:

Nombre	Tipo	Descripción
`numberOfResults`	integer	El 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.
`items`	< Item > array	Una lista de items del catálogo de Amazon. La información incluida para cada ítem depende del argumento dado para `includedData` . Consulte la referencia de la API de items del catálogo para obtener más información.
`pagination`	Pagination	Un 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.
`refinements`	Refinements	Un objeto JSON que contiene refinamientos de búsqueda de marca y clasificación.

Ejemplo de respuesta:

{
  "numberOfResults": 1000,
  "pagination": {
    "nextToken": "9HkIVcuuPmX_bm51o3-igBfN45pxW4Ru7ElIM6GCECYCuXJKzT26f5Rj4j72myj91jtjou695yNwt_JvE7qiRtfLOKtyb2IDTpSxcFmiJaztoxrP6fPkv2x86yf7CWqwS7VtDkxYifP8CHvJEnH2oh1l1vj7KQoFIa7pWiOPHyaYWP7sBE9Fg7cGN2wE0an5ePw96h6ZL7m6olRxFOcqTWNanEVRjipq"
  },
  "refinements": {
    "brands": [
      {
        "numberOfResults": 328,
        "brandName": "Hello Kitty"
      },
      {
        "numberOfResults": 139,
        "brandName": "Brand TOTOX"
      },
      {
        "numberOfResults": 101,
        "brandName": "Sanrio"
      },
      {
        "numberOfResults": 79,
        "brandName": "Vans"
      },
      {
        "numberOfResults": 73,
        "brandName": "Commonwealth Editions"
      },
      {
        "numberOfResults": 42,
        "brandName": "Webstore"
      },
      {
        "numberOfResults": 38,
        "brandName": "Unknown"
      },
      {
        "numberOfResults": 38,
        "brandName": "Web Store"
      },
      {
        "numberOfResults": 37,
        "brandName": "FOCO"
      },
      {
        "numberOfResults": 30,
        "brandName": "Skinit"
      }
    ],
    "classifications": [
      {
        "numberOfResults": 859,
        "displayName": "Books",
        "classificationId": "1000"
      },
      {
        "numberOfResults": 595,
        "displayName": "Clothing, Shoes & Jewelry",
        "classificationId": "7141124011"
      },
      {
        "numberOfResults": 371,
        "displayName": "Home & Kitchen",
        "classificationId": "1063498"
      },
      {
        "numberOfResults": 233,
        "displayName": "Toys & Games",
        "classificationId": "165795011"
      },
      {
        "numberOfResults": 197,
        "displayName": "CDs & Vinyl",
        "classificationId": "301668"
      },
      {
        "numberOfResults": 156,
        "displayName": "Baby Products",
        "classificationId": "165797011"
      },
      {
        "numberOfResults": 153,
        "displayName": "Everything Else",
        "classificationId": "10304191"
      },
      {
        "numberOfResults": 134,
        "displayName": "Electronics",
        "classificationId": "493964"
      },
      {
        "numberOfResults": 125,
        "displayName": "Sports & Outdoors",
        "classificationId": "3375301"
      },
      {
        "numberOfResults": 123,
        "displayName": "Movies & TV",
        "classificationId": "2625374011"
      }
    ]
  },
  "items": [
    {
      "asin": "B0013OMKRI",
      "summaries": [
        {
          "marketplaceId": "ATVPDKIKX0DER",
          "brand": "Hello Kitty",
          "itemClassification": "BASE_PRODUCT",
          "itemName": "HELLO KITTY KT2052A Alarm Clock Radio with Night Light (Discontinued by Manufacturer)",
          "manufacturer": "HELLO KITTY",
          "modelNumber": "KT2052A",
          "packageQuantity": 1,
          "partNumber": "KT2052A",
          "websiteDisplayGroup": "ce_display_on_website"
        }
      ]
    },
    {
      "asin": "B0015ESWHI",
      "summaries": [
        {
          "marketplaceId": "ATVPDKIKX0DER",
          "brand": "Hello Kitty",
          "itemClassification": "BASE_PRODUCT",
          "itemName": "HELLO KITTY KT2053 AM/FM Stereo Alarm Clock Radio with Top Loading CD Player",
          "manufacturer": "HELLO KITTY",
          "modelNumber": "KT2053",
          "packageQuantity": 1,
          "partNumber": "KT2053",
          "websiteDisplayGroup": "ce_display_on_website"
        }
      ]
    },
    {
      "asin": "B009NIYBCS",
      "summaries": [
        {
          "marketplaceId": "ATVPDKIKX0DER",
          "brand": "Hello Kitty",
          "color": "Pink/White",
          "itemClassification": "BASE_PRODUCT",
          "itemName": "Hello Kitty Ladies Golf Glove Set, Pink/White, 20cm",
          "manufacturer": "Hello Kitty Golf",
          "modelNumber": "GLOVE-HKG.M",
          "size": "20cm",
          "websiteDisplayGroup": "sports_display_on_website"
        }
      ]
    },
    {
      "asin": "B002W7RDMM",
      "summaries": [
        {
          "marketplaceId": "ATVPDKIKX0DER",
          "brand": "Hello Kitty",
          "itemClassification": "BASE_PRODUCT",
          "itemName": "HELLO KITTY KT2054 Projection Clock Radio (Discontinued by Manufacturer)",
          "manufacturer": "HELLO KITTY",
          "modelNumber": "KT2054",
          "packageQuantity": 1,
          "partNumber": "KT2054",
          "websiteDisplayGroup": "ce_display_on_website"
        }
      ]
    },
    {
      "asin": "B00FFECUDQ",
      "summaries": [
        {
          "marketplaceId": "ATVPDKIKX0DER",
          "brand": "Hello Kitty",
          "itemClassification": "BASE_PRODUCT",
          "itemName": "Hello Kitty Coffee Maker",
          "manufacturer": "Sakar Intl",
          "modelNumber": "APP-36209",
          "packageQuantity": 1,
          "style": "Coffee Maker",
          "websiteDisplayGroup": "kitchen_display_on_website"
        }
      ]
    },
    {
      "asin": "1534418717",
      "summaries": [
        {
          "marketplaceId": "ATVPDKIKX0DER",
          "itemClassification": "BASE_PRODUCT",
          "itemName": "Hello Robots! (A Hello Book)",
          "manufacturer": "Little Simon",
          "websiteDisplayGroup": "book_display_on_website"
        }
      ]
    },
    {
      "asin": "B001E0L3MO",
      "summaries": [
        {
          "marketplaceId": "ATVPDKIKX0DER",
          "brand": "Hello Kitty",
          "itemClassification": "BASE_PRODUCT",
          "itemName": "HELLO KITTY 12009 Keychain Photo Frame",
          "manufacturer": "HELLO KITTY",
          "modelNumber": "12009",
          "packageQuantity": 1,
          "partNumber": "12009",
          "websiteDisplayGroup": "photo_display_on_website"
        }
      ]
    },
    {
      "asin": "B00021HBU4",
      "summaries": [
        {
          "marketplaceId": "ATVPDKIKX0DER",
          "brand": "Hello Kitty",
          "itemClassification": "BASE_PRODUCT",
          "itemName": "Hello Kitty - 2-Slice Wide slot toaster with cool Touch Exterior",
          "modelNumber": "KT5211",
          "packageQuantity": 1,
          "partNumber": "KT5211",
          "websiteDisplayGroup": "speakers_display_on_website"
        }
      ]
    },
    {
      "asin": "B010VIOD0S",
      "summaries": [
        {
          "marketplaceId": "ATVPDKIKX0DER",
          "brand": "Hello Kitty",
          "itemClassification": "BASE_PRODUCT",
          "itemName": "Hello Kitty School Bus Playset",
          "manufacturer": "Jada Toys - US",
          "modelNumber": "96981",
          "packageQuantity": 1,
          "partNumber": "96981",
          "websiteDisplayGroup": "toy_display_on_website"
        }
      ]
    },
    {
      "asin": "B074NHRVD6",
      "summaries": [
        {
          "marketplaceId": "ATVPDKIKX0DER",
          "brand": "Hello Kitty",
          "color": "Coral/Gold",
          "itemClassification": "BASE_PRODUCT",
          "itemName": "Hello Kitty 女童装饰短裙, 6, 珊瑚色",
          "manufacturer": "Hello Kitty",
          "modelNumber": "K3088751AM",
          "packageQuantity": 1,
          "partNumber": "K3088751AM-813-6",
          "size": "6",
          "style": "Hello Kitty Girls Embellished Tutu Dress",
          "websiteDisplayGroup": "apparel_display_on_website"
        }
      ]
    }
  ]
}

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 parámetro valor nextToken o el valor previousToken como el pageToken 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 previousToken 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: los tokens de página son específicos de la solicitud. No puede cambiar el tamaño de la página en la siguiente solicitud cuando usa un token de página.

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

¿Qué es la API de items del catálogo?

Características clave

Terminología

🚧Manejo de JSON Schemas genéricos en bibliotecas cliente

Tutorial: Recuperar detalles de un item individual en el catálogo de Amazon por su identificador (ASIN)

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

Tutorial: busque uno o más items por ASIN o identificadores de productos

Paso 1: Buscar items

Tutorial: Buscar items por palabras clave

Paso 1: Buscar items

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

🚧
Manejo de JSON Schemas genéricos en bibliotecas cliente