使用eBay Python SDK Finding API获取精准数据的技术求助

我刚帮你梳理了一下你遇到的三个核心问题，每个问题都有针对性的解决思路，咱们一步步来搞定：

1. 过滤非目标机型与多机型Listing #

方法1：API层面精准过滤（优先推荐） #

eBay的Finding API支持通过**属性过滤器（aspectFilter）**直接匹配商品规格，从源头减少无效数据：

• 先锁定手机品类ID（"Cell Phones & Smartphones"的ID为9355），缩小搜索范围
• 添加aspectFilter参数，精准匹配存储容量为64 GB的商品，直接过滤掉包含256GB的多机型listing
• 优化关键词为"iPhone X 64GB"，配合searchOptions开启关键词精确匹配，进一步减少无关结果

方法2：本地二次过滤（兜底） #

如果API过滤仍有漏网之鱼，在处理每条数据时做本地校验：

• 检查标题是否同时包含"iphone x"和"64gb"（忽略大小写）
• 主动排除标题中含其他机型的条目，比如"iphone 8"、"xs max"、"xr"等

2. 完善API请求过滤规则与响应解析 #

补充实用过滤参数 #

除了你已有的Condition、currency、minPrice，还可以添加这些参数优化结果：

• ListingType: 指定为"FixedPrice"，过滤掉拍卖类商品（如果只需要一口价数据）
• LocatedIn: 指定"CA"，只显示加拿大本地商品（匹配你的siteid）
• MaxPrice: 可选设置价格上限，过滤过高的异常价格

更高效的响应解析 #

不用BeautifulSoup解析XML，直接用eBay SDK返回的字典格式，代码更简洁：

• 通过response.dict()['searchResult']['item']直接获取商品列表
• 每个字段都可以通过键值对直接访问，比如item['title']、item['sellingStatus']['currentPrice']['value']

3. 分页去重，获取全量有效数据 #

重复条目通常是因为eBay API分页时的排序波动或商品重新上架导致的，解决方法很简单：

• 维护一个集合seen_item_ids，存储已经处理过的商品唯一ID（item['itemId']是全局唯一标识）
• 分页循环时，只处理不在集合中的条目
• 注意eBay限制最多返回100页，循环时取min(total_pages, 100)作为上限

优化后的完整代码 #

from ebaysdk.finding import Connection as find_connect
from statistics import mean, median

APP_ID = 'Removed for privacy reasons'
api = find_connect(appid=APP_ID, config_file=None, siteid="EBAY-ENCA")

# 初始化去重集合和统计用的价格列表
seen_item_ids = set()
prices = []
total_valid_items = 0

# 基础请求参数
base_request = {
    'keywords': "iPhone X 64GB",
    'categoryId': "9355",  # 固定手机品类ID，缩小搜索范围
    'itemFilter': [
        {'name': 'Condition', 'value': 'Used'},
        {'name': 'currency', 'value': 'CAD'},
        {'name': 'minPrice', 'value': 100.0},
        {'name': 'ListingType', 'value': 'FixedPrice'},  # 只取一口价商品
        {'name': 'LocatedIn', 'value': 'CA'}  # 只取加拿大本地商品
    ],
    'aspectFilter': [
        {
            'aspectName': 'Storage Capacity',
            'aspectValueName': '64 GB'
        }
    ],
    'paginationInput': {
        'entriesPerPage': 100,
        'pageNumber': 1
    },
    'searchOptions': {
        'keywordsExactMatch': True  # 开启关键词精确匹配
    }
}

# 第一次请求获取总页数
response = api.execute('findItemsByKeywords', base_request)
response_dict = response.dict()
total_entries = int(response_dict['paginationOutput']['totalEntries'])
total_pages = int(response_dict['paginationOutput']['totalPages'])
max_pages = min(total_pages, 100)  # 最多处理100页

print(f"Total items found: {total_entries}")
print(f"Total pages to process: {max_pages}")

# 循环处理每一页
for page_num in range(1, max_pages + 1):
    base_request['paginationInput']['pageNumber'] = page_num
    response = api.execute('findItemsByKeywords', base_request)
    items = response_dict['searchResult']['item']
    
    print(f"\nProcessing page {page_num}, {len(items)} items returned")
    
    for item in items:
        item_id = item['itemId']
        # 去重检查
        if item_id in seen_item_ids:
            continue
        seen_item_ids.add(item_id)
        
        title = item['title'].lower()
        # 本地二次过滤，确保是目标机型
        if 'iphone x' not in title or '64gb' not in title:
            continue
        # 排除其他机型
        exclude_terms = ['iphone 8', 'xs max', 'xr', 'iphone 7', 'iphone 11']
        if any(term in title for term in exclude_terms):
            continue
        
        # 提取价格与其他信息
        price = round(float(item['sellingStatus']['currentPrice']['value']))
        url = item['viewItemURL']
        cat = item['primaryCategory']['categoryName'].lower()
        
        # 输出有效条目
        print('-'*20)
        print(f"{cat}\n{title}\n${price}\n{url}\n")
        
        prices.append(price)
        total_valid_items += 1

# 输出统计结果
print(f"\nTotal valid items processed: {total_valid_items}")
if prices:
    print(f"Average price: ${mean(prices):.2f}. Median price: ${median(prices)}")
else:
    print("No valid items found.")

关键说明 #

• 如果aspectFilter的属性值不生效，可以先调用一次API，从响应的item['aspect']字段查看该品类的实际属性名和取值
• 品类ID可以通过eBay开发者平台的品类查询工具确认，确保匹配目标品类
• 注意eBay的API调用速率限制，避免短时间内频繁请求导致限流

内容的提问来源于stack exchange，提问作者Lase