Amazon Selling Partner API (SP-API)-中文
工具首页问答社区广告API开发者申请AI智能助手官方文档TokenApi Reference
工具首页问答社区广告API开发者申请AI智能助手官方文档TokenApi Reference
  1. Catalog Items V0
  • Orders
    • getOrders
      GET
    • getOrder
      GET
    • getOrderBuyerInfo
      GET
    • getOrderAddress
      GET
    • getOrderItems
      GET
    • getOrderItemsBuyerInfo
      GET
    • updateShipmentStatus
      POST
    • getOrderRegulatedInfo
      GET
    • updateVerificationStatus
      PATCH
    • confirmShipment
      POST
  • Reports 2021-06-30
    • getReports
      GET
    • createReport
      POST
    • cancelReport
      DELETE
    • getReport
      GET
    • getReportSchedules
      GET
    • createReportSchedule
      POST
    • cancelReportSchedule
      DELETE
    • getReportSchedule
      GET
    • getReportDocument
      GET
  • Feeds 2021-06-30
    • getFeeds
      GET
    • createFeed
      POST
    • cancelFeed
      DELETE
    • getFeed
      GET
    • createFeedDocument
      POST
    • getFeedDocument
      GET
  • Sellers
    • getMarketplaceParticipations
  • Pricing 2022-05-01
    • getFeaturedOfferExpectedPriceBatch
    • getCompetitiveSummary
  • Notifications
    • getSubscription
    • createSubscription
    • getSubscriptionById
    • deleteSubscriptionById
    • getDestinations
    • createDestination
    • getDestination
    • deleteDestination
  • A+ Content Management
    • searchContentDocuments
    • createContentDocument
    • getContentDocument
    • updateContentDocument
    • listContentDocumentAsinRelations
    • postContentDocumentAsinRelations
    • validateContentDocumentAsinRelations
    • searchContentPublishRecords
    • postContentDocumentApprovalSubmission
    • postContentDocumentSuspendSubmission
  • Application Management
    • rotateApplicationClientSecret
  • The AWD
    • getInboundShipment
    • listInboundShipments
    • listInventory
  • Catalog Items V0
    • listCatalogItems
      GET
    • getCatalogItem
      GET
    • listCatalogCategories
      GET
  • Catalog Items 2020-12-01
    • searchCatalogItems
    • getCatalogItem
  • Catalog Items 2022-04-01
    • searchCatalogItems
    • getCatalogItem
  • Data Kiosk
    • getQueries
    • createQuery
    • cancelQuery
    • getQuery
    • getDocument
  • Product Type Definitions
    • searchDefinitionsProductTypes
    • getDefinitionsProductType
  • Automotive.
    • getVehicles
  • Easy Ship
    • listHandoverSlots
    • getScheduledPackage
    • createScheduledPackage
    • updateScheduledPackages
    • createScheduledPackageBulk
  • FBA Inbound Eligibilty
    • getItemEligibilityPreview
  • FBA Inventory
    • getInventorySummaries
    • createInventoryItem
    • deleteInventoryItem
    • addInventory
  • Finances
    • listFinancialEventGroups
    • listFinancialEventsByGroupId
    • listFinancialEventsByOrderId
    • listFinancialEvents
  • Finances 2024-06-19
    • listTransactions
  • Fulfillment Inbound V0
    • createInboundShipmentPlan
    • createInboundShipment
    • updateInboundShipment
    • getPreorderInfo
    • confirmPreorder
    • getPrepInstructions
    • getTransportDetails
    • putTransportDetails
    • voidTransport
    • estimateTransport
    • confirmTransport
    • getLabels
    • getBillOfLading
    • getShipments
    • getShipmentItemsByShipmentId
    • getShipmentItems
  • Listings Items 2021-08-01
    • deleteListingsItem
    • getListingsItem
    • patchListingsItem
    • putListingsItem
    • searchListingsItems
  • Listings Restrictions
    • getListingsRestrictions
  • Merchant Fulfillment
    • getEligibleShipmentServices
    • getShipment
    • cancelShipment
    • createShipment
    • getAdditionalSellerInputs
  • Messaging
    • getMessagingActionsForOrder
    • confirmCustomizationDetails
    • createConfirmDeliveryDetails
    • createLegalDisclosure
    • createNegativeFeedbackRemoval
    • createConfirmOrderDetails
    • createConfirmServiceDetails
    • CreateAmazonMotors
    • CreateWarranty
    • GetAttributes
    • createDigitalAccessKey
    • createUnexpectedProblem
    • sendInvoice
  • Product Fees
    • getMyFeesEstimateForSKU
    • getMyFeesEstimateForASIN
    • getMyFeesEstimates
  • Pricing V0
    • getPricing
    • getCompetitivePricing
    • getListingOffers
    • getItemOffers
    • getItemOffersBatch
    • getListingOffersBatch
  • Replenishment
    • getSellingPartnerMetrics
    • listOfferMetrics
    • listOffers
  • Sales
    • getOrderMetrics
  • Services
    • getServiceJobByServiceJobId
    • cancelServiceJobByServiceJobId
    • completeServiceJobByServiceJobId
    • getServiceJobs
    • addAppointmentForServiceJobByServiceJobId
    • rescheduleAppointmentForServiceJobByServiceJobId
    • assignAppointmentResources
    • setAppointmentFulfillmentData
    • getRangeSlotCapacity
    • getFixedSlotCapacity
    • updateSchedule
    • createReservation
    • updateReservation
    • cancelReservation
    • getAppointmmentSlotsByJobId
    • getAppointmentSlots
    • createServiceDocumentUploadDestination
  • Shipment Invoicing
    • getShipmentDetails
    • submitInvoice
    • getInvoiceStatus
  • Shipping
    • createShipment
    • getShipment
    • cancelShipment
    • purchaseLabels
    • retrieveShippingLabel
    • purchaseShipment
    • getRates
    • getAccount
    • getTrackingInformation
  • Amazon Shipping API V2
    • getRates
    • directPurchaseShipment
    • purchaseShipment
    • oneClickShipment
    • getTracking
    • getShipmentDocuments
    • cancelShipment
    • getAdditionalInputs
    • getCarrierAccountFormInputs
    • getCarrierAccounts
    • linkCarrierAccount
    • unlinkCarrierAccount
    • generateCollectionForm
    • getCollectionFormHistory
    • getUnmanifestedShipments
    • getCollectionForm
    • getAccessPoints
  • Solicitations
    • getSolicitationActionsForOrder
    • createProductReviewAndSellerFeedbackSolicitation
  • Supply Sources
    • getSupplySources
    • createSupplySource
    • getSupplySource
    • updateSupplySource
    • archiveSupplySource
    • updateSupplySourceStatus
  • Transfers. transfers_2024-06-01
    • initiatePayout
    • getPaymentMethods
  • Tokens
    • createRestrictedDataToken
  • Uploads
    • createUploadDestinationForResource
  • Invoices.
    • getInvoicesAttributes
    • getInvoicesDocument
    • createInvoicesExport
    • getInvoicesExports
    • getInvoicesExport
    • getInvoices
    • getInvoice
  • FBA inbound operations. 2024-03-20
    • 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
    • getInboundOperationStatus
  • Fulfillment Outbound
    • getFulfillmentPreview
    • deliveryOffers
    • listAllFulfillmentOrders
    • createFulfillmentOrder
    • getPackageTrackingDetails
    • listReturnReasonCodes
    • createFulfillmentReturn
    • getFulfillmentOrder
    • updateFulfillmentOrder
    • cancelFulfillmentOrder
    • submitFulfillmentOrderStatusUpdate
    • getFeatures
    • getFeatureInventory
    • getFeatureSKU
  • Feeds 2020-09-04
    • getFeeds
    • createFeed
    • getFeed
    • cancelFeed
    • createFeedDocument
    • getFeedDocument
  • Reports 2020-09-04
    • getReports
    • createReport
    • getReport
    • cancelReport
    • getReportSchedules
    • createReportSchedule
    • getReportSchedule
    • cancelReportSchedule
    • getReportDocument
  • Listings Items 2020-09-01
    • deleteListingsItem
    • patchListingsItem
    • putListingsItem
  • Application integrations.
    • createNotification
    • deleteNotifications
    • recordActionFeedback
  • Direct Fulfillment Inventory Updates
    • submitInventoryUpdate
  • Direct Fulfillment Orders V1
    • getOrders
    • getOrder
    • submitAcknowledgement
  • Direct Fulfillment Orders 2021-12-28
    • getOrders
    • getOrder
    • submitAcknowledgement
  • Direct Fulfillment Payments
    • submitInvoice
  • Vendor Direct Fulfillment Sandbox Test Data
    • generateOrderScenarios
    • getOrderScenarios
  • Direct Fulfillment Shipping V1
    • getShippingLabels
    • submitShippingLabelRequest
    • getShippingLabel
    • submitShipmentConfirmations
    • submitShipmentStatusUpdates
    • getCustomerInvoices
    • getCustomerInvoice
    • getPackingSlips
    • getPackingSlip
  • Direct Fulfillment Shipping 2021-12-28
    • getShippingLabels
    • submitShippingLabelRequest
    • getShippingLabel
    • createShippingLabels
    • submitShipmentConfirmations
    • submitShipmentStatusUpdates
    • getCustomerInvoices
    • getCustomerInvoice
    • getPackingSlips
    • getPackingSlip
  • Direct Fulfillment Transaction Status V1
    • getTransactionStatus
  • Direct Fulfillment Transaction Status 2021-12-28
    • getTransactionStatus
  • Retail Procurement Payments
    • submitInvoices
  • Retail Procurement Orders
    • getPurchaseOrders
    • getPurchaseOrder
    • submitAcknowledgement
    • getPurchaseOrdersStatus
  • Retail Procurement Shipments
    • SubmitShipmentConfirmations
    • SubmitShipments
    • GetShipmentDetails
  • Retail Procurement Transaction Status
    • getTransaction
  1. Catalog Items V0

