Dokumentation
Entwickler-HubAPI-StatusUnterstützung
Fangen Sie an zu tippen, um zu suchen...

Katalogartikel-API v2020-12-01: Leitfaden für Anwendungsfälle

So verwenden Sie die Katalogartikel-API.

API-Version: 2020-12-01

Was ist die Katalogartikel-API?

Mithilfe der Verkaufspartner-API für Katalogartikel (Katalogartikel-API) können Sie Informationen über Artikel im Amazon-Katalog abrufen. Weitere Informationen finden Sie unter API-Referenz für Katalogartikel für Details zu API-Vorgänge und zugehörigen Datentypen und Schemas.

Die wichtigsten Funktionen

  • Retrieve Detailed Item Information: The Catalog Items API provides details about items in the Amazon catalog, such as summarized item details, product identifiers, sales rankings, variations, and thumbnail images. Vendors can retrieve additional vendor-specific details and brand owners of items can retrieve additional attributes and image content.
  • Suchen Sie nach Artikeln: Mit der Katalogartikel-API können Sie den Amazon-Katalog anhand von Schlüsselwörtern, einschließlich Produkt-IDs, nach vorhandenen Artikeln durchsuchen.

Terminologie

  • ASIN: Amazon-Standard-Identifikationsnummer, die einen Artikel im Amazon-Katalog identifiziert.
  • Variation: Jede Farbe oder Größe eines Katalogartikels steht für eine Variante, der eine andere ASIN zugewiesen ist. Sie werden als Varianten einer übergeordneten ASIN zusammengefasst.

🚧

Umgang mit generischen JSON-Schemas in Client-Bibliotheken

Wenn Sie eine Client-Bibliothek generiert haben, ist es wichtig zu beachten, dass Swagger Codegen Typen basierend auf Eigenschaften generiert, die in den Swagger-Modellen definiert sind, und dass Swagger Codegen leere oder unvollständige Typen erzeugt, wenn ein Objekt mit additionalProperties: true definiert ist. Um solche Objekten handzuhaben, verwenden Sie den --import-mappings-Befehlszeilenparameter, um diese Objekte einem generischen JSON-Objekttyp oder einem benutzerdefinierten Objekttyp Ihrer Wahl zuzuordnen.

Beispiel für Swagger Codegen-Eingabeparameter:

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

Tutorial: Details für einen Artikel im Amazon-Katalog abrufen

Verwenden Sie dieses Tutorial, um Informationen zu einem Artikel im Amazon-Katalog für die angegebene ASIN und die angegebenen Online-Marktplätze abzurufen.

Voraussetzungen

Um dieses Tutorial abzuschließen, benötigen Sie Folgendes:

  • Authorization from the Selling Partner for whom you are making calls. Refer to Authorizing Selling Partner API Applications for more information.
  • Genehmigung für die Rolle "Produktliste" in Ihrem Entwicklerprofil.
  • Die Rolle "Produktliste", die auf der App-Registrierungsseite für Ihre App ausgewählt wurde.

Schritt 1: Informationen zu einem Katalogartikel abrufen

Rufen Sie den getCatalogItem-Vorgang auf, wobei die folgenden Parameter übergeben werden:

Parameter anfordern

Pfadparameter

Parameter Beispiel Beschreibung Erforderlich
asin XXXXXXXXXX Amazon-Standard-Identifikationsnummer für den Artikel von Interesse.

Typ: Zeichenfolge

 Ja

Abfrageparameter

Parameter Beispiel Beschreibung Erforderlich
marketplaceIds ATVPDKIKX0DER A comma-delimited list of Amazon marketplace identifiers.

Refer to Marketplace IDs for the list of Amazon marketplace identifiers.

Typ: < Zeichenfolge > Array( csv)

 Ja
includedData summaries Eine kommagetrennte Liste mit Artikeldetails, die angefordert werden sollen. Wenn keine angegeben sind, werden standardmäßig summaries-Daten zurückgegeben.

  • attributes - Auflistbare Artikelattribute. Verfügbar für den Markeninhaber des Artikels. Enthält alle auflistbaren Artikelattribute, die auf dem Artikel für den jeweiligen Produkttyp vorhanden sind.
  • identifiers - Externe Artikelkennzeichnungen wie EAN, UPC, ISBN usw.
  • images - Produktbilder. Jedes Produktbild enthält den Namen der Bildvariante, die Auflösung und einen Link zum Herunterladen des Bildes. Alle Anfragen nach Bildern enthalten das HAUPT-Produktbild in geringer Auflösung. Anfragen von Markeninhabern werden zusätzlich andere Bildvarianten in voller Auflösung enthalten.
  • productTypes - Item product type data. The category of this product in the Amazon marketplace.
  • salesRanks - Daten zur Verkaufsrangliste von Artikeln Jede Verkaufsrangliste enthält den Namen der Kategorie, die Platzierung des Artikels und einen Link zur Seite mit der Verkaufsrangliste auf der Einzelhandels-Website.
  • summaries - Zusammenfassung der Artikeldaten. Grundlegende Attribute wie Artikelname, Hersteller und Marke.
  • variations - Daten zur Artikelvariante. Enthält die Liste der ASINs der Artikel, die sich auf diesen Artikel beziehen, und gibt an, ob es sich bei diesem Artikel um einen untergeordneten oder übergeordneten Artikel handelt.
  • vendorDetails - Artikeldaten für Anbieter. Für Anbieter verfügbar. Enthält Informationen zu Artikelauffüllung, Marke und Hersteller.

