Amazon Selling Partner API (SP-API)-中文
工具首页问答社区广告API开发者申请AI智能助手官方文档TokenApi Reference
工具首页问答社区广告API开发者申请AI智能助手官方文档TokenApi Reference
  1. Listings Items 2021-08-01
  • Auth Token
    • 获取Token
    • 刷新Token
    • 获取无授权Token
  • Api Reference
    • A+ Content Management
      • searchContentDocuments
      • createContentDocument
      • getContentDocument
      • updateContentDocument
      • listContentDocumentAsinRelations
      • postContentDocumentAsinRelations
      • validateContentDocumentAsinRelations
      • searchContentPublishRecords
      • postContentDocumentApprovalSubmission
      • postContentDocumentSuspendSubmission
    • Application Management
      • rotateApplicationClientSecret
    • AWD
      • getInboundShipment
      • listInboundShipments
      • listInventory
    • 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
    • Easy Ship
      • listHandoverSlots
      • getScheduledPackage
      • createScheduledPackage
      • updateScheduledPackages
      • createScheduledPackageBulk
    • FBA Inbound Eligibilty
      • getItemEligibilityPreview
    • FBA Inventory
      • getInventorySummaries
      • createInventoryItem
      • deleteInventoryItem
      • addInventory
    • Feeds 2020-09-04
      • getFeeds
      • createFeed
      • getFeed
      • cancelFeed
      • createFeedDocument
      • getFeedDocument
    • Feeds 2021-06-30
      • getFeeds
      • createFeed
      • cancelFeed
      • getFeed
      • createFeedDocument
      • getFeedDocument
    • 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
    • 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
    • Listings Items 2020-09-01
      • deleteListingsItem
      • patchListingsItem
      • putListingsItem
    • Listings Items 2021-08-01
      • searchListingsItems
        GET
      • deleteListingsItem
        DELETE
      • getListingsItem
        GET
      • patchListingsItem
        PATCH
      • putListingsItem
        PUT
    • Listings Restrictions
      • getListingsRestrictions
    • Merchant Fulfillment
      • getEligibleShipmentServices
      • getShipment
      • cancelShipment
      • createShipment
      • getAdditionalSellerInputs
    • Messaging
      • getMessagingActionsForOrder
      • confirmCustomizationDetails
      • createConfirmDeliveryDetails
      • createLegalDisclosure
      • createNegativeFeedbackRemoval
      • createConfirmOrderDetails
      • createConfirmServiceDetails
      • CreateAmazonMotors
      • CreateWarranty
      • GetAttributes
      • createDigitalAccessKey
      • createUnexpectedProblem
      • sendInvoice
    • Notifications
      • getSubscription
      • createSubscription
      • getSubscriptionById
      • deleteSubscriptionById
      • getDestinations
      • createDestination
      • getDestination
      • deleteDestination
    • Orders
      • getOrders
      • getOrder
      • getOrderBuyerInfo
      • getOrderAddress
      • getOrderItems
      • getOrderItemsBuyerInfo
      • updateShipmentStatus
      • getOrderRegulatedInfo
      • updateVerificationStatus
      • confirmShipment
    • Product Fees
      • getMyFeesEstimateForSKU
      • getMyFeesEstimateForASIN
      • getMyFeesEstimates
    • Pricing V0
      • getPricing
      • getCompetitivePricing
      • getListingOffers
      • getItemOffers
      • getItemOffersBatch
      • getListingOffersBatch
    • Pricing 2022-05-01
      • getFeaturedOfferExpectedPriceBatch
      • getCompetitiveSummary
    • Replenishment
      • getSellingPartnerMetrics
      • listOfferMetrics
      • listOffers
    • Reports 2020-09-04
      • getReports
      • createReport
      • getReport
      • cancelReport
      • getReportSchedules
      • createReportSchedule
      • getReportSchedule
      • cancelReportSchedule
      • getReportDocument
    • Reports 2021-06-30
      • getReports
      • createReport
      • cancelReport
      • getReport
      • getReportSchedules
      • createReportSchedule
      • cancelReportSchedule
      • getReportSchedule
      • getReportDocument
    • Sales
      • getOrderMetrics
    • Sellers
      • getAccount
      • getMarketplaceParticipations
    • 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
    • Invoices.
      • getInvoicesAttributes
      • getInvoicesDocument
      • createInvoicesExport
      • getInvoicesExports
      • getInvoicesExport
      • getInvoices
      • getInvoice
    • Tokens
      • createRestrictedDataToken
    • Automotive.
      • getVehicles
    • Uploads
      • createUploadDestinationForResource
    • third party 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
    • Transfers. transfers_2024-06-01
      • initiatePayout
      • getPaymentMethods
  1. Listings Items 2021-08-01

