eBay
以归一化结构提供的 eBay 搜索、类目浏览、以图搜图与商品——接受的参数、成色过滤器,以及哪些字段真正会返回。
五个操作,美国站,USD。
| 端点 | 价格 | |
|---|---|---|
| search | GET|POST /v1/ebay/search | $0.001 |
| browse | GET|POST /v1/ebay/browse | $0.001 |
| categories | GET|POST /v1/ebay/categories | $0.001,低于第 3 层 +$0.001 |
| image-search | POST /v1/ebay/image-search | $0.002 |
| 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,或两者兼有——而不是编造一个不属实的名称。