Typ: < Aufzählung (IncludedData) > Array (csv)

 Nein
locale en_US Gebietsschema zum Abrufen lokalisierter Zusammenfassungen. Standardmäßig wird das primäre Gebietsschema des Online-Marktplatzes verwendet.

Typ: Zeichenfolge

 Nein

Beispiel für eine Anforderung

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

Antwort

Eine erfolgreiche Antwort umfasst Folgendes:

Name Beispiel Beschreibung
asin XXXXXXXXXX Die angeforderte ASIN.

Typ: ItemAsin
attributes Beziehen Sie sich auf die Beispielantwort Ein JSON-Objekt, das detaillierte Katalogelementdaten enthält. Werte von mehreren Marktplätzen werden unter jedem Attributnamen in einer Liste zusammengefasst.

Typ: ItemAttributes
identifiers Beziehen Sie sich auf die Beispielantwort Externe Identifikatoren wie UPC, EAN, falls zutreffend.

Typ: ItemIdentifiers
images Beziehen Sie sich auf die Beispielantwort Bilddaten für den Artikel.

Typ: ItemImages
productTypes Beziehen Sie sich auf die Beispielantwort Die Produkttypkategorie des Artikels im Amazon-Katalog.

Typ: ItemProductTypes
ranks Beziehen Sie sich auf die Beispielantwort Die Verkaufsrangdaten für den Artikel in jeder Kategorie, in der er nachverfolgt wird.

Typ: ItemSalesRanks
summaries Beziehen Sie sich auf die Beispielantwort Zusammenfassung der Artikeldaten.

Typ: ItemSummaries
variations Beziehen Sie sich auf die Beispielantwort Andere ASINs, die sich auf diese ASINs beziehen, und ob es sich um eine übergeordnete ASIN oder eine untergeordnete ASIN handelt.

Typ: ItemVariations
vendorDetails Beziehen Sie sich auf die Beispielantwort Detaillierte Herstellerinformationen für dieses Produkt.

Typ: ItemVendorDetails

Beispiel für eine Antwort