getListingsItem

北美(North America)
https://sellingpartnerapi-na.amazon.com
北美(North America)
https://sellingpartnerapi-na.amazon.com
GET
https://sellingpartnerapi-na.amazon.com
/listings/2021-08-01/items/{sellerId}/{sku}
Listings Items 2021-08-01
返回有关销售伙伴列表项目的详细信息。
注意: 与此操作相关的参数可能包含必须编码的特殊字符,以成功调用API。为避免在编码URL时出现SKU错误,请参阅URL编码。
使用计划:
速率(每秒请求)暴发
510
x-amzn-RateLimit-Limit响应头返回请求操作应用的使用计划速率限制(如可用)。上表指示此操作的默认速率和暴发值。业务需求更高的销售伙伴可能会看到比这里所示更高的速率和暴发值。有关更多信息,请参阅销售伙伴API中的使用计划和速率限制。

请求参数

Path 参数
sellerId
string 
必需
卖家合作伙伴标识符,例如商户账户或供应商代码。
sku
string 
必需
一个销售伙伴提供的亚马逊列表标识符。
Query 参数
marketplaceIds
array[string]
必需
请求的以逗号分隔的亚马逊市场标识符列表。
示例值:
ATVPDKIKX0DER
issueLocale
string 
可选
用于问题本地化的区域设置。当未提供时,使用第一个市场的默认语言代码。示例:en_US、fr_CA、fr_FR。当指定区域设置中没有可用的本地化时,本地化消息默认为 en_US。
示例值:
en_US
includedData
array[string]
可选
响应中包含的数据集的逗号分隔列表。默认:summaries。
枚举值:
summariesattributesissuesoffersfulfillmentAvailabilityprocurement
默认值:
summaries
示例值:
summaries

示例代码

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/listings/2021-08-01/items//?marketplaceIds=ATVPDKIKX0DER'

返回响应

