Ebay API
收藏官方服务：
资源简介：
eBay Scraper API for eBay search, sold items, prices, listings, categories, and marketplace data. Get eBay organic results and product data with a simple API.
创建时间：
2026-08-13
原始信息汇总
Ebay API 数据集详情总结
数据集概述
Ebay API 是一个专为开发者设计的 eBay 数据抓取接口，旨在帮助用户获取 eBay 搜索结果、商品数据、价格信息、已售商品、列表、分类及市场信息。该 API 无需自行构建爬虫，即可通过简单的接口端点获取结构化的 eBay 数据，适用于应用程序开发、数据分析、价格追踪、产品研究及市场工具等场景。
核心功能
- 关键词搜索：支持按关键词、价格区间、商品状况（如新品、二手）、分类及市场平台进行筛选搜索。
- 商品详情：通过 eBay 商品 URL 或商品 ID 获取完整的商品列表信息。
- 卖家信息：获取卖家个人资料（包括反馈评分、好评率、关注者数量和所在地）及其在售商品列表。
- 分类建议：将文本输入映射为 eBay 分类 ID。
- 市场平台支持：列出所有支持的市场平台 ID。
端点说明
| 端点 | 功能 |
|---|---|
/search |
关键词搜索，支持价格、状况、分类和市场筛选 |
/item |
通过 URL 或 ID 获取完整商品列表信息 |
/seller |
获取卖家个人信息及在售商品列表 |
/categories/suggest |
将文本转换为 eBay 分类 ID |
/marketplaces |
列出支持的市场平台 ID |
/health |
服务状态检查 |
主要参数
搜索接口 (/search)
- 必填：
query（关键词） - 可选：
exclude（排除词）、category（默认0表示全部分类）、site（默认EBAY_US）、condition（new/used/unspecified）、min_price、max_price、page（默认1，每页60条）
商品详情 (/item)
- 提供
url或item_id（二选一）即可获取信息 - 可选
marketplace参数（默认EBAY_US）
卖家信息 (/seller)
- 必填：
username - 可选：
sort（支持best_match/price_asc/price_desc/newest）、page、marketplace
支持的市场平台
涵盖美国（EBAY_US）、英国（EBAY_GB）、德国（EBAY_DE）、澳大利亚（EBAY_AU）、加拿大（EBAY_CA）、法国（EBAY_FR）、意大利（EBAY_IT）、西班牙（EBAY_ES）等多个国家及地区，共计 20 个市场平台，包括专门针对汽车市场的 EBAY_MOTORS_US。
错误代码
| 错误代码 | HTTP 状态 | 含义 |
|---|---|---|
waf_blocked |
403 | 被 eBay 反爬挑战页拦截 |
upstream_error |
502 | eBay 返回非 200 状态码 |
not_found |
404 | 商品不存在 |
missing_params |
422 | 缺少必要的参数 |
invalid_input |
422 | 商品状况或市场无效 |
invalid_marketplace |
422 | 未知的市场平台 ID |
connection_error |
502 | 网络连接失败 |
定价方案
该 API 提供多个订阅层级，包括免费的基础版（$0.00/月）、专业版（$9.99/月）、高级版（$39.99/月）和旗舰版（$129.99/月），可根据开发需求选择合适方案。
快速上手示例
- 搜索商品：
GET /search?query=iphone+15+pro&condition=used&min_price=200&max_price=800&page=1&limit=60 - 获取商品详情：
GET /item?url=https://www.ebay.com/itm/257285303938 - 查看卖家店铺：
GET /seller?username=jackofalltrades21