{
  "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: Im Amazon-Katalog nach Artikeln suchen

Verwenden Sie dieses Tutorial, um im Amazon-Katalog nach Artikeln zu suchen.

Voraussetzungen

Um dieses Tutorial abzuschließen, benötigen Sie Folgendes:

  • Authorization from the Selling Partner for whom you are making calls. Refer to Authorizing Selling Partner API Applications for more information.
  • Genehmigung für die Rolle "Produktliste" in Ihrem Entwicklerprofil.
  • Die Rolle "Produktliste", die auf der App-Registrierungsseite für Ihre App ausgewählt wurde.

Schritt 1: Eine Liste der Katalogelemente und der zugehörigen Informationen abrufen

Um nach einer Liste von Katalogelementen mit den von Ihnen angegebenen optionalen zugehörigen Informationen zu suchen und diese zurückzugeben, rufen Sie den Vorgang searchCatalogItems auf.

Rufen Sie den searchCatalogItems-Vorgang auf, wobei die folgenden Parameter übergeben werden:

Parameter anfordern

Abfrageparameter

Parameter Beispiel Beschreibung Erforderlich
keywords shoes Eine kommagetrennte Liste von Wörtern oder Artikelkennungen, nach denen im Amazon-Katalog gesucht werden soll.

Typ: < Zeichenfolge > Array( csv)

 Ja
marketplaceIds ATVPDKIKX0DER A comma-delimited list of Amazon marketplace identifiers.

Refer to Marketplace IDs for the list of Amazon marketplace identifiers.

Typ: < Zeichenfolge > Array( csv)

 Ja
includedData summaries Eine kommagetrennte Liste mit Artikeldetails, die angefordert werden sollen. Wenn keine angegeben sind, werden standardmäßig summaries-Daten zurückgegeben.

  • identifiers - Externe Artikelkennzeichnungen wie EAN, UPC, ISBN usw.
  • images - Produktbilder. Jedes Produktbild enthält den Namen der Bildvariante, die Auflösung und einen Link zum Herunterladen des Bildes. Alle Anfragen nach Bildern enthalten das HAUPT-Produktbild in geringer Auflösung. Anfragen von Markeninhabern werden zusätzlich andere Bildvarianten in voller Auflösung enthalten.
  • productTypes - Item product type data. The category of this product in the Amazon marketplace.
  • salesRanks - Daten zur Verkaufsrangliste von Artikeln Jede Verkaufsrangliste enthält den Namen der Kategorie, die Platzierung des Artikels und einen Link zur Seite mit der Verkaufsrangliste auf der Einzelhandels-Website.
  • summaries - Zusammenfassung der Artikeldaten. Grundlegende Attribute wie Artikelname, Hersteller und Marke.
  • variations - Daten zur Artikelvariante. Enthält die Liste der ASINs der Artikel, die sich auf diesen Artikel beziehen, und gibt an, ob es sich bei diesem Artikel um einen untergeordneten oder übergeordneten Artikel handelt.
  • vendorDetails - Artikeldaten für Anbieter. Für Anbieter verfügbar. Enthält Informationen zu Artikelauffüllung, Marke und Hersteller.

Typ: < Aufzählung (IncludedData) > Array (csv)

 Nein
brandNames Beautiful Boats Eine kommagetrennte Liste von Markennamen, auf die die Suche beschränkt werden soll.

Typ: < Zeichenfolge > Array( csv)

 Nein
classificationIds 12345678 Eine kommagetrennte Liste von Klassifikationsbezeichnern, auf die die Suche beschränkt werden soll.

Typ: < Zeichenfolge > Array( csv)

 Nein
pageSize 9 Anzahl der Ergebnisse, die pro Seite zurückgegeben werden sollen.

Standard: 10

Typ: Ganzzahl

 Nein
pageToken Beziehen Sie sich auf die Beispielantwort. Ein Token zum Abrufen einer bestimmten Seite, wenn Ergebnisse im Wert von mehreren Seiten vorliegen.

Typ: Zeichenfolge

 Nein
keywordsLocale en-US Die Sprache, in der die Schlüsselwörter bereitgestellt werden. Die Schlüsselwörter werden in das Antwortgebietsschema übersetzt, damit gesucht werden kann, falls sich die beiden unterscheiden.

Typ: Zeichenfolge

 Nein
locale es-US Gibt Ergebnisse in dieser Sprache zurück, falls verfügbar. Wenn dieser Parameter nicht angegeben ist, werden die Ergebnisse in der Standardsprache des Online-Marktplatz zurückgegeben.

Typ: Zeichenfolge

 Nein

Beispiel für eine Anforderung

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

Antwort

Eine erfolgreiche Antwort umfasst Folgendes:

Name Beispiel Beschreibung
numberOfResults 3097 Die Gesamtzahl der Produkte, auf die die Suchabfrage zutrifft (nur Ergebnisse bis zur Seitenanzahl werden pro Anfrage zurückgegeben, unabhängig von der gefundenen Anzahl).

Typ: Ganzzahl
pagination Beziehen Sie sich auf die Beispielantwort Ein JSON-Objekt, das ein oder mehrere Seitentoken enthält, mit denen die nächste oder vorherige Ergebnisseite abgerufen werden kann.

Typ: Pagination
refinements Beziehen Sie sich auf die Beispielantwort Ein JSON-Objekt, das Schlüssel enthält, mit denen die Suchergebnisse auf bestimmte Marken oder Kategorien verfeinert werden können.

Typ: Refinements
items Beziehen Sie sich auf die Beispielantwort Eine Liste der Artikel aus dem Amazon-Katalog.

Typ: < Item > Reihe

Beispiel für eine Antwort

{
    "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"
                }
            ]
        }
    ]
}

Paging als Antwort auf eine Suche nach Artikeln im Amazon-Katalog

Wenn ein Aufruf des searchCatalogItems-Vorgangs eine Antwort erzeugt, die pageSize überschreitet, erfolgt Paginierung. Das bedeutet, dass die Antwort in einzelne Seiten aufgeteilt ist, wobei jede Seite in aufeinanderfolgenden Aufrufen zurückgegeben wird. Um die nächste Seite oder die vorherige Seite abzurufen, müssen Sie den nextToken-Wert oder den previousToken-Wert als den pageToken-Parameter in der nächsten Anfrage weitergeben.

Sie erhalten die erste Seite mit Ergebnissen, wenn Sie den searchCatalogItems-Vorgang aufrufen und kein Seitentoken angeben. Anschließend iterieren Sie durch die restlichen Seiten mit dem nextToken-Seitentoken, das in aufeinanderfolgenden Antworten bereitgestellt wurde.

Seitentoken sind spezielle Werte, die dekodiert werden, um zu bestimmen, welche Seite angefordert wird und wie viele Seiten davor oder danach liegen.

Wenn die nächste oder vorherige Seite nicht verfügbar ist, wird das entsprechende Seitentokenattribut (nextToken bzw. previousToken) nicht im pagination-Objekt vorhanden sein.

Beispiele:

Wenn die Antwort pageSize nicht überschreitet, gibt es keine Paginierung, also gibt es weder nextToken noch previousToken:

"pagination": {
},

Wenn die Antwort pageSize überschreitet und die Paginierung erfolgt:

Für die erste Seite gibt es keine vorherige Seite, also gibt es kein previousToken:

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

Für die letzte Seite gibt es keine nächste Seite, also gibt es kein nextToken:

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

Für alle anderen Seiten:

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

📘

Hinweis

Even though there can be more than 1000 ASINs that match the search criteria, the maximum number of results that can be returned and paged through is limited to 1000. For example, if the caller sets the pageSize to 10, the maximum number of possible pages is 100.

Updated 6 months ago

Hat Ihnen diese Seite weitergeholfen?