万有引擎
搜索⌘K
中文
登录免费开始

电商数据 · 数据 API

eBay

eBay API

分别查询 eBay 在售商品、卖家商品列表、交易反馈和已售记录；结合成色与运费比较报价，接受议价的记录不代表已核实最终成交金额。 调用 POST /api/v1/social ；返回结构化 JSON，$1.39 / 千次；失败不计费。

免费开始 看文档

4

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

eBay 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordcondition, country, domain, max_price, min_price, sold_only默认 20 · 最多 50同步$1.39 / 千次item_id · title · url · price · price_text · currency · condition · shipping · seller · image_url · scraped_at · platform
storesellercountry, domain, store, url, username默认 20 · 最多 50同步$1.39 / 千次item_id · title · url · price · price_text · currency · condition · shipping · seller · image_url · scraped_at · platform
reviewsseller, item_idcountry, domain, product_id, q, seller_name, url, username默认 20 · 最多 100同步$1.39 / 千次text · rating · rating_scale · username · submitted_at · seller_reply · image_count · reviewer_feedback_score · reviewer_feedback_star · product_name · product_id · product_price · platform · image_url · images
soldkeyworddays, min_price, site, sort默认 20 · 最多 200同步$1.39 / 千次id · url · name · sold_price · shipping_price · total_price · currency · sold_at · condition · listing_type · best_offer_accepted · category · seller_username · seller_feedback_score · seller_positive_percent · image_url · platform

eBay 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 切换 action 时，也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

怎么调用 eBay 店铺 API？

store

使用 platform="ebay"、action="store" 调用“店铺”能力；返回列表，默认 20 条、单次最多 50 条，主要包含 item_id、title、url、price、price_text、currency 等 12 个字段。

eBay store 的参数分别是什么意思？

seller必填
eBay 卖家账号名，不是店铺展示名称或公司名。store 按卖家查商品列表；reviews 需配合同一卖家的 item_id 查询买家交易反馈。

eBay 官方 Browse API 的 sellers 过滤器使用卖家 eBay user ID，可限制返回指定卖家的在售商品。EveryInfra store 同时接受 seller、store、url、username 等兼容输入是自身契约；该来源不证明这些别名都能自动解析，也不证明店铺目录完整或无需生产访问资格。官方来源：eBay Browse API：按卖家 ID 筛选在售商品来源核查：

country可选
domain 的兼容输入，当前同样接收 ebay.com 等站点域名，不是 US/DE 国家码；domain 同时存在时优先 domain。
domain可选
eBay 站点域名，例如 ebay.com、ebay.de、ebay.co.uk，不带协议或路径，默认 ebay.com；search/store/reviews 使用它构造页面地址。
store可选
seller 的兼容输入，指卖家账号名，不是任意店铺标题；store action 仍须包含必填 seller。
url可选
store 可传 eBay 店铺/卖家商品列表页覆盖自动构造的地址；reviews 若传含 /fdbk/ 的反馈页则直接使用。即使传 URL，仍需提供当前接口要求的 seller / item_id。
username可选
store/reviews 中 seller 的兼容输入，表示 eBay 卖家账号名；seller 优先且仍为公开必填，不是买家或评论作者的用户名。
eBay 特有返回字段与含义（6）
item_id
商品 ID。
condition
成色（全新/翻新/二手）。eBay 上价格差异的第一决定因素。
price_text
价格的原始展示文本，可能是区间。
shipping
运费说明。
seller
卖家名。
scraped_at
数据抓取时刻。拍卖类价格变化快，用它判断新鲜度。

怎么调用 eBay 评价 API？

reviews

使用 platform="ebay"、action="reviews" 调用“评价”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 text、rating、rating_scale、username、submitted_at、seller_reply 等 15 个字段。

eBay reviews 的参数分别是什么意思？

seller必填
eBay 卖家账号名，不是店铺展示名称或公司名。store 按卖家查商品列表；reviews 需配合同一卖家的 item_id 查询买家交易反馈。

