Amazon Selling Partner API (SP-API)-中文
工具首页问答社区广告API开发者申请AI智能助手官方文档TokenApi Reference
工具首页问答社区广告API开发者申请AI智能助手官方文档TokenApi Reference
  1. Catalog Items V0
  • Auth Token
    • 获取Token
    • 刷新Token
    • 获取无授权Token
  • Api Reference
    • Orders
      • getOrders
      • getOrder
      • getOrderBuyerInfo
      • getOrderAddress
      • getOrderItems
      • getOrderItemsBuyerInfo
      • updateShipmentStatus
      • getOrderRegulatedInfo
      • updateVerificationStatus
      • confirmShipment
    • Reports 2021-06-30
      • getReports
      • createReport
      • cancelReport
      • getReport
      • getReportSchedules
      • createReportSchedule
      • cancelReportSchedule
      • getReportSchedule
      • getReportDocument
    • Feeds 2021-06-30
      • getFeeds
      • createFeed
      • cancelFeed
      • getFeed
      • createFeedDocument
      • getFeedDocument
    • 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