一、接口概述
eBay的Finding API提供findItemsByKeywords方法，支持通过关键词检索商品列表。该接口采用REST架构，返回标准JSON/XML格式数据，日均调用限额5000次（生产环境需申请提升配额）。
二、核心参数说明
必需参数： keywords = "智能手机" # URL编码后的搜索词 service_version = "1.0.0" security_appname = "YourAppID" # 开发者账号申请的AppID
可选参数： paginationInput.entriesPerPage = 20 # 每页结果数(1-100) itemFilter(0).name = "Condition" # 商品条件筛选 itemFilter(0).value = "New" outputSelector = "SellerInfo" # 返回额外字段
点击获取key和secret
三、Python调用示例
import requests from urllib.parse import quote
def ebay_search(keyword, app_id): endpoint = "svcs.ebay.com/services/se…" params = { "OPERATION-NAME": "findItemsByKeywords", "SERVICE-VERSION": "1.13.0", "SECURITY-APPNAME": app_id, "RESPONSE-DATA-FORMAT": "JSON", "keywords": quote(keyword), "paginationInput.entriesPerPage": 10 } response = requests.get(endpoint, params=params) return response.json()
使用示例
result = ebay_search("无线耳机", "YOUR_APP_ID") print(result["findItemsByKeywordsResponse"][0]["searchResult"][0]["item"])
四、返回数据处理
典型响应结构包含：
searchResult.item: 商品对象数组
sellingStatus.currentPrice: 当前价格
viewItemURL: 商品详情页链接
condition.conditionDisplayName: 商品状态说明
五、最佳实践建议
实现请求重试机制（HTTP 503错误时）
使用outputSelector按需获取字段减少带宽
本地缓存高频搜索词结果
遵守每分钟600次/每日5000次的调用限制
