eBay Average Selling Price
收藏eBay Average Selling Price API 数据集概述
基本信息
- API名称: eBay Average Selling Price
- 类别: eCommerce
- 提供商: ecommet
- 流行度: 9.9
- 服务等级: 99%
- 延迟: 5910ms
订阅计划
- BASIC: $0.00 / 月
- PRO: $12.00 / 月
- ULTRA: $60.00 / 月
- MEGA: $299.00 / 月
功能概述
此API用于通过抓取eBay.com获取近期已售出的eBay商品列表数据,并在需要时自动解决验证码。可通过关键词、排除短语、类别和属性值来细化请求。属性值是特定于类别的参数,用于搜索更精确的产品(例如:型号、状况、运营商、存储容量)。返回结果包括:搜索结果总数、所有搜索产品的平均价格、最低价格、最高价格以及每个单独产品的价格和更多信息。
端点
- 端点:
POST /findCompletedItems - 基础URL:
https://ebay-average-selling-price.p.rapidapi.com - 完整请求URL:
https://ebay-average-selling-price.p.rapidapi.com/findCompletedItems
请求规范
请求头
content-type:application/jsonx-rapidapi-host:ebay-average-selling-price.p.rapidapi.comx-rapidapi-key:_/_YOUR KEY/__
请求体参数
| 参数名 | 描述 | 示例 | 是否必需 | 备注 |
|---|---|---|---|---|
keywords |
用于细化结果的关键词,用空格分隔。 | "iPhone" |
是 | |
max_search_results |
最大搜索结果数量。仅允许值: 25, 50, 100, 200 | 200 |
是 | |
excluded_keywords |
希望从搜索中排除的短语,用空格分隔。 | "locked cracked case box read" |
否 | |
category_id |
eBay上产品类别的唯一ID。 | "9355" (Cell Phones & Smartphones) |
否(强烈推荐) | 可通过 https://www.isoldwhat.com/ 查找。 |
remove_outliers |
如果设置为true,将从结果中移除价格过高或过低的所有异常值。 | "false" |
否 | |
site_id |
eBay将使用的站点ID,不同地区使用不同站点。 | "0" (United States) |
否 | 默认值为 "0"。可通过 https://developer.ebay.com/devzone/finding/callref/Enums/GlobalIdList.html 查找。 |
aspects |
用于帮助细化搜索结果的eBay属性列表。每个属性只允许 "name" 和 "value" 参数,且两者均为必需。 |
[{"name": "Model", "value": "Apple iPhone X"}, {"name": "Storage Capacity", "value": "64 GB"}] |
否 | 这些属性与在eBay网站上寻找特定型号或颜色产品时看到的过滤器相同。 |
响应示例
json { "success": true, "average_price": 226.47, "median_price": 220.5, "min_price": 149.99, "max_price": 319, "results": 189, "response_url": "https://www.ebay.com/sch/9355/i.html?_nkw=iPhone+-locked+-cracked+-case+-box+-read+-LCD+-face&LH_Sold=1&LH_Complete=1&_ipg=240&Model=Apple%2520iPhone%2520X&LH_ItemCondition=3000&Network=Unlocked&Storage%2520Capacity=256%2520GB", "products": [ { "title": "Apple iPhone X - 256GB - (Unlocked) - Works Great - (#8076)", "sale_price": 211.99, "date_sold": "Jun 11, 2022", "link": "https://www.ebay.com/itm/185450226888?hash=item2b2db1e4c8%3Ag%3AEmwAAOSw8DJierSB&LH_ItemCondition=3000" } ] }
代码示例
cURL
bash curl --location --request POST https://ebay-sold-items-api.herokuapp.com/findCompletedItems --header Content-Type: application/json --data-raw { "keywords": "iPhone", "excluded_keywords": "locked cracked case box read LCD face", "max_search_results": "240", "category_id": "9355", "remove_outliers": true, "site_id": "0", "aspects": [ { "name": "Model", "value": "Apple iPhone X" }, { "name": "LH_ItemCondition", "value": "3000" }, { "name": "Network", "value": "Unlocked" }, { "name": "Storage Capacity", "value": "256 GB" } ] }
NodeJS (Request)
javascript var request = require(request); var options = { method: POST, url: https://ebay-sold-items-api.herokuapp.com/findCompletedItems, headers: { Content-Type: application/json }, body: JSON.stringify({ "keywords": "iPhone", "excluded_keywords": "locked cracked case box read LCD face", "max_search_results": "240", "category_id": "9355", "remove_outliers": true, "site_id": "0", "aspects": [ { "name": "Model", "value": "Apple iPhone X" }, { "name": "LH_ItemCondition", "value": "3000" }, { "name": "Network", "value": "Unlocked" }, { "name": "Storage Capacity", "value": "256 GB" } ] }) }; request(options, function (error, response) { if (error) throw new Error(error); console.log(response.body); });
Python (Requests)
python import requests import json
url = "https://ebay-sold-items-api.herokuapp.com/findCompletedItems"
payload = json.dumps({ "keywords": "iPhone", "excluded_keywords": "locked cracked case box read LCD face", "max_search_results": "240", "category_id": "9355", "remove_outliers": True, "site_id": "0", "aspects": [ { "name": "Model", "value": "Apple iPhone X" }, { "name": "LH_ItemCondition", "value": "3000" }, { "name": "Network", "value": "Unlocked" }, { "name": "Storage Capacity", "value": "256 GB" } ] }) headers = { Content-Type: application/json }
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
故障排除
- 请求时间长: 每隔几小时,eBay会要求对已售商品的数据请求进行验证码验证。服务器检测到需要验证码时会自动解决,但这可能需要几秒钟完成。验证码每几小时才需要一次,不应影响数据的成功率或结果。
- 属性: eBay上的某些属性在URL中的值与网站上显示的不同。如果属性不生效,请确保该属性可用于您选择的类别。然后访问
response_url并选择您希望显示的属性,在URL栏中查找更新了新属性的子字符串。 - 商品状况: eBay上的状况有对应的ID。并非所有状况都适用于每个类别。请访问
response_url查看可以使用的属性。
技术栈
- Express: 服务器框架
- NodeJs: 服务器环境
- Axios: 服务器请求
- Cheerio: HTML解析
- Puppeteer: 浏览器自动化
作者
- @colindaniels - 构思及全部工作




