eBay UK Buyer Protection fee API

Itemised eBay UK Buyer Protection Fee (BPF) for any price — forward, inverse & batch. Penny-accurate, verified daily.

原始信息汇总

数据集概述：eBay UK Buyer Protection fee API

该API用于计算eBay英国站点针对买家收取的买家保护费（Buyer Protection Fee，BPF），适用于大多数私人卖家的英国商品列表。它根据eBay公布的阶梯费率表，为任意商品价格提供精确到便士的买家和卖家费用明细。

核心功能

• 单笔费用计算：根据商品价格、运费、数量、卖家类型和商品类别，计算BPF并返回详细的费用分解。
• 逆向查询：根据买家看到的商品总价，逆向推导出卖家的原始价格和其中包含的BPF。
• 批量处理：一次请求最多可处理1,000个商品，适合批量调价和分析。
• 费率模型查询：获取当前生效的费率版本、阶梯费率表、排除类别以及实时的漂移监控状态。

API端点

端点	方法	描述
/v1/fee	GET	计算单个商品价格的BPF。
/v1/inverse	POST	从买家显示的总价中恢复商品价格和嵌入的BPF。
/v1/batch	POST	批量计算多个商品价格的BPF（上限1000个）。
/v1/meta	GET	返回当前BPF模型，包括版本、阶梯表和实时监控状态。

费用计算方式

费用由固定费用加阶梯百分比费用组成：

• 固定费用：0.10英镑。
• 阶梯百分比（按价格区间累进计算，类似个人所得税）：
  • £0 – £20： 7%
  • £20 – £300： 4%
  • £300 – £4,000： 2%
  • £4,000以上： 0%
• 封顶：最高费用为86.70英镑（在商品价格达到4,000英镑时达到）。
• 备注：运费不参与百分比计算的基础。

输入参数

参数	类型	默认值	说明
item_price	number	(必填)	每件商品的价格，单位为英镑。
postage	number	0	买家显示总价中包含的运费，但不计入BPF计算。
quantity	int	1	商品数量。固定费用0.10英镑只收取一次，百分比按件计算。
seller_type	string	private	卖家类型。若为 business，则BPF为0英镑。
category	string	null	排除的类别（如汽车、摩托车、分类广告、房地产），这些类别的BPF为0英镑。

认证与版本

• 认证：无需单独的API密钥，订阅计划后通过RapidAPI自动处理认证。
• 版本：每个响应都包含bpf_version字段，用于标识当前使用的BPF费率版本。
• 准确性：费率基于eBay公布的官方计算表，并持续进行实时漂移监控，一旦eBay的费率发生变化，当天即可反映到API中。