Browse API：获取商品详情

获取单个商品的完整详情是 Browse API 中使用频率第二高的接口，返回的信息比搜索结果丰富得多。

接口地址

GET https://api.ebay.com/buy/browse/v1/item/{itemId}

路径参数：itemId - 商品 ID，可从搜索结果中获取

可选查询参数

fieldgroups - ALL / PRODUCT / SHIPPING / Seller 等
compatibility_filter - 兼容性过滤

代码示例

import axios from 'axios';

async function getItemDetail(itemId) {
  const resp = await axios.get(
    'https://api.ebay.com/buy/browse/v1/item/' + itemId,
    {
      headers: {
        'Authorization': 'Bearer ' + accessToken,
        'X-EBAY-C-MARKETPLACE-ID': 'EBAY-US',
      },
      params: { fieldgroups: 'ALL' },
    }
  );
  const item = resp.data;
  console.log(item.title, item.price.value, item.price.currency);
}

返回数据关键字段

title - 商品标题
price - 当前价格（含 value 和 currency）
seller - 卖家信息（用户名、评分）
shipping - 运费信息
description - 商品描述
product - 产品属性（品牌、型号等）

💡 实用建议：

默认不返回完整描述，需要 fieldgroups=ALL
描述可能包含 HTML 标签，前端需处理
详情接口配额消耗更高，注意节流

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