Amazon SP API
    Amazon SP API
    • Overview
    • Authorization Workflow
    • Permissions
    • Sandbox
    • API Models
    • Available API Models
    • Request Apidog Access
    • OPENAPI SPECIFICATION
    • Research Docs
      • Amazon Seller Order Fulfillment Workflow
    • Amazon Warehousing and Distribution
      • getInboundShipment
        GET
      • listInboundShipments
        GET
      • listInventory
        GET
    • Authorization
      • Authorization
        POST
    • Catalog Items
      • searchCatalogItems
        GET
      • getCatalogItem
        GET
    • Catalog [Deprecated]
      • listCatalogItems
        GET
      • getCatalogItem
        GET
      • listCatalogCategories
        GET
    • Definitions
      • searchDefinitionsProductTypes
        GET
      • getDefinitionsProductType
        GET
    • Easy Ship
      • listHandoverSlots
        POST
      • getScheduledPackage
        GET
      • createScheduledPackage
        POST
      • updateScheduledPackages
        PATCH
      • createScheduledPackageBulk
        POST
    • FBAInbound
      • listInboundPlans
      • createInboundPlan
      • getInboundPlan
      • listInboundPlanBoxes
      • cancelInboundPlan
      • listInboundPlanItems
      • updateInboundPlanName
      • listPackingGroupBoxes
      • listPackingGroupItems
      • setPackingInformation
      • listPackingOptions
      • generatePackingOptions
      • confirmPackingOption
      • listInboundPlanPallets
      • listPlacementOptions
      • generatePlacementOptions
      • confirmPlacementOption
      • getShipment
      • listShipmentBoxes
      • listShipmentContentUpdatePreviews
      • generateShipmentContentUpdatePreviews
      • getShipmentContentUpdatePreview
      • confirmShipmentContentUpdatePreview
      • getDeliveryChallanDocument
      • listDeliveryWindowOptions
      • generateDeliveryWindowOptions
      • confirmDeliveryWindowOptions
      • listShipmentItems
      • updateShipmentName
      • listShipmentPallets
      • cancelSelfShipAppointment
      • getSelfShipAppointmentSlots
      • generateSelfShipAppointmentSlots
      • scheduleSelfShipAppointment
      • updateShipmentSourceAddress
      • updateShipmentTrackingDetails
      • listTransportationOptions
      • generateTransportationOptions
      • confirmTransportationOptions
      • listItemComplianceDetails
      • updateItemComplianceDetails
      • createMarketplaceItemLabels
      • listPrepDetails
      • setPrepDetails
      • getInboundOperationStatus
      • getItemEligibilityPreview
    • FBAInventory
      • getInventorySummaries
      • createInventoryItem
      • deleteInventoryItem
      • addInventory
    • FBAOutbound
      • getFulfillmentPreview
      • deliveryOffers
      • listAllFulfillmentOrders
      • createFulfillmentOrder
      • getPackageTrackingDetails
      • listReturnReasonCodes
      • createFulfillmentReturn
      • getFulfillmentOrder
      • updateFulfillmentOrder
      • cancelFulfillmentOrder
      • submitFulfillmentOrderStatusUpdate
      • getFeatures
      • getFeatureInventory
      • getFeatureSKU
    • Feeds
      • getFeeds
      • createFeed
      • cancelFeed
      • getFeed
      • createFeedDocument
      • getFeedDocument
    • Fees
      • getMyFeesEstimateForSKU
      • getMyFeesEstimateForASIN
      • getMyFeesEstimates
    • Finance
      • listTransactions
      • listFinancialEventGroups
      • listFinancialEventsByGroupId
      • listFinancialEventsByOrderId
      • listFinancialEvents
    • Invoices [Brazil]
      • getInvoicesAttributes
      • getInvoicesDocument
      • createInvoicesExport
      • getInvoicesExports
      • getInvoicesExport
      • getInvoices
      • getInvoice
    • Listings Items
      • getListingsRestrictions
      • deleteListingsItem
      • getListingsItem
      • patchListingsItem
      • putListingsItem
    • Merchant Fulfillment
      • getEligibleShipmentServices
      • getShipment
      • cancelShipment
      • createShipment
      • getAdditionalSellerInputs
    • Orders
      • getOrders
      • getOrder
      • getOrderBuyerInfo
      • getOrderAddress
      • getOrderItems
      • getOrderItemsBuyerInfo
      • updateShipmentStatus
      • getOrderRegulatedInfo
      • updateVerificationStatus
      • confirmShipment
    • ProductPricing
      • deprecated
        • getPricing
        • getCompetitivePricing
        • getListingOffers
        • getItemOffers
        • getItemOffersBatch
        • getListingOffersBatch
      • getFeaturedOfferExpectedPriceBatch
      • getCompetitiveSummary
    • Reports
      • getReports
      • createReport
      • cancelReport
      • getReport
      • getReportSchedules
      • createReportSchedule
      • cancelReportSchedule
      • getReportSchedule
      • getReportDocument
    • Sales
      • getOrderMetrics
    • Sellers
      • getMarketplaceParticipations
      • getAccount
    • Service
      • getServiceJobByServiceJobId
      • cancelServiceJobByServiceJobId
      • completeServiceJobByServiceJobId
      • getServiceJobs
      • addAppointmentForServiceJobByServiceJobId
      • rescheduleAppointmentForServiceJobByServiceJobId
      • assignAppointmentResources
      • setAppointmentFulfillmentData
      • getRangeSlotCapacity
      • getFixedSlotCapacity
      • updateSchedule
      • createReservation
      • updateReservation
      • cancelReservation
      • getAppointmmentSlotsByJobId
      • getAppointmentSlots
      • createServiceDocumentUploadDestination
    • ShipmentInvoice[Brazil]
      • getShipmentDetails
      • submitInvoice
      • getInvoiceStatus
    • Shipping
      • getRates
      • createShipment
      • directPurchaseShipment
      • getShipment
      • purchaseShipment
      • cancelShipment
      • oneClickShipment
      • purchaseLabels
      • getTracking
      • retrieveShippingLabel
      • getShipmentDocuments
      • purchaseShipment
      • cancelShipment
      • getRates
      • getAdditionalInputs
      • getAccount
      • getCarrierAccountFormInputs
      • getTrackingInformation
      • getCarrierAccounts
      • linkCarrierAccount
      • unlinkCarrierAccount
      • generateCollectionForm
      • getCollectionFormHistory
      • getUnmanifestedShipments
      • getCollectionForm
      • getAccessPoints
    • Supply Sources
      • getSupplySources
      • createSupplySource
      • getSupplySource
      • updateSupplySource
      • archiveSupplySource
      • updateSupplySourceStatus
    • Tokens
      • createRestrictedDataToken
    • Uploads
      • createUploadDestinationForResource
    • Notifications
      • getSubscription
      • createSubscription
      • getSubscriptionById
      • deleteSubscriptionById
      • getDestinations
      • createDestination
      • getDestination
      • deleteDestination

    Catalog Items

    The Selling Partner API for Catalog Items (Catalog Items API) allows developers to retrieve comprehensive information about items in the Amazon catalog. For technical details, refer to the Catalog Items API Reference.

    Key Features#

    1. Retrieve Detailed Item Information#

    The API provides rich details about items in the Amazon catalog, including:
    Summarized Item Details
    Attributes
    Browse Classifications
    Dimensions
    Product Identifiers
    Images
    Sales Rankings
    Relationships
    Vendors can access additional vendor-specific details.

    2. Search by Identifiers or Keywords#

    The API supports two main search methods:
    By Identifiers: Search using identifiers like UPC or EAN (up to 20 per request).
    By Keywords: Search for items in the Amazon catalog using keywords.
    Regardless of the search method, the following details are available:
    Item details
    Associated information
    Explicit retrieval by ASIN

    Terminology#

    ASIN#

    The Amazon Standard Identification Number uniquely identifies an item in the Amazon catalog.

    SKU#

    A Selling Partner-Supplied SKU identifies a seller or vendor's listing. Data from one or more selling partner listings are reconciled into items in the Amazon catalog.

    Variation#

    Variations represent a relationship between Amazon catalog items grouped by attributes such as size or color. These relationships consist of:
    Parent Item: Groups all related child items into a "variation family."
    Child Items: Each distinct item, such as a specific size or color.

    Example#

    A shirt available in multiple sizes and colors will:
    Have child items for each size and color combination.
    Be grouped under a parent item to create a unified product detail page on Amazon retail websites.

    The Catalog Items API empowers developers to interact with Amazon's catalog efficiently, offering a structured way to retrieve and search for item information.

    Tutorial#

    1. Retrieve details for an individual item in the Amazon catalog by its identifier (ASIN)#

    Get Information About a Catalog Item#

    To retrieve information for a specific item, use the getCatalogItem operation and pass the ASIN as a path parameter.

    Request#

    2. Search for one or more items by ASINs or product identifiers#

    Search for items#

    Call the searchCatalogItems operation

    Request#

    Response#

    {
      "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"
            }
          ]
        }
      ]
    }
    Previous
    Authorization
    Next
    searchCatalogItems
    Built with