eBay API

eBay 商品详情 API

通过 URL 获取一条 eBay 商品,返回完整的报价记录:价格、成色、运费、物品所在地、卖家信用评价、数量、关注人数,以及实时拍卖状态(出价次数和结束时间)。

POST/v1/run/ebay.product
可用率
100.00%
30d · 6 次调用
请求数
6
30d · 按周,近 12 周
响应时间
3.5s
中位数 · 30d

价格

一个价格,以美元计

试一试

发出你的第一个请求

打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
  "data": {
    "items": [
      {
        "availability": "example",
        "bestOfferEnabled": true,
        "bidCount": 12500,
        "brand": "Acme Inc",
        "categories": [
          "example"
        ],
        "condition": "example",
        "currency": "USD",
        "endsUtc": 12.5,
        "freeShipping": true,
        "gtin": "example",
        "image": "https://example.com/image.jpg",
        "images": [
          {
            "height": 42,
            "url": "https://example.com/page",
            "width": 1024
          }
        ],
        "itemId": "a1b2c3d4",
        "itemLocation": "example",
        "listingType": "general",
        "model": "example",
        "mpn": "example",
        "price": 19.99,
        "productId": "a1b2c3d4",
        "quantityAvailable": 42,
        "quantitySold": 42,
        "returnsAccepted": true,
        "sellerFeedbackCount": 12500,
        "sellerFeedbackPercent": 12.5,
        "sellerName": "Example title",
        "sellerUrl": "https://example.com/page",
        "shippingCost": 19.99,
        "subtitle": "Example title",
        "title": "Example title",
        "updatedUtc": 12.5,
        "url": "https://example.com/page",
        "watchers": 42
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
响应类型定义
interface EbayProductResponse {
  data: {
    items: {
      availability?: string;
      bestOfferEnabled?: boolean;
      bidCount?: number;
      brand?: string;
      categories?: string[];
      condition?: string;
      currency?: string;
      endsUtc?: number;
      freeShipping?: boolean;
      gtin?: string;
      image?: string;
      images?: {
        height?: number;
        url?: string;
        width?: number;
      }[];
      itemId: string;
      itemLocation?: string;
      listingType?: string;
      model?: string;
      mpn?: string;
      price?: number;
      productId?: string;
      quantityAvailable?: number;
      quantitySold?: number;
      returnsAccepted?: boolean;
      sellerFeedbackCount?: number;
      sellerFeedbackPercent?: number;
      sellerName?: string;
      sellerUrl?: string;
      shippingCost?: number;
      subtitle?: string;
      title: string;
      updatedUtc?: number;
      url: string;
      watchers?: number;
    }[];
  } | null;
  found: boolean;
  reason?: "not_found";
}

完整的参数与响应参考:这个接口的每个字段、类型和示例。

参考

请求、响应与价格

最近验证于 2026-09-29 · 可用率和延迟按 30d 统计
POST /v1/run/ebay.product
curl -X POST https://api.getanyapi.com/v1/run/ebay.product \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.ebay.com/itm/133576802017"}'
字段类型示例值
请求体
urlstring"https://www.ebay.com/itm/133576802017"完整的 eBay 商品 URL(例如 https://www.ebay.com/itm/133576802017)。站点由主机名决定,因此 ebay.co.uk 或 ebay.de 的 URL 会返回该站点的商品和币种。ebay.search 和 ebay.sold_listings 的每一行结果都会返回物品 ID。
响应
dataobjectListing wrapper, or null when the URL resolved to no listing.
data.itemsobject[]Listing detail record (one element, for the requested listing URL). Populated whenever the provider has data for the entity.
data.items[].availabilitystringStock state as eBay reports it (e.g. InStock, OutOfStock).
data.items[].bestOfferEnabledbooleanTrue when the seller accepts Best Offer on this listing.
data.items[].bidCountintegerBids placed so far, for auction listings.
data.items[].brandstringBrand as listed, when the seller filled it in.
data.items[].categoriesstring[]eBay category path the listing sits in.
data.items[].conditionstringItem condition as listed (e.g. New, Used). Populated whenever the provider has data for the entity.
data.items[].currencystringISO currency code of the price (e.g. USD, GBP).
data.items[].endsUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
data.items[].freeShippingbooleanTrue when the listing ships free.
data.items[].gtinstringGlobal Trade Item Number (UPC/EAN) as listed.
data.items[].imagestringPrimary listing image URL. Populated whenever the provider has data for the entity.
data.items[].imagesobject[]All listing images, primary first.
data.items[].images[].heightintegerImage height in pixels.
data.items[].images[].urlstringImage URL.
data.items[].images[].widthintegerImage width in pixels.
data.items[].itemIdstringeBay item identifier. Populated whenever the provider has data for the entity.
data.items[].itemLocationstringWhere the item ships from, as displayed (e.g. Brooklyn, New York, United States).
data.items[].listingTypestringSale format (e.g. Buy It Now, Auction).
data.items[].modelstringModel as listed, when the seller filled it in.
data.items[].mpnstringManufacturer 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.
data.items[].pricenumberCurrent asking price, or the current bid on a live auction, in the site currency. Populated whenever the provider has data for the entity.
data.items[].productIdstringeBay catalog product identifier the listing is matched to.
data.items[].quantityAvailableintegerUnits the seller still has available, when the listing shows a quantity.
data.items[].quantitySoldintegerUnits sold on this listing, when eBay shows a sold count.
data.items[].returnsAcceptedbooleanTrue when the seller accepts returns.
data.items[].sellerFeedbackCountintegerSeller's lifetime feedback count.
data.items[].sellerFeedbackPercentnumberSeller's positive-feedback percentage.
data.items[].sellerNamestringSeller'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[].sellerUrlstringSeller's eBay store or listings page.
data.items[].shippingCostnumberShipping cost to the default destination as a numeric amount; absent when eBay quotes no flat cost.
data.items[].subtitlestringSeller subtitle shown under the listing title.
data.items[].titlestringListing title as it appears on eBay. Populated whenever the provider has data for the entity.
data.items[].updatedUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the listing was last modified.
data.items[].urlstringCanonical listing URL (tracking query params stripped). Populated whenever the provider has data for the entity.
data.items[].watchersintegerNumber of shoppers watching the listing, when eBay shows it.
foundbooleanTrue 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.
价格
每次请求价格USDUS$0.0005
价格(/千次请求)USDUS$0.50

常见问题

关于 eBay 商品详情 API

AnyAPI 的 eBay 商品详情 API 只需一次 POST 请求 /v1/run/ebay.product,就以统一格式的 JSON 返回 eBay 数据。通过 URL 获取一条 eBay 商品,返回完整的报价记录:价格、成色、运费、物品所在地、卖家信用评价、数量、关注人数,以及实时拍卖状态(出价次数和结束时间)。无论哪个数据源提供服务,AnyAPI 都返回同一套统一的 schema。费用:每千次请求 US$0.50 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 eBay 商品详情 API 调用中有 100.0% 成功,响应时间中位数为 3.5 秒,共测量 6 次调用。

费用:每千次请求 US$0.50 起,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。

通过 URL 获取一条 eBay 商品,返回完整的报价记录:价格、成色、运费、物品所在地、卖家信用评价、数量、关注人数,以及实时拍卖状态(出价次数和结束时间)。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。

过去 30 天,通过 AnyAPI 发起的 eBay 商品详情 API 调用中有 100.0% 成功,响应时间中位数为 3.5 秒,共测量 6 次调用。这些是 AnyAPI 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。