eBay 商品详情 API
通过 URL 获取一条 eBay 商品,返回完整的报价记录:价格、成色、运费、物品所在地、卖家信用评价、数量、关注人数,以及实时拍卖状态(出价次数和结束时间)。
US$1.20/千次请求,按请求付费,无需订阅。
Sony WH-1000XM5 Wireless Noise Cancelling Headphones - Black
New·214 sold
$248.00
Shipping:Free shipping
Returns:30 days returns. Buyer pays for return shipping.
electronics_outlet_99(18,452)
99.2% positive feedback
{"itemId": "195847162389","title": "Sony WH-1000XM5 Wireless Noise Cancelling Headphones - Black","url": "https://www.ebay.com/itm/195847162389","price": 248,"currency": "USD","condition": "New","listingType": "Buy It Now","availability": "InStock",... 还有 24 个字段}
价格
eBay 商品详情 API 价格
试一试
一个请求获取 eBay 商品详情
这个示例展示了 39 个字段中的 36 个。查看全部字段
{
"found": true,
"data": {
"items": [
{
"itemId": "195847162389",
"title": "Sony WH-1000XM5 Wireless Noise Cancelling Headphones - Black",
"url": "https://www.ebay.com/itm/195847162389",
"price": 248,
"currency": "USD",
"condition": "New",
"listingType": "Buy It Now",
"availability": "InStock",
"quantityAvailable": 7,
"quantitySold": 214,
"watchers": 38,
"brand": "Sony",
"model": "WH-1000XM5",
"mpn": "WH1000XM5/B",
"itemLocation": "Brooklyn, New York, United States",
"shippingCost": 0,
"freeShipping": true,
"returnsAccepted": true,
"sellerName": "electronics_outlet_99",
"sellerUrl": "https://www.ebay.com/str/electronicsoutlet99",
"sellerFeedbackPercent": 99.2,
"sellerFeedbackCount": 18452,
"image": "https://i.ebayimg.com/images/g/8x0AAOSwR4Fk3z2Q/s-l1600.jpg",
"subtitle": "Industry Leading Noise Cancellation with Auto NC Optimizer",
"productId": "3055421789",
"gtin": "027242920199",
"categories": [
"Consumer Electronics",
"Portable Audio & Headphones",
"Headphones"
],
"bestOfferEnabled": true,
"updatedUtc": 1790467200,
"images": [
{
"url": "https://i.ebayimg.com/images/g/8x0AAOSwR4Fk3z2Q/s-l1600.jpg",
"width": 1600,
"height": 1600
},
{
"url": "https://i.ebayimg.com/images/g/9baAAOSwtOhk3z2R/s-l1600.jpg",
"width": 1600,
"height": 1600
},
{
"url": "https://i.ebayimg.com/images/g/2AoAAOSwPYVk3z2S/s-l1600.jpg",
"width": 1600,
"height": 1600
}
]
}
]
}
}完整的参数与响应参考:这个接口的每个字段、类型和示例。
参考
一个请求,一种响应结构。
你发送的每个字段和收到的每个字段,都附有真实示例。
最近验证于 2026-11-14 · 可用率和延迟按 30d 统计
请求体
JSON,POST 到这个接口。
- urlstring
https://www.ebay.com/itm/195847162389
完整的 eBay 商品 URL(例如 https://www.ebay.com/itm/133576802017)。站点由主机名决定,因此 ebay.co.uk 或 ebay.de 的 URL 会返回该站点的商品和币种。ebay.search 和 ebay.sold_listings 的每一行结果都会返回物品 ID。
响应
JSON,每个字段一个示例值。
Listing detail record (one element, for the requested listing URL). Populated whenever the provider has data for the entity.
- availabilitystring
InStock
Stock state as eBay reports it (e.g. InStock, OutOfStock).
- bestOfferEnabledboolean
true
True when the seller accepts Best Offer on this listing.
- bidCountinteger
Bids placed so far, for auction listings.
- brandstring
Sony
Brand as listed, when the seller filled it in.
- categoriesstring[]
eBay category path the listing sits in.
- conditionstring
New
Item condition as listed (e.g. New, Used). Populated whenever the provider has data for the entity.
- currencystring
USD
ISO currency code of the price (e.g. USD, GBP).
- endsUtcnumber
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
- freeShippingboolean
true
True when the listing ships free.
- gtinstring
027242920199
Global Trade Item Number (UPC/EAN) as listed.
- imagestring
https://i.ebayimg.com/images/g/8x0AAOSwR4Fk3z2Q/s-l1600.jpg
Primary listing image URL. Populated whenever the provider has data for the entity.
- itemIdstring
195847162389
eBay item identifier. Populated whenever the provider has data for the entity.
- itemLocationstring
Brooklyn, New York, United States
Where the item ships from, as displayed (e.g. Brooklyn, New York, United States).
- listingTypestring
Buy It Now
Sale format (e.g. Buy It Now, Auction).
- modelstring
WH-1000XM5
Model as listed, when the seller filled it in.
- mpnstring
WH1000XM5/B
Manufacturer part number as listed. eBay sellers frequently set this to the literal "Does Not Apply"; ebay.product_full returns the full item-specifics table instead.
- pricenumber
248
Current asking price, or the current bid on a live auction, in the site currency. Populated whenever the provider has data for the entity.
- productIdstring
3055421789
eBay catalog product identifier the listing is matched to.
- quantityAvailableinteger
7
Units the seller still has available, when the listing shows a quantity.
- quantitySoldinteger
214
Units sold on this listing, when eBay shows a sold count.
- returnsAcceptedboolean
true
True when the seller accepts returns.
- sellerFeedbackCountinteger
18452
Seller's lifetime feedback count.
- sellerFeedbackPercentnumber
99.2
Seller's positive-feedback percentage.
- sellerNamestring
electronics_outlet_99
Seller's eBay username, or the store's display name when the seller runs an eBay Store. Populated whenever the provider has data for the entity.
- sellerUrlstring
https://www.ebay.com/str/electronicsoutlet99
Seller's eBay store or listings page.
- shippingCostnumber
0
Shipping cost to the default destination as a numeric amount; absent when eBay quotes no flat cost.
- subtitlestring
Industry Leading Noise Cancellation with Auto NC Optimizer
Seller subtitle shown under the listing title.
- titlestring
Sony WH-1000XM5 Wireless Noise Cancelling Headphones - Black
Listing title as it appears on eBay. Populated whenever the provider has data for the entity.
- updatedUtcnumber
1790467200
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the listing was last modified.
- urlstring
https://www.ebay.com/itm/195847162389
Canonical listing URL (tracking query params stripped). Populated whenever the provider has data for the entity.
- watchersinteger
38
Number of shoppers watching the listing, when eBay shows it.
All listing images, primary first.
- heightinteger
1600
Image height in pixels.
- urlstring
https://i.ebayimg.com/images/g/8x0AAOSwR4Fk3z2Q/s-l1600.jpg
Image URL.
- widthinteger
1600
Image width in pixels.
- foundboolean
true
True when the listing was found.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
常见问题
关于 eBay 商品详情 API
AnyAPI 的 eBay 商品详情 API 只需一次 POST 请求 /v1/run/ebay.product,就以统一格式的 JSON 返回 eBay 数据。通过 URL 获取一条 eBay 商品,返回完整的报价记录:价格、成色、运费、物品所在地、卖家信用评价、数量、关注人数,以及实时拍卖状态(出价次数和结束时间)。无论哪个数据源提供服务,AnyAPI 都返回同一套统一的 schema。费用:每千次请求 US$1.20 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 eBay 商品详情 API 调用中有 97.6% 成功,响应时间中位数为 3.2 秒,共测量 1,158 次调用。