- Auth Token
- Api Reference
- Orders
- Reports 2021-06-30
- Feeds 2020-09-04
- Sellers
- Pricing 2022-05-01
- Notifications
- A+ Content Management
- Application Management
- The AWD
- Catalog Items V0
- Catalog Items 2020-12-01
- Catalog Items 2022-04-01
- Data Kiosk
- Product Type Definitions
- Automotive.
- Easy Ship
- FBA Inbound Eligibilty
- FBA Inventory
- Finances
- Finances 2024-06-19
- Fulfillment Inbound V0
- Listings Items 2021-08-01
- Listings Restrictions
- Merchant Fulfillment
- Messaging
- Product Fees
- Pricing V0
- Replenishment
- Sales
- Services
- getServiceJobByServiceJobId
- cancelServiceJobByServiceJobId
- completeServiceJobByServiceJobId
- getServiceJobs
- addAppointmentForServiceJobByServiceJobId
- rescheduleAppointmentForServiceJobByServiceJobId
- assignAppointmentResources
- setAppointmentFulfillmentData
- getRangeSlotCapacity
- getFixedSlotCapacity
- updateSchedule
- createReservation
- updateReservation
- cancelReservation
- getAppointmmentSlotsByJobId
- getAppointmentSlots
- createServiceDocumentUploadDestination
- Shipment Invoicing
- Shipping
- Amazon Shipping API V2
- getRates
- directPurchaseShipment
- purchaseShipment
- oneClickShipment
- getTracking
- getShipmentDocuments
- cancelShipment
- getAdditionalInputs
- getCarrierAccountFormInputs
- getCarrierAccounts
- linkCarrierAccount
- unlinkCarrierAccount
- generateCollectionForm
- getCollectionFormHistory
- getUnmanifestedShipments
- getCollectionForm
- getAccessPoints
- Solicitations
- Supply Sources
- Transfers. transfers_2024-06-01
- Tokens
- Uploads
- Invoices.
- 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
- Reports 2020-09-04
- Feeds 2021-06-30
- Listings Items 2020-09-01
- Application integrations.
- Direct Fulfillment Inventory Updates
- Direct Fulfillment Orders V1
- Direct Fulfillment Orders 2021-12-28
- Direct Fulfillment Payments
- Vendor Direct Fulfillment Sandbox Test Data
- Direct Fulfillment Shipping V1
- Direct Fulfillment Shipping 2021-12-28
- Direct Fulfillment Transaction Status V1
- Direct Fulfillment Transaction Status 2021-12-28
- Retail Procurement Payments
- Retail Procurement Orders
- Retail Procurement Shipments
- Retail Procurement Transaction Status
searchListingsItems
北美(North America)
北美(North America)
GET
https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/{sellerId}
Listings Items 2021-08-01
速率(每秒请求数) | 突发 |
---|---|
5 | 5 |
x-amzn-RateLimit-Limit
响应头会返回适用于请求操作的使用计划速率限制(如果可用)。前面的表格包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴,可能会有比这里显示的更高的速率和突发值。如需更多信息,请参阅 使用计划和速率限制。请求参数
Path 参数
sellerId
string
必需
Query 参数
marketplaceIds
array[string]
必需
<= 1 items
示例值:
ATVPDKIKX0DER
issueLocale
string
可选
示例值:
en_US
includedData
array[string]
可选
summaries
。枚举值:
summariesattributesissuesoffersfulfillmentAvailabilityprocurementrelationshipsproductTypes
默认值:
summaries
示例值:
summaries
identifiers
array[string]
可选
1.
identifiersType
时,这是必需的。2.
variationParentSku
或 packageHierarchySku
,则不能使用 'identifiers'。<= 20 items
示例值:
GM-ZDPI-9B4E
identifiersType
enum<string>
可选
当提供
identifiers
时,这是必需的。枚举值:
ASINEANFNSKUGTINISBNJANMINSANSKUUPC
示例值:
SKU
variationParentSku
string
可选
identifiers
或packageHierarchySku
,则无法使用variationParentSku
。示例值:
GM-ZDPI-9B4E
packageHierarchySku
string
可选
identifiers
或 variationParentSku
,则无法使用 packageHierarchySku
。示例值:
GM-ZDPI-9B4E
createdAfter
string <date-time>
可选
示例值:
2024-03-01T01:30:00.000Z
createdBefore
string <date-time>
可选
示例值:
2024-03-31T21:45:00.000Z
lastUpdatedAfter
string <date-time>
可选
示例值:
2024-05-05T23:45:00.000Z
lastUpdatedBefore
string <date-time>
可选
示 例值:
2024-05-01T01:15:00.000Z
withIssueSeverity
array[string]
可选
枚举值:
WARNINGERROR
示例值:
WARNING
withStatus
array[string]
可选
枚举值:
BUYABLEDISCOVERABLE
示例值:
DISCOVERABLE
withoutStatus
array[string]
可选
枚举值:
BUYABLEDISCOVERABLE
示例值:
BUYABLE
sortBy
enum<string>
可选
枚举值:
skucreatedDatelastUpdatedDate
默认值:
lastUpdatedDate
示例值:
lastUpdatedDate
sortOrder
enum<string>
排序结果项的顺序。
枚举值:
ASCDESC
默认值:
DESC
示例值:
DESC
pageSize
integer
可选
<= 20
默认值:
10
示例值:
9
pageToken
string
可选
示例值:
sdlkj234lkj234lksjdflkjwdflkjsfdlkj234234234234
示例代码
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
Body
亚马逊目录中的商品及其相关元数据。
numberOfResults
integer
必需
标识符
的搜索,找到的亚马逊目录商品的总数。对于基于关键字
的搜索,估计与搜索查询相匹配的亚马逊目录商品的总数(每次请求仅返回直到页面计数限制的结果,无论找到多少)。pagination
object (Pagination)
可选
pageSize
时,会发生分页。这意味着响应被划分为单独的页面。要检索下一页或上一页,您必须在下一个请求中将 nextToken
值或 previousToken
值作为 pageToken
参数传递。当您收到最后一页时,分页对象中将没有 nextToken
键。nextToken
string
可选
previousToken
string
可选
items
array[object (Item) {5}]
必需
description
string
交易中项目的描述
relatedIdentifiers
array[object (ItemRelatedIdentifier) {2}]
可选
totalAmount
object (Currency)
可选
breakdowns
array[object (Breakdown) {3}]
可选
contexts
array[object (Context) {17}]
可选
示例
{
"numberOfResults": 3,
"pagination": {
"nextToken": "xsdflkj324lkjsdlkj3423klkjsdfkljlk2j34klj2l3k4jlksdjl234",
"previousToken": "ilkjsdflkj234lkjds234234lkjl234lksjdflkj234234lkjsfsdflkj333d"
},
"items": [
{
"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
}
}
],
"attributes": {
"total_hdmi_ports": [
{
"value": 4,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"resolution": [
{
"language_tag": "en_US",
"value": "4K",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"item_weight": [
{
"unit": "pounds",
"value": 107.6,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"product_subcategory": [
{
"value": "50400120",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"bullet_point": [
{
"language_tag": "en_US",
"value": "SMART TV WITH UNIVERSAL GUIDE: Simple On-screen Guide is an easy way to find streaming content and live TV shows",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "100% COLOR VOLUME WITH QUANTUM DOTS: Powered by Quantum dots, Samsung’s 4K QLED TV offers over a billion shades of brilliant color and 100% color volume for exceptional depth of detail that will draw you in to the picture for the best 4K TV experience",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "QUANTUM PROCESSOR 4K: Intelligently powered processor instantly upscales content to 4K for sharp detail and refined color",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "QUANTUM HDR 4X: 4K depth of detail with high dynamic range powered by HDR10+ delivers the lightest to darkest colors, scene by scene, for amazing picture realism",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "AMBIENT MODE: Customizes and complements your living space by turning a blank screen of this big screen TV into enticing visuals including décor, info, photos and artwork",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "SMART TV FEATURES: OneRemote to control all compatible devices, Bixby voice command, on-screen universal guide, SmartThings to control compatible home appliances and devices, smart speaker expandability with Alexa and Google Assistant compatibility, and more",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"item_dimensions": [
{
"width": {
"unit": "inches",
"value": 72.4
},
"length": {
"unit": "inches",
"value": 2.4
},
"height": {
"unit": "inches",
"value": 41.4
},
"marketplace_id": "ATVPDKIKX0DER"
}
],
"brand": [
{
"language_tag": "en_US",
"value": "SAMSUNG",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"generic_keyword": [
{
"language_tag": "en_US",
"value": "oled 65 inch smart tv qled 75 inch tv 85 inch 4k tv smart tv 4k tv 65 inch qled 82 inch tv 8k tv oled 65 smart tv qled 65 inch 80 inch tv 4k 4k tv shield tv 2018",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "q9fn qled 2018 oled 4k 4k oled toshiba antenna dvd player outdoor tv kitchen tv fire tv firetv hdtv hd tv android shield tv gaming deals tv ears dvr speakers digital tv antenna tv android tv frame mount",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "4k hdr tv 70 tv shield tv 90 inch tv gaming tv 75 tv 65 inch 4k tv tv 65 inch smart tv 4k 65 inch 4k tv 65 inch 4k tv 4k tv uhd tv uhd tv 4k",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "smart tv 4k tv tv tv oled tv 65 inch smart tv 4k tv 65 inch smart tv shield tv 2018 tv 4k oled tv 65 4k tv 4k smart tv 4k hdr tv shield tv gaming tv 65 inch 4k tv tv 65 inch smart tv 4k 65 inch 4k tv 65 inch 4k tv 4k tv uhd tv uhd tv 4k",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"control_method": [
{
"value": "voice",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"item_package_dimensions": [
{
"length": {
"unit": "centimeters",
"value": 26.67
},
"width": {
"unit": "centimeters",
"value": 121.92
},
"height": {
"unit": "centimeters",
"value": 203.2
},
"marketplace_id": "ATVPDKIKX0DER"
}
],
"image_aspect_ratio": [
{
"language_tag": "en_US",
"value": "16:9",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"part_number": [
{
"value": "QN82Q60RAFXZA",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"includes_remote": [
{
"value": true,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"style": [
{
"language_tag": "en_US",
"value": "TV only",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"item_type_name": [
{
"language_tag": "en_US",
"value": "TV",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"battery": [
{
"cell_composition": [
{
"value": "alkaline"
}
],
"marketplace_id": "ATVPDKIKX0DER"
}
],
"image_contrast_ratio": [
{
"language_tag": "en_US",
"value": "QLED 4K",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"manufacturer": [
{
"language_tag": "en_US",
"value": "Samsung",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"number_of_boxes": [
{
"value": 1,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"total_usb_ports": [
{
"value": 2,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"model_number": [
{
"value": "QN82Q60RAFXZA",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"supplier_declared_dg_hz_regulation": [
{
"value": "not_applicable",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"num_batteries": [
{
"quantity": 2,
"type": "aaa",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"california_proposition_65": [
{
"compliance_type": "on_product_combined_cancer_reproductive",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"compliance_type": "chemical",
"chemical_names": [
"di_2_ethylhexyl_phthalate_dehp"
],
"marketplace_id": "ATVPDKIKX0DER"
}
],
"display": [
{
"resolution_maximum": [
{
"unit": "pixels",
"language_tag": "en_US",
"value": "3840 x 2160"
}
],
"size": [
{
"unit": "inches",
"value": 82
}
],
"type": [
{
"language_tag": "en_US",
"value": "QLED"
}
],
"marketplace_id": "ATVPDKIKX0DER"
}
],
"item_name": [
{
"language_tag": "en_US",
"value": "Samsung QN82Q60RAFXZA Flat 82-Inch QLED 4K Q60 Series (2019) Ultra HD Smart TV with HDR and Alexa Compatibility",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"list_price": [
{
"currency": "USD",
"value": 3799.99,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"batteries_required": [
{
"value": false,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"includes_rechargable_battery": [
{
"value": false,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"product_site_launch_date": [
{
"value": "2019-03-11T08:00:01.000Z",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"product_category": [
{
"value": "50400100",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"batteries_included": [
{
"value": false,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"connectivity_technology": [
{
"language_tag": "en_US",
"value": "Bluetooth",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "USB",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "Wireless",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "HDMI",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"included_components": [
{
"language_tag": "en_US",
"value": "QLED Standard Smart Remote",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "Power Cable",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "Stand",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "Samsung Smart Control",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"specification_met": [
{
"language_tag": "en_US",
"value": "",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"parental_control_technology": [
{
"value": "V-Chip",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"power_consumption": [
{
"unit": "watts",
"value": 120,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"cpsia_cautionary_statement": [
{
"value": "no_warning_applicable",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"item_type_keyword": [
{
"value": "qled-televisions",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"number_of_items": [
{
"value": 1,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"warranty_description": [
{
"language_tag": "en_US",
"value": "1 year manufacturer",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"max_resolution": [
{
"unit": "pixels",
"value": 8.3,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"color": [
{
"language_tag": "en_US",
"value": "Black",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"screen_surface_description": [
{
"language_tag": "en_US",
"value": "Flat",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"item_package_weight": [
{
"unit": "kilograms",
"value": 62.142,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"speaker_type": [
{
"language_tag": "en_US",
"value": "2CH",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"supported_internet_services": [
{
"language_tag": "en_US",
"value": "Amazon Instant Video",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "YouTube",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "Netflix",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "Hulu",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "Browser",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"tuner_technology": [
{
"language_tag": "en_US",
"value": "Analog Tuner",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"controller_type": [
{
"language_tag": "en_US",
"value": "SmartThings",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "Voice Control",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"special_feature": [
{
"language_tag": "en_US",
"value": "100% Color Volume with Quantum Dot; Quantum Processor 4K; Ambient Mode; Quantum HDR 4X; Real Game Enhancer",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"wireless_communication_technology": [
{
"language_tag": "en_US",
"value": "Wi-Fi::Wi-Fi Direct::Bluetooth",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"model_year": [
{
"value": 2019,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"power_source_type": [
{
"language_tag": "en_US",
"value": "Corded Electric",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"street_date": [
{
"value": "2019-03-21T00:00:01Z",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"mounting_type": [
{
"language_tag": "en_US",
"value": "Table Mount",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "Wall Mount",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"refresh_rate": [
{
"unit": "hertz",
"language_tag": "en_US",
"value": "120",
"marketplace_id": "ATVPDKIKX0DER"
}
]
},
"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指定的资源不存在。
🟠413请求大小超过了最大接受大小。
🟠415请求负载格式不受支持。
🟠429请求的频率超过了允许的范围。
🔴500发生了意外情况,导致服务器无法完成请求。
🔴503服务器的临时超载或维护。

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


修改于 2025-04-26 10:50:19