eBay Last Sold (UK)

The **eBay UK last Sold Listings API** provides programmatic access to recently sold and completed listings from **eBay.co.uk**. It allows developers to search by keyword and retrieve structured data from real marketplace transactions, including final sale prices in **GBP**, sold dates, and eBay item numbers. This API is designed for use cases where **accurate market pricing** and **recent sales history** are required.

原始信息汇总

eBay Last Sold (UK) 数据集概述

数据集名称

eBay Last Sold (UK)

数据集提供方

Script and Reign

数据集类别

Commerce

数据集描述

该API提供对eBay.co.uk上最近售出和已完成的商品列表的程序化访问。它允许开发者通过关键词搜索并检索来自真实市场交易的结构化数据，包括以GBP计价的最终销售价格、售出日期和eBay商品编号。该API专为需要准确市场价格和近期销售历史的用例而设计。

主要用途

主要用例

• 市场价格比较
• 收藏品和交易卡估值（如宝可梦、Lorcana、海贼王等）
• 近期销售追踪
• 平均价格和公允价值估算
• 库存定价和转售研究

典型用户

• 转售商和套利工具
• 收藏家和价格追踪者
• 分析仪表板
• 市场研究脚本
• 定价机器人和估值服务

数据范围与定义

所有结果均源自eBay UK搜索结果，并筛选为：

• 已完成的商品列表
• 已售出的商品列表
• 英国市场（eBay.co.uk）
• 仅限GBP价格

订阅计划

• BASIC: $0.00 / 月
• PRO: $10.00 / 月
• ULTRA: $50.00 / 月
• MEGA: $250.00 / 月

可用端点

GET /health

• 描述: 检查API服务是否正在运行且可访问。
• 用例: 监控、可用性检查、健康验证。
• 示例响应: json { "status": "ok" }

GET /solds

• 描述: 通过关键词搜索最近售出和已完成的eBay UK商品列表，并返回最多10个匹配结果。
• 最佳用途: 价格比较、市场可比数据、商品列表级别分析。
• 查询参数:

  参数	必需	描述
  q	是	搜索关键词
  pages	否	要扫描的页数（默认值: 1）

• 示例请求: GET /solds?q=lorcana mickey brave little tailor
• 示例响应: json { "query": "lorcana mickey brave little tailor", "count": 2, "results": [ { "title": "Disney Lorcana Mickey Brave Little Tailor Foil 123/204", "link": "https://www.ebay.co.uk/itm/123456789012?nordt=true", "price_raw": "£12.50", "price_gbp": 12.5, "sold_date_raw": "Sold 02 Jan 2026", "sold_date_iso": "2026-01-02", "ebay_item_number": "123456789012" } ] }

GET /latest

• 描述: 返回给定搜索查询的最新售出商品列表。
• 最佳用途: 快速现货价格检查、“最后售出”小部件、即时估值查询。
• 查询参数:

  参数	必需	描述
  q	是	搜索关键词

• 示例请求: GET /latest?q=charizard base set 4/102
• 示例响应: json { "query": "charizard base set 4/102", "result": { "title": "Pokemon Charizard 4/102 Base Set Holo", "link": "https://www.ebay.co.uk/itm/123456789012?nordt=true", "price_raw": "£199.99", "price_gbp": 199.99, "sold_date_raw": "Sold 03 Jan 2026", "sold_date_iso": "2026-01-03", "ebay_item_number": "123456789012" } }

GET /average

• 描述: 根据与查询匹配的近期eBay UK销售数据计算平均售出价格（GBP）。
• 最佳用途: 公允价值估算、定价算法、分析和摘要。
• 查询参数:

  参数	必需	描述
  q	是	搜索关键词
  cap	否	用于计算平均值的結果数量（默认值: 10）

• 示例请求: GET /average?q=lorcana mickey brave little tailor&cap=10
• 示例响应: json { "query": "lorcana mickey brave little tailor", "cap": 10, "count_returned": 2, "count_priced": 2, "average_gbp": 11.25, "prices_gbp": [12.5, 9.99] }

通用数据字段

大多数端点返回包含以下字段的商品列表对象：

字段	类型	描述
title	string	商品列表标题
link	string	规范化的eBay商品URL
price_raw	string	来自eBay的原始价格文本
price_gbp	number	解析后的GBP数值价格
sold_date_raw	string	原始售出日期文本
sold_date_iso	string	规范化的售出日期（YYYY-MM-DD）
ebay_item_number	string	eBay商品ID

技术细节

基础URL

RapidAPI自动处理基础URL。所有请求均相对于RapidAPI提供的API主机发起。

GET /solds GET /latest GET /average

认证与访问

• 最终用户使用RapidAPI密钥进行身份验证。
• 后端访问通过RapidAPI的网关进行保护。
• 直接访问后端服务被阻止。
• 除了RapidAPI默认设置外，无需额外的身份验证头。

响应格式

• 所有端点均返回JSON响应。
• 共同特征：
  • 价格以GBP返回。
  • 日期尽可能规范化为ISO格式（YYYY-MM-DD）。
  • 出于性能和可靠性考虑，结果数量有限制。

数据源与可靠性说明

• 数据是从公开的eBay.co.uk搜索结果中抓取的。
• 结果反映的是最佳可见售出商品列表，并非保证的交易记录。
• eBay标记更改可能偶尔会影响解析。
• 如果eBay未明确公开某些字段，则这些字段可能缺失。

法律与合规声明

• 此API使用可公开访问的市场数据。
• 用户有责任确保其使用符合eBay的服务条款和适用法律。

搜集汇总

背景与挑战

背景概述

该数据集通过eBay UK的API提供对eBay.co.uk平台最近售出和完成商品列表的访问，支持关键词搜索，并返回结构化交易数据，如最终售价（英镑）、售出日期和商品编号，适用于需要准确市场价格和近期销售历史的场景。