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

getCatalogItem

将废弃
北美(North America)
https://sellingpartnerapi-na.amazon.com
北美(North America)
https://sellingpartnerapi-na.amazon.com
GET
https://sellingpartnerapi-na.amazon.com
/catalog/v0/items/{asin}
Catalog Items V0
自2022年9月30日起,getCatalogItem 操作将在销售合作伙伴API的目录项目v0中不再提供。此操作在最新版本的 销售合作伙伴API for Catalog Items v2022-04-01 中可用。依赖该操作的集成应迁移到最新版本以避免服务中断。
注意: listCatalogCategories 操作不会被弃用,您可以继续调用它。

请求参数

Path 参数
asin
string 
必需
该商品的亚马逊标准识别号码(ASIN)。
Query 参数
MarketplaceId
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 (Item) 
可选
亚马逊目录中的一件商品。
Identifiers
object (IdentifierType) 
必需
AttributeSets
array[object (AttributeSetListType) {96}] 
该物品的属性列表。
可选
Relationships
array[object (RelationshipType) {23}] 
可选
一份变体关系信息列表(如适用),针对该项目。
SalesRankings
array[object (SalesRankType) {2}] 
可选
按类别的商品销售排名信息列表。
errors
array[object (Error) {3}] 
可选
请求失败时返回的错误响应列表。
code
string 
必需
一个标识发生错误类型的错误代码。
message
string 
必需
一种以人类可读的形式描述错误状态的消息。
details
string 
可选
可以帮助来电者理解或解决问题的额外信息。
示例
{
    "payload": {
        "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源码

扫码加入交流群
上一页
listCatalogItems
下一页
listCatalogCategories
Built with