---
title: "eBay"
description: "以归一化结构提供的 eBay 搜索、类目浏览、以图搜图与商品——接受的参数、成色过滤器，以及哪些字段真正会返回。"
---

五个操作，美国站，USD。

| | 端点 | 价格 |
|---|---|---|
| [search](/docs/api-reference/ebay/search) | `GET\|POST /v1/ebay/search` | $0.001 |
| [browse](/docs/api-reference/ebay/browse) | `GET\|POST /v1/ebay/browse` | $0.001 |
| [categories](/docs/api-reference/ebay/categories) | `GET\|POST /v1/ebay/categories` | $0.001，低于第 3 层 +$0.001 |
| [image-search](/docs/api-reference/ebay/image-search) | `POST /v1/ebay/image-search` | $0.002 |
| [product](/docs/api-reference/ebay/product) | `GET\|POST /v1/ebay/product` | $0.001 |

没有 `reviews`：eBay 的评价属于**卖家**，而不属于商品。把它放在 `reviews` 下，等于在别人问"这个商品好不好"
时回答"这个商家好不好"。

eBay 接受的过滤器是这里最广的，因为它的收窄参数取的是你已经知道的值，而不是绑定在某次查询上的 id。

## 实际会返回什么

**搜索条目**

| 字段 | 填充率 |
|---|---|
| `title` `url` | 100% |
| `price` `imageUrl` `delivery` | ~95% |
| `delivery.estimate` `badges` | ~90% |
| `condition` | ~85% |

**商品**

| 字段 | 填充率 |
|---|---|
| `title` | 100% |
| `price` `seller.name` `delivery` | ~95% |
| `attributes` `delivery.estimate` `returnsPolicy` `badges` | ~90% |
| `condition` `media.images` | ~65% |
| `brand` | **~50%** |

需要提前规划的是 `brand`：eBay 的商品由卖家自行撰写，即便标题里写了品牌，也有一半从不填写品牌字段。
如果你需要品牌覆盖率，沃尔玛与 Shopify 要密实得多。

`condition` 则恰好相反——eBay 是这里唯一能可靠说明商品成色的平台，因为它的库存大多并非全新。

## 过滤器，以及 eBay 唯一不做的一件事

`facets=Type:Complete Set` 可按任意 eBay aspect 收窄结果，且不额外收费。

eBay **不会返回**的，是一份列出可用取值的 facet 筛选栏：它的响应里没有 `facets` 栏，但
`facets=Name:Value` 依然生效。

请从 eBay 自己的搜索界面，或从上一次搜索返回条目的 `attributes` 中，取得 aspect 的名称与取值。

## eBay 特有之处

**运费是数字，不是一句话。** 只要 eBay 给出金额，`delivery.cost` 就会带上这个数字，于是一件 $48、运费
$19.95 的商品可以和一件 $55 包邮的商品放在一起比较。

**拍卖与一口价商品同在此处。** `sort=ending_soonest` 按拍卖结束时间排序。拍卖价格变化很快，如果你在跟踪
一场临近结束的拍卖，请传 `fresh=1`。

**类目可能只有 id 而没有名称。** eBay 常常只用数字标出末级类目。结构允许一个类目层级只有 `id`、只有
`name`，或两者兼有——而不是编造一个不属实的名称。