listCatalogItems

将废弃
北美(North America)
https://sellingpartnerapi-na.amazon.com
北美(North America)
https://sellingpartnerapi-na.amazon.com
GET
https://sellingpartnerapi-na.amazon.com
/catalog/v0/items
Catalog Items V0
自2022年9月30日起,Selling Partner API中Catalog Items v0的listCatalogItems操作将不再可用。作为替代,searchCatalogItems可在最新版本的Catalog Items的Selling Partner API v2022-04-01中使用。依赖于listCatalogItems操作的集成应迁移到searchCatalogItems操作,以避免服务中断。
注意: listCatalogCategories操作不会被弃用,您可以继续调用它。

请求参数

Query 参数
MarketplaceId
string 
必需
市场标识符。指定返回项目的市场。
Query
string 
可选
在目录中搜索项目的关键词。示例:‘哈利·波特书籍’。
QueryContextId
string 
可选
用于标识进行给定搜索的上下文。市场可能提供机制以限制搜索到潜在物品的子集。例如,零售市场允许将查询限制为特定类别。QueryContextId 参数指定这样的子集。如果省略该参数,将使用市场的默认上下文进行搜索,该上下文通常包含最大数量的物品。
SellerSKU
string 
可选
用于识别指定市场中的商品。SellerSKU 通过卖家的 SellerId 进行确认,该 SellerId 包含在您提交的每个操作中。
UPC
string 
可选
用于零售包装的12位条形码。
EAN
string 
可选
一个唯一标识目录项目、制造商及其属性的欧洲文章编号。
ISBN
string 
可选
用于国际识别图书的独特商业书籍标识符。
JAN
string 
可选
一个独特标识产品、制造商及其属性的日本文章编号。

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://sellingpartnerapi-na.amazon.com/catalog/v0/items?MarketplaceId'