eBay 交易反馈包括正面、中立或负面评价及简短评论，成员反馈档案与普通商品五星点评不是同一概念。官方来源：eBay：交易反馈档案来源核查：

item_id必填
reviews 对应的 eBay 商品编号，通常为商品 /itm/ URL 中的数字；与 seller 配对使用。不是通用商品目录 ID，也不是一条评价的 ID。
country可选
domain 的兼容输入，当前同样接收 ebay.com 等站点域名，不是 US/DE 国家码；domain 同时存在时优先 domain。
domain可选
eBay 站点域名，例如 ebay.com、ebay.de、ebay.co.uk，不带协议或路径，默认 ebay.com；search/store/reviews 使用它构造页面地址。
product_id可选
item_id 的兼容输入，值为 eBay 商品编号；reviews 仍需包含公开契约要求的 item_id。
q可选
reviews 中 item_id 的兼容输入，表示商品编号，不是搜索词。商品搜索请用 keyword，不能将此处 q 当成关键词。
seller_name可选
reviews 中 seller 的兼容输入，表示 eBay 卖家账号名；优先级低于 seller 和 username。当前公开契约仍要求 seller，因此它不会在合法请求中覆盖 seller，也不是买家或评价作者的用户名。
url可选
store 可传 eBay 店铺/卖家商品列表页覆盖自动构造的地址；reviews 若传含 /fdbk/ 的反馈页则直接使用。即使传 URL，仍需提供当前接口要求的 seller / item_id。
username可选
store/reviews 中 seller 的兼容输入，表示 eBay 卖家账号名；seller 优先且仍为公开必填，不是买家或评论作者的用户名。
eBay 特有返回字段与含义（8）
product_id
产品目录 ID。
product_name
产品名称。
product_price
商品价格。
seller_reply
卖家对评价的回复。
reviewer_feedback_score
评价人自己的信用分。
reviewer_feedback_star
评价人的信用星级档位。
submitted_at
评价提交时间。
image_count
图片数。

怎么调用 eBay 已售商品 API？

sold

使用 platform="ebay"、action="sold" 调用“已售商品”能力；返回列表，默认 20 条、单次最多 200 条，主要包含 id、url、name、sold_price、shipping_price、total_price 等 17 个字段。

eBay sold 的参数分别是什么意思？

keyword必填
search 的在售商品搜索词；sold 的已结束/售出商品搜索词。两者的价格口径不同，不把挂牌价当作实际成交价。

eBay 官方说明卖家可通过 Product Research 检索历史成交，普通 Completed listings 与研究工具的时间覆盖并不相同。EveryInfra keyword 表示已结束或售出商品搜索词；days、min_price、site 和 sort 是本接口自身条件，该来源不证明 distance 排序、任意历史天数或最终成交金额完整性。官方来源：eBay：Completed Listings 与 Product Research 的时间范围来源核查：

days可选
sold 向前查看的历史天数，整数，默认 30；不是商品上架天数或返回条数。当前网关未声明更细的有效范围，不能保证任意天数都有完整记录。
min_price可选
商品价格下限，数值；search 指搜索列表价格，sold 指已结束/售出列表价格，币种以站点及记录为准，不是 API 计费金额。
site可选
sold 使用的 eBay 站点域名，例如 ebay.com、ebay.co.uk，默认 ebay.com。它与 search/store/reviews 使用的 domain 是不同参数，价格币种仍以返回记录为准。
sort可选
sold 的排序：newest 按最近结束优先，distance 按距离近优先；不是商品最新上架时间。未提供时使用最近结束顺序，距离排序的参照位置未由当前接口显式指定。
查看全部 2 个允许值

distancenewest

