eBay API
eBay 商品详情(完整版) API
通过 URL 获取一条 eBay 商品,包含卖家填写的完整物品属性表(MPN、型号、容量、兼容性以及该类目下的所有其他属性)、卖家的完整描述、所有商品图片和卖家的信用评价记录。
POST/v1/run/ebay.product_full
可用率
100.00%
30d · 79 次调用
请求数
79
30d · 按周,近 12 周
响应时间
28.6s
中位数 · 30d
试一试
发出你的第一个请求
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
"data": {
"items": [
{
"availability": "example",
"brand": "Acme Inc",
"category": "general",
"condition": "example",
"countryCode": "US",
"currency": "USD",
"description": "A short example description of this item.",
"gtin": "example",
"image": "https://example.com/image.jpg",
"images": [
"https://example.com/image.jpg"
],
"itemId": "a1b2c3d4",
"itemLocation": "example",
"listingType": "general",
"price": 19.99,
"quantityAvailable": 42,
"quantitySold": 42,
"returnWindow": 42,
"sellerFeedbackCount": 12500,
"sellerFeedbackPercent": 12.5,
"sellerName": "Example title",
"sellerUrl": "https://example.com/page",
"specifications": [
{
"name": "Example title",
"value": "19.99"
}
],
"title": "Example title",
"url": "https://example.com/page"
}
]
},
"found": true,
"reason": "not_found"
}响应类型定义
interface EbayProductFullResponse {
data: {
items: {
availability?: string;
brand?: string;
category?: string;
condition?: string;
countryCode?: string;
currency?: string;
description?: string;
gtin?: string;
image?: string;
images?: string[];
itemId: string;
itemLocation?: string;
listingType?: string;
price?: number;
quantityAvailable?: number;
quantitySold?: number;
returnWindow?: number;
sellerFeedbackCount?: number;
sellerFeedbackPercent?: number;
sellerName?: string;
sellerUrl?: string;
specifications?: {
name?: string;
value?: string;
}[];
title: string;
url: string;
}[];
} | null;
found: boolean;
reason?: "not_found";
}完整的参数与响应参考:这个接口的每个字段、类型和示例。
参考
请求、响应与价格
最近验证于 2026-09-29 · 可用率和延迟按 30d 统计POST /v1/run/ebay.product_full
curl -X POST https://api.getanyapi.com/v1/run/ebay.product_full \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.ebay.com/itm/133576802017"}'| 字段 | 类型 | 示例值 |
|---|---|---|
| 请求体 | ||
| url | string | "https://www.ebay.com/itm/133576802017"完整的 eBay 商品 URL(例如 https://www.ebay.com/itm/133576802017)。除在售商品外,也适用于已结束和已售出的商品,因此可以与 ebay.sold_listings 搭配使用:先低成本拉取成交参考,再对你关心的少数几条补全详情。 |
| 响应 | ||
| data | object | Listing wrapper, or null when the URL resolved to no listing. |
| data.items | object[] | Listing detail record with the full item-specifics table (one element, for the requested listing URL). Populated whenever the provider has data for the entity. |
| data.items[].availability | string | Stock state as eBay reports it (e.g. in_stock, out_of_stock). |
| data.items[].brand | string | Brand as listed, when the seller filled it in. |
| data.items[].category | string | Full category path, e.g. "Electronics>Cell Phones & Accessories>Cell Phones & Smartphones". |
| data.items[].condition | string | Item condition as listed (e.g. New, Used). Populated whenever the provider has data for the entity. |
| data.items[].countryCode | string | ISO country code of the eBay marketplace the listing is on. |
| data.items[].currency | string | ISO currency code of the price (e.g. USD, GBP). |
| data.items[].description | string | The seller's own listing description, as plain text. Populated whenever the provider has data for the entity. |
| data.items[].gtin | string | Global Trade Item Number (UPC/EAN) as listed. |
| data.items[].image | string | Primary listing image URL. Populated whenever the provider has data for the entity. |
| data.items[].images | string[] | All listing image URLs, primary first. Populated whenever the provider has data for the entity. |
| data.items[].itemId | string | eBay item identifier. Populated whenever the provider has data for the entity. |
| data.items[].itemLocation | string | Where the item ships from, as displayed (e.g. Brooklyn, New York, United States). |
| data.items[].listingType | string | Sale format (e.g. Buy It Now, Auction, Buy It Now + Best Offer). |
| data.items[].price | number | Current effective price in the site currency: the discounted price when the seller is running a sale, otherwise the asking price. Populated whenever the provider has data for the entity. |
| data.items[].quantityAvailable | integer | Units the seller still has available, when the listing shows a quantity. |
| data.items[].quantitySold | integer | Units sold on this listing, when eBay shows a sold count. |
| data.items[].returnWindow | integer | Days the buyer has to return the item, when the seller accepts returns. |
| data.items[].sellerFeedbackCount | integer | Seller's lifetime feedback count. |
| data.items[].sellerFeedbackPercent | number | Seller's positive-feedback percentage. |
| data.items[].sellerName | string | 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. |
| data.items[].sellerUrl | string | Seller's eBay store or listings page. |
| data.items[].specifications | object[] | The listing's item-specifics table, as the seller filled it in. This is where MPN, Model, Storage Capacity, Compatible Brand and every other per-category attribute lives; the set of names varies by category. eBay's boilerplate condition blurb is removed. Populated whenever the provider has data for the entity. |
| data.items[].specifications[].name | string | Attribute name as eBay labels it (e.g. MPN, Storage Capacity). |
| data.items[].specifications[].value | string | Attribute value as the seller entered it. |
| data.items[].title | string | Listing title as it appears on eBay. Populated whenever the provider has data for the entity. |
| data.items[].url | string | Canonical listing URL (tracking query params stripped). Populated whenever the provider has data for the entity. |
| found | boolean | 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. |
| 价格 | ||
| 每次请求价格 | USD | US$0.0018 |
| 价格(/千次请求) | USD | US$1.80 |
常见问题
关于 eBay 商品详情(完整版) API
AnyAPI 的 eBay 商品详情(完整版) API 只需一次 POST 请求 /v1/run/ebay.product_full,就以统一格式的 JSON 返回 eBay 数据。通过 URL 获取一条 eBay 商品,包含卖家填写的完整物品属性表(MPN、型号、容量、兼容性以及该类目下的所有其他属性)、卖家的完整描述、所有商品图片和卖家的信用评价记录。无论哪个数据源提供服务,AnyAPI 都返回同一套统一的 schema。费用:每千次请求 US$1.80 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 eBay 商品详情(完整版) API 调用中有 100.0% 成功,响应时间中位数为 28.6 秒,共测量 79 次调用。
费用:每千次请求 US$1.80 起,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。
通过 URL 获取一条 eBay 商品,包含卖家填写的完整物品属性表(MPN、型号、容量、兼容性以及该类目下的所有其他属性)、卖家的完整描述、所有商品图片和卖家的信用评价记录。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。
过去 30 天,通过 AnyAPI 发起的 eBay 商品详情(完整版) API 调用中有 100.0% 成功,响应时间中位数为 28.6 秒,共测量 79 次调用。这些是 AnyAPI 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。