返回响应

🟢200成功
application/json
成功。
Headers
x-amzn-RateLimit-Limit
string 
可选
您对此操作的速率限制(每秒请求数量)。
x-amzn-RequestId
string 
唯一请求参考ID。
可选
Body
payload
object (ListMatchingItemsResponse) 
可选
Items
array[object (Item) {4}] 
一份物品清单。
可选
errors
array[object (Error) {3}] 
可选
请求失败时返回的错误响应列表。
code
string 
必需
一个标识发生错误类型的错误代码。
message
string 
必需
一种以人类可读的形式描述错误状态的消息。
details
string 
可选
可以帮助来电者理解或解决问题的额外信息。
示例
{
    "payload": {
        "Items": [
            {
                "Identifiers": {
                    "MarketplaceASIN": {
                        "MarketplaceId": "string",
                        "ASIN": "string"
                    },
                    "SKUIdentifier": {
                        "MarketplaceId": "string",
                        "SellerId": "string",
                        "SellerSKU": "string"
                    }
                },
                "AttributeSets": [
                    {
                        "Actor": [
                            "string"
                        ],
                        "Artist": [
                            "string"
                        ],
                        "AspectRatio": "string",
                        "AudienceRating": "string",
                        "Author": [
                            "string"
                        ],
                        "BackFinding": "string",
                        "BandMaterialType": "string",
                        "Binding": "string",
                        "BlurayRegion": "string",
                        "Brand": "string",
                        "CeroAgeRating": "string",
                        "ChainType": "string",
                        "ClaspType": "string",
                        "Color": "string",
                        "CpuManufacturer": "string",
                        "CpuSpeed": {
                            "value": 0,
                            "Units": "string"
                        },
                        "CpuType": "string",
                        "Creator": [
                            {
                                "value": "string",
                                "Role": "string"
                            }
                        ],
                        "Department": "string",
                        "Director": [
                            "string"
                        ],
                        "DisplaySize": {
                            "value": 0,
                            "Units": "string"
                        },
                        "Edition": "string",
                        "EpisodeSequence": "string",
                        "EsrbAgeRating": "string",
                        "Feature": [
                            "string"
                        ],
                        "Flavor": "string",
                        "Format": [
                            "string"
                        ],
                        "GemType": [
                            "string"
                        ],
                        "Genre": "string",
                        "GolfClubFlex": "string",
                        "GolfClubLoft": {
                            "value": 0,
                            "Units": "string"
                        },
                        "HandOrientation": "string",
                        "HardDiskInterface": "string",
                        "HardDiskSize": {
                            "value": 0,
                            "Units": "string"
                        },
                        "HardwarePlatform": "string",
                        "HazardousMaterialType": "string",
                        "ItemDimensions": {
                            "Height": {
                                "value": 0,
                                "Units": "string"
                            },
                            "Length": {
                                "value": 0,
                                "Units": "string"
                            },
                            "Width": {
                                "value": 0,
                                "Units": "string"
                            },
                            "Weight": {
                                "value": 0,
                                "Units": "string"
                            }
                        },
                        "IsAdultProduct": true,
                        "IsAutographed": true,
                        "IsEligibleForTradeIn": true,
                        "IsMemorabilia": true,
                        "IssuesPerYear": "string",
                        "ItemPartNumber": "string",
                        "Label": "string",
                        "Languages": [
                            {
                                "Name": "string",
                                "Type": "string",
                                "AudioFormat": "string"
                            }
                        ],
                        "LegalDisclaimer": "string",
                        "ListPrice": {
                            "Amount": 0,
                            "CurrencyCode": "string"
                        },
                        "Manufacturer": "string",
                        "ManufacturerMaximumAge": {
                            "value": 0,
                            "Units": "string"
                        },
                        "ManufacturerMinimumAge": {
                            "value": 0,
                            "Units": "string"
                        },
                        "ManufacturerPartsWarrantyDescription": "string",
                        "MaterialType": [
                            "string"
                        ],
                        "MaximumResolution": {
                            "value": 0,
                            "Units": "string"
                        },
                        "MediaType": [
                            "string"
                        ],
                        "MetalStamp": "string",
                        "MetalType": "string",
                        "Model": "string",
                        "NumberOfDiscs": 0,
                        "NumberOfIssues": 0,
                        "NumberOfItems": 0,
                        "NumberOfPages": 0,
                        "NumberOfTracks": 0,
                        "OperatingSystem": [
                            "string"
                        ],
                        "OpticalZoom": {
                            "value": 0,
                            "Units": "string"
                        },
                        "PackageDimensions": {
                            "Height": {
                                "value": 0,
                                "Units": "string"
                            },
                            "Length": {
                                "value": 0,
                                "Units": "string"
                            },
                            "Width": {
                                "value": 0,
                                "Units": "string"
                            },
                            "Weight": {
                                "value": 0,
                                "Units": "string"
                            }
                        },
                        "PackageQuantity": 0,
                        "PartNumber": "string",
                        "PegiRating": "string",
                        "Platform": [
                            "string"
                        ],
                        "ProcessorCount": 0,
                        "ProductGroup": "string",
                        "ProductTypeName": "string",
                        "ProductTypeSubcategory": "string",
                        "PublicationDate": "string",
                        "Publisher": "string",
                        "RegionCode": "string",
                        "ReleaseDate": "string",
                        "RingSize": "string",
                        "RunningTime": {
                            "value": 0,
                            "Units": "string"
                        },
                        "ShaftMaterial": "string",
                        "Scent": "string",
                        "SeasonSequence": "string",
                        "SeikodoProductCode": "string",
                        "Size": "string",
                        "SizePerPearl": "string",
                        "SmallImage": {
                            "URL": "string",
                            "Height": {
                                "value": 0,
                                "Units": "string"
                            },
                            "Width": {
                                "value": 0,
                                "Units": "string"
                            }
                        },
                        "Studio": "string",
                        "SubscriptionLength": {
                            "value": 0,
                            "Units": "string"
                        },
                        "SystemMemorySize": {
                            "value": 0,
                            "Units": "string"
                        },
                        "SystemMemoryType": "string",
                        "TheatricalReleaseDate": "string",
                        "Title": "string",
                        "TotalDiamondWeight": {
                            "value": 0,
                            "Units": "string"
                        },
                        "TotalGemWeight": {
                            "value": 0,
                            "Units": "string"
                        },
                        "Warranty": "string",
                        "WeeeTaxValue": {
                            "Amount": 0,
                            "CurrencyCode": "string"
                        }
                    }
                ],
                "Relationships": [
                    {
                        "Identifiers": {
                            "MarketplaceASIN": {
                                "MarketplaceId": "string",
                                "ASIN": "string"
                            },
                            "SKUIdentifier": {
                                "MarketplaceId": "string",
                                "SellerId": "string",
                                "SellerSKU": "string"
                            }
                        },
                        "Color": "string",
                        "Edition": "string",
                        "Flavor": "string",
                        "GemType": [
                            "string"
                        ],
                        "GolfClubFlex": "string",
                        "HandOrientation": "string",
                        "HardwarePlatform": "string",
                        "MaterialType": [
                            "string"
                        ],
                        "MetalType": "string",
                        "Model": "string",
                        "OperatingSystem": [
                            "string"
                        ],
                        "ProductTypeSubcategory": "string",
                        "RingSize": "string",
                        "ShaftMaterial": "string",
                        "Scent": "string",
                        "Size": "string",
                        "SizePerPearl": "string",
                        "GolfClubLoft": {
                            "value": 0,
                            "Units": "string"
                        },
                        "TotalDiamondWeight": {
                            "value": 0,
                            "Units": "string"
                        },
                        "TotalGemWeight": {
                            "value": 0,
                            "Units": "string"
                        },
                        "PackageQuantity": 0,
                        "ItemDimensions": {
                            "Height": {
                                "value": 0,
                                "Units": "string"
                            },
                            "Length": {
                                "value": 0,
                                "Units": "string"
                            },
                            "Width": {
                                "value": 0,
                                "Units": "string"
                            },
                            "Weight": {
                                "value": 0,
                                "Units": "string"
                            }
                        }
                    }
                ],
                "SalesRankings": [
                    {
                        "ProductCategoryId": "string",
                        "Rank": 0
                    }
                ]
            }
        ]
    },
    "errors": [
        {
            "code": "string",
            "message": "string",
            "details": "string"
        }
    ]
}
🟠400请求有误
🟠401没有权限
🟠403禁止访问
🟠404记录不存在
🟠429429
🔴500服务器错误
🔴503服务器故障

技术咨询扫码联系作者

SP-API技术咨询,开发者申请,Amazon ERP源码

扫码加入交流群
上一页
listInventory
下一页
getCatalogItem
Built with