eBay 特有返回字段与含义（10）
condition
成色（全新/翻新/二手）。eBay 上价格差异的第一决定因素。
listing_type
上架方式（拍卖/一口价）。
total_price
含运费总价。跨卖家比价用它，不要只比裸价。
shipping_price
运费金额。
best_offer_accepted
是否接受议价（Best Offer）。
sold_price
成交价。
sold_at
成交时间。
seller_username
卖家用户名。
seller_feedback_score
卖家信用分（累计好评净值）。
seller_positive_percent
卖家好评率，百分数。
eBay search 调用流程一次 eBay search 调用的全过程：向 POST /api/v1/social 发送 platform="ebay"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 item_id、title、url、price、price_text 等字段；返回列表，单次最多 50 条，计费 $1.39 / 千次，失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "ebay"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表item_idtitleurlpriceprice_text
一次 eBay search 调用的全过程：向 POST /api/v1/social 发送 platform="ebay"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 item_id、title、url、price、price_text 等字段；返回列表，单次最多 50 条，计费 $1.39 / 千次，失败与空结果不计费。

eBay 原始字段名

EveryInfra 统一字段名

左边是 eBay 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名，减少重复适配； 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。

eBay 的独有字段名（当前目录）

全站 89 个平台的当前目录中，这 12 个字段名只在 eBay 出现。 这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

  • price_text
  • seller
  • scraped_at
  • submitted_at
  • reviewer_feedback_score
  • reviewer_feedback_star
  • shipping_price
  • listing_type
  • best_offer_accepted
  • seller_username
  • seller_feedback_score
  • seller_positive_percent

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版：/api/v1/social/fields

item_id
商品 ID。
title
标题。平台无标题概念时（如纯文本帖）为 null。
url
该记录在原平台上的可访问链接。
price
价格数值，不含货币符号；币种见 currency。
price_text
价格的原始展示文本，可能是区间。
currency
价格币种代码（如 CNY、USD）。price 存在但 currency 为 null 时不要假定币种。
condition
成色（全新/翻新/二手）。eBay 上价格差异的第一决定因素。
shipping
运费说明。
seller
卖家名。
image_url
图片链接。多图能力可能返回 image_urls 数组。
scraped_at
数据抓取时刻。拍卖类价格变化快，用它判断新鲜度。
platform
数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
text
正文内容，已去除 HTML 标签。长文可能被截断。
rating
评分。分制随平台而异，同一行的 rating_scale 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。
rating_scale
上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
username
用户名（@handle）。
submitted_at
评价提交时间。
seller_reply
卖家对评价的回复。
image_count
图片数。
reviewer_feedback_score
评价人自己的信用分。
reviewer_feedback_star
评价人的信用星级档位。
product_name
产品名称。
product_id
产品目录 ID。
product_price
商品价格。
id
该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
name
名称。用于账号/商品/商家类能力，指该对象本身的名字。
sold_price
成交价。
shipping_price
运费金额。
total_price
含运费总价。跨卖家比价用它，不要只比裸价。
sold_at
成交时间。
listing_type
上架方式（拍卖/一口价）。
best_offer_accepted
是否接受议价（Best Offer）。
category
分类名称，取值为原平台的分类体系，未做跨平台归一。
seller_username
卖家用户名。
seller_feedback_score
卖家信用分（累计好评净值）。
seller_positive_percent
卖家好评率，百分数。

当前目录另列出 images，这些字段尚无逐项释义；请先核对 eBay 对应接口的用例与实际响应，不按字段名猜测类型或含义。

请求填写示例

这里搜索商品；reviews 的目标是商品 ID，不是店铺名。

以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。

ebay_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"ebay","action":"search","params":{"keyword":"mechanical keyboard"}}'

记录字段预览（非真实响应）

仅展示 search 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "item_id": null,
  "title": null,
  "url": null,
  "price": null,
  "price_text": null,
  "currency": null,
  "condition": null,
  "shipping": null,
  "seller": null,
  "image_url": null,
  "scraped_at": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。

比较 eBay 挂牌商品与成色

按 keyword 发现同类商品，把商品成色与展示价格一起比较。

查看 search 的 sold_only 参数 →
  • 结合 item_id、title、price、currency、condition 和 shipping 整理候选；sold_only 使用 JSON 布尔值，不传字符串 false。
  • 默认搜索结果的挂牌价不是成交价；即使开启已售筛选，也不能据此独立证明最终支付金额。

按 eBay 卖家账号观察在售商品