🟢200成功
application/json
成功。
Headers
x-amzn-RateLimit-Limit
string 
可选
您对此操作的速率限制(每秒请求数量)。
x-amzn-RequestId
string 
可选
唯一请求参考标识符。
Body
一个列表项。
sku
string 
必需
一个销售伙伴提供的亚马逊列表标识符。
summaries
array[object (ItemSummaryByMarketplace) {10}] 
可选
上市项目的摘要详情。
marketplaceId
string 
必需
一个市场标识符。识别列表项的亚马逊市场。
asin
string 
必需
商品列表的亚马逊标准识别号码(ASIN)。
productType
string 
必需
该商品的亚马逊产品类型。
conditionType
enum<string> 
可选
识别列表项目的状态。
枚举值:
new_newnew_open_boxnew_oemrefurbished_refurbishedused_like_newused_very_goodused_goodused_acceptablecollectible_like_newcollectible_very_goodcollectible_goodcollectible_acceptableclub_club
status
array[string]
必需
适用于列表项目的状态。
枚举值:
BUYABLEDISCOVERABLE
fnSku
string 
可选
履行网络库存单位是亚马逊履行中心用于识别每个独特商品的标识符。
itemName
string 
必需
与亚马逊目录项目关联的名称或标题。
createdDate
string <date-time>
必需
以ISO 8601格式创建的上市项目的日期。
lastUpdatedDate
string <date-time>
必需
上市项目最后更新时间,采用ISO 8601格式。
mainImage
object (ItemImage) 
商品列表的图片。
可选
attributes
object (ItemAttributes) 
可选
一个包含以属性名称为键的结构化列表项属性数据的JSON对象。
额外字段
integer  | number  | string  | boolean 
可选
issues
array[object (Issue) {6}] 
可选
与列表项相关的问题。
code
string 
必需
一个识别问题类型的问题代码。
message
string 
描述问题的消息。
必需
severity
enum<string> 
问题的严重性。
必需
枚举值:
ERRORWARNINGINFO
attributeNames
array[string]
可选
与该问题相关的属性名称(如果适用)。
categories
array[string]
必需
问题类别列表。
可能的值:
INVALID_ATTRIBUTE - 表示列表中的无效属性。
MISSING_ATTRIBUTE - 突出显示列表中缺失的属性。
INVALID_IMAGE - 表示列表中无效的图片。
MISSING_IMAGE - 注明列表中缺少图片。
INVALID_PRICE - 涉及列表价格相关属性的问题。
MISSING_PRICE - 指出列表中缺少价格属性。
DUPLICATE - 识别可能存在重复问题的列表,例如此ASIN可能是另一个ASIN的重复。
QUALIFICATION_REQUIRED - 表示该列表需要资格相关的批准。
示例值:
["INVALID_ATTRIBUTE"]
enforcements
object (IssueEnforcements) 
可选
此字段提供有关亚马逊采取的影响列表发布或状态的执法行动的信息。它还包括有关任何相关豁免的详细信息。
offers
array[object (ItemOfferByMarketplace) {4}] 
可选
产品列表的优惠详情。
marketplaceId
string 
亚马逊市场标识符。
必需
offerType
enum<string> 
列表项的报价类型。
必需
枚举值:
B2CB2B
price
object (Money) 
货币类型和金额。
必需
points
object (Points) 
可选
购买商品时提供的亚马逊积分数量及其货币价值。请注意,Points 元素仅在日本(JP)返回。
fulfillmentAvailability
array[object (FulfillmentAvailability) {2}] 
可选
商品列表项的履约可用性。
fulfillmentChannelCode
string 
必需
将要使用的履行网络的代码。
quantity
integer 
可选
您提供出售的商品数量。
>= 0
procurement
array[object (ItemProcurement) {1}] 
可选
列表项的供应商采购信息。
costPrice
object (Money) 
货币类型和金额。
必需
示例
{
    "sku": "GM-ZDPI-9B4E",
    "summaries": [
        {
            "marketplaceId": "ATVPDKIKX0DER",
            "asin": "B071VG5N9D",
            "productType": "LUGGAGE",
            "conditionType": "new_new",
            "status": [
                "BUYABLE"
            ],
            "itemName": "Hardside Carry-On Spinner Suitcase Luggage",
            "createdDate": "2021-02-01T00:00:00Z",
            "lastUpdatedDate": "2021-03-01T00:00:00Z",
            "mainImage": {
                "link": "https://www.example.com/luggage.png",
                "height": 500,
                "width": 500
            }
        }
    ],
    "offers": [
        {
            "marketplaceId": "ATVPDKIKX0DER",
            "offerType": "B2C",
            "price": {
                "currencyCode": "USD",
                "amount": "100.00"
            }
        }
    ],
    "fulfillmentAvailability": [
        {
            "fulfillmentChannelCode": "DEFAULT",
            "quantity": 100
        }
    ],
    "issues": [
        {
            "code": "90220",
            "message": "'size' is required but not supplied.",
            "severity": "ERROR",
            "attributeNames": [
                "size"
            ],
            "categories": [
                "MISSING_ATTRIBUTE"
            ]
        },
        {
            "code": "18027",
            "message": "We believe the main image has text, logo, graphic or watermark which is not permitted for this product type. Please submit a compliant image to lift the suppression. Also refer to Product image requirements.",
            "severity": "ERROR",
            "categories": [
                "INVALID_IMAGE"
            ],
            "enforcements": {
                "actions": [
                    {
                        "action": "SEARCH_SUPPRESSED"
                    }
                ],
                "exemption": {
                    "status": "EXEMPT_UNTIL_EXPIRY_DATE",
                    "expiryDate": "2025-05-28T00:36:48.914Z"
                }
            }
        },
        {
            "code": "99300",
            "message": "Product Detail Page Rules Violation (Inaccurate information on product detail page)",
            "severity": "ERROR",
            "categories": [],
            "enforcements": {
                "actions": [
                    {
                        "action": "ATTRIBUTE_SUPPRESSED"
                    }
                ],
                "exemption": {
                    "status": "EXEMPT"
                }
            }
        },
        {
            "code": "18155",
            "message": "The 'minimum price' is greater than the selling price (excluding shipping) for the listing. Please review and update your price and/or minimum price.",
            "severity": "ERROR",
            "categories": [
                "INVALID_PRICE"
            ],
            "enforcements": {
                "actions": [
                    {
                        "action": "LISTING_SUPPRESSED"
                    }
                ],
                "exemption": {
                    "status": "NOT_EXEMPT"
                }
            }
        },
        {
            "code": "18742",
            "message": "Restricted Products Policy Violation",
            "severity": "ERROR",
            "categories": [],
            "enforcements": {
                "actions": [
                    {
                        "action": "CATALOG_ITEM_REMOVED"
                    }
                ],
                "exemption": {
                    "status": "NOT_EXEMPT"
                }
            }
        }
    ]
}
🟠400请求有误
🟠403禁止访问
🟠404记录不存在
🟠413413
🟠415415
🟠429429
🔴500服务器错误
🔴503服务器故障

技术咨询扫码联系作者

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

扫码加入交流群
修改于 2025-06-15 14:54:41
上一页
deleteListingsItem
下一页
patchListingsItem
Built with