Grailed Listings API

Search live and sold Grailed listings — get prices, sizes, conditions, photos, sold comps, and seller data as structured JSON.

原始信息汇总

数据集概述：Grailed Listings API

该API提供对Grailed（设计师、 vintage 和街头服饰市场）中活跃和已售出商品列表的实时搜索与数据提取功能，返回结构化的JSON数据。

核心功能

• 商品搜索：通过关键词、品类（男装/女装）和价格区间查询活跃或已售列表。
• 已售数据：获取已售商品的价格和日期，用于构建价格历史数据集。
• 详细数据：获取单个商品的完整信息，包括描述、所有照片、尺寸和卖家资料。
• 数据分析应用：适用于转售价格追踪、已售成交价研究、转卖工具和市场分析。

主要数据字段（搜索接口）

搜索接口返回每个商品包含30+个字段，关键字段包括：

字段	类型	说明
id	number	Grailed 商品唯一标识
url	string	商品详情页链接
title	string	商品标题
designer	string	设计师/品牌名称
department	string	所属品类（男装/女装）
category	string	顶级类别（如上衣、外套）
size	string	尺码
condition	string	成色（全新、轻微使用等）
color	string	主要颜色
price	number	当前售价（美元）
priceDrops	array	价格下调历史
sold	boolean	是否已售出
soldPrice	number	最终售价（需设置 soldOnly=true）
location	string	卖家所在地区
coverPhoto	string	主图URL
seller	object	卖家信息（用户名、评分、评价数等）
createdAt	string	列表创建时间（ISO 8601）

详细接口 (/detail) 额外返回商品的完整描述、所有照片和尺寸数据。

API 端点

方法	端点	描述
GET	/search	搜索活跃或已售商品列表，返回一页标准化结果
GET	/detail	根据商品ID获取单个商品的完整原始数据
GET	/ping	检查API是否可用

搜索接口参数

参数	类型	是否必需	默认值	说明
q	string	否	""	自由文本搜索词
department	string	否	all	all / menswear / womenswear
soldOnly	boolean	否	false	true 时返回已售商品及其价格和日期
minPrice	integer	否	—	最低价格（美元）
maxPrice	integer	否	—	最高价格（美元）
page	integer	否	1	页码（从1开始）
hitsPerPage	integer	否	48	每页结果数（1-100）

认证方式

通过 RapidAPI 平台进行认证，在每个请求中需包含 API 密钥：

• X-RapidAPI-Key: YOUR_RAPIDAPI_KEY
• X-RapidAPI-Host: grailed-listings-api.p.rapidapi.com

数据实效性

每次请求实时抓取 Grailed 当前数据，反映最新市场情况。

错误处理

API 错误返回包含 HTTP 状态码和 JSON 错误信息，如 400（参数错误）和 502（抓取失败）。