用 store 读取指定卖家的商品列表，建立自己的选品记录。

查看 store 的 seller 参数 →
  • seller 填卖家账号名，不是公司名或店铺展示标题；按 item_id、url、seller 与 condition 识别返回商品。
  • 传列表页 url 也不取消 seller 必填要求；返回的是商品列表，不是卖家资质档案或全店库存证明。

按卖家与商品整理 eBay 交易反馈

将卖家账号与商品编号配对，查看买家对交易体验的反馈。

查看 reviews 的 item_id 参数 →
  • 在 reviews 接口中同时填写 seller 和 item_id；text 是反馈正文，rating 可能为 POSITIVE、NEUTRAL、NEGATIVE，seller_reply 是已有回复。
  • 这不是通用五星商品点评；submitted_at 可能是相对时间文本，不能直接当作精确时间戳，接口也不能替卖家发布回复。

用 eBay 已售记录辅助二手估值

用 sold 查看关键词对应的已结束或售出记录，与在售报价分开保存。

查看 sold 的 days 参数 →
  • days 是向前查询的天数，默认 30；结合 sold_at、sold_price、shipping_price、total_price、currency 与 best_offer_accepted 核对价格一致性。
  • 接受议价不等于返回价格已核实为最终议价金额；缺失运费不补零，指定历史窗口也不保证记录完整。

eBay API 常见问题

eBay API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="ebay"、action 和 params。以 search 为例，必填 keyword，可选 condition、country、domain、max_price。这里搜索商品；reviews 的目标是商品 ID，不是店铺名。 eBay 共 4 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

eBay API 怎么收费？

$1.39 / 千次，eBay 全部 4 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 719 次 eBay 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

eBay API 一次能返回多少条数据？

eBay 有 4 个列表接口，包括 search、store、reviews、sold。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

eBay API 返回哪些字段？

当前目录为 search 列出 item_id、title、url、price、price_text、currency 等 12 个字段名。按全站当前目录统计，12 个字段名只在 eBay 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

「比较 eBay 挂牌商品与成色」怎样接入 eBay API？

按 keyword 发现同类商品，把商品成色与展示价格一起比较。 结合 item_id、title、price、currency、condition 和 shipping 整理候选；sold_only 使用 JSON 布尔值，不传字符串 false。 默认搜索结果的挂牌价不是成交价；即使开启已售筛选，也不能据此独立证明最终支付金额。

「按 eBay 卖家账号观察在售商品」怎样接入 eBay API？

用 store 读取指定卖家的商品列表，建立自己的选品记录。 seller 填卖家账号名，不是公司名或店铺展示标题；按 item_id、url、seller 与 condition 识别返回商品。 传列表页 url 也不取消 seller 必填要求；返回的是商品列表，不是卖家资质档案或全店库存证明。

「按卖家与商品整理 eBay 交易反馈」怎样接入 eBay API？

将卖家账号与商品编号配对，查看买家对交易体验的反馈。 在 reviews 接口中同时填写 seller 和 item_id；text 是反馈正文，rating 可能为 POSITIVE、NEUTRAL、NEGATIVE，seller_reply 是已有回复。 这不是通用五星商品点评；submitted_at 可能是相对时间文本，不能直接当作精确时间戳，接口也不能替卖家发布回复。

「用 eBay 已售记录辅助二手估值」怎样接入 eBay API？

用 sold 查看关键词对应的已结束或售出记录，与在售报价分开保存。 days 是向前查询的天数，默认 30；结合 sold_at、sold_price、shipping_price、total_price、currency 与 best_offer_accepted 核对价格一致性。 接受议价不等于返回价格已核实为最终议价金额；缺失运费不补零，指定历史窗口也不保证记录完整。

可以先免费试用 eBay API 吗？

可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 eBay 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 4 个能力。无需信用卡。

更多电商数据 API

1688 API速卖通 APIAmazon APICraigslist API得物 Dewu APIEtsy API京东 JD.com APIShopee API全部 89 平台 ↗

开始调用 eBay API

加微信领 $1 免费额度，先选一个 eBay 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始