Browse API：搜索商品

Browse API 是 eBay 开放平台中调用频率最高的 API，用于商品搜索、获取商品详情、获取热门推荐等。

关键词搜索接口

GET https://api.ebay.com/buy/browse/v1/item_summary/search

关键参数：

q - 搜索关键词（必填）
limit - 每页返回数量，最大 100
offset - 分页偏移量
sort - bestmatch / price / price-desc / ending-soonest / newly-listed
category_ids - 限定类目 ID 搜索
item_filters - 筛选条件

代码示例

import axios from 'axios';

async function searchItems(keyword) {
  const response = await axios.get(
    'https://api.ebay.com/buy/browse/v1/item_summary/search',
    {
      headers: {
        'Authorization': 'Bearer ' + accessToken,
        'X-EBAY-C-MARKETPLACE-ID': 'EBAY-US',
      },
      params: { q: keyword, limit: 10, sort: 'bestmatch' },
    }
  );

  const items = response.data.itemSummaries || [];
  items.forEach(function(item) {
    console.log(item.title, '-', item.price.value, item.price.currency);
  });
}

实用技巧

搜索结果默认按 bestmatch 排序，类似 eBay 前台综合排序
使用 item_filters 可以筛选包邮、二手、全新等条件
Browse API 免费套餐每月约 100 万次请求
返回的商品 ID 可直接用于详情接口或 Order API

声明：本文为非官方中文教程。