OfferUp Scraper

Extract OfferUp marketplace listings by keyword and ZIP code. Classifieds API with prices, images, seller info, and details.

原始信息汇总

OfferUp Scraper API 数据集概述

基本信息

• 数据集名称：OfferUp Scraper
• 类别：eCommerce
• 提供者：Iñigo Garcia Olaizola
• 订阅者数量：1

API 服务指标

• 流行度：8.9
• 服务等级：74%
• 延迟：12891ms
• 测试通过率：100%

订阅计划与价格

• BASIC：$0.00 / 月
• PRO：$19.00 / 月
• ULTRA：$59.00 / 月
• MEGA：$197.00 / 月

功能概述

提取 OfferUp 市场列表，支持通过关键词和邮政编码搜索。获取标题、价格、图片、位置、卖家信息及可选完整详情。可将 JSON 数据导出，用于跟踪本地交易、监控价格趋势和构建潜在客户管道。

核心能力

• 通过关键词和邮政编码搜索 OfferUp 列表
• 按类别、价格范围和条件筛选
• 按相关性、最近发布、距离或价格排序结果
• 通过专用端点获取完整列表详情
• 使用 nextPageToken 进行分页

基础 URL

• API 基础 URL：https://offerup-scraper.p.rapidapi.com
• 主要端点：
  • GET /search
  • GET /details

认证方式

在请求头中使用 RapidAPI 订阅凭证：

• x-rapidapi-key: YOUR_KEY
• x-rapidapi-host: offerup-scraper.p.rapidapi.com

端点详情

端点：GET /search

执行单个 OfferUp 结果页面搜索。如果存在更多结果，响应中包含 nextPageToken。

查询参数

参数	类型	是否必需	默认值	描述
query	string	是	—	搜索文本，例如 iphone、sofa、ps5。
zipCode	string	是	—	用作搜索位置锚点的邮政编码。
sortBy	string	否	bestMatch	可选值：bestMatch、recent、closest、lowPrice、highPrice。
category	string	否	—	OfferUp 类别 CID（例如：1.5）。
minPrice	number	否	—	最低价格筛选（>= 0）。
maxPrice	number	否	—	最高价格筛选（>= 0）。
conditions	string	否	—	逗号分隔值：new,openBox,reconditioned,used,forParts,other。
pageToken	string	否	—	上一页响应返回的令牌。

响应模式

json { "hasNextPage": true, "nextPageToken": "NEXT_PAGE_TOKEN", "items": [ { "listingId": "ac5f8f61-a479-3a3b-bd0b-6dbcea95ea9d", "title": "Backbone PlayStation", "price": "60", "formattedPrice": "$60", "locationName": "Newark, CA", "url": "https://offerup.com/item/detail/ac5f8f61-a479-3a3b-bd0b-6dbcea95ea9d" } ] }

注意：items 包含原始的 OfferUp 列表有效载荷（字段可能变化）。

端点：GET /details

获取单个列表的完整详情。

查询参数

参数	类型	是否必需	描述
listingId	string	是	来自搜索结果的 OfferUp 列表 ID。
zipCode	string	否	可选的邮政编码，用作搜索位置锚点。

响应模式

返回原始的 OfferUp 列表详情。

示例请求

基本搜索

bash curl --request GET --url https://offerup-scraper.p.rapidapi.com/search?query=iphone&zipCode=10001 --header x-rapidapi-key: YOUR_KEY --header x-rapidapi-host: offerup-scraper.p.rapidapi.com

带筛选条件的搜索

bash curl --request GET --url https://offerup-scraper.p.rapidapi.com/search?query=playstation&zipCode=94102&category=1.5&minPrice=50&maxPrice=500&conditions=new,used&sortBy=recent --header x-rapidapi-key: YOUR_KEY --header x-rapidapi-host: offerup-scraper.p.rapidapi.com

获取列表详情

bash curl --request GET --url https://offerup-scraper.p.rapidapi.com/details?listingId=ac5f8f61-a479-3a3b-bd0b-6dbcea95ea9d --header x-rapidapi-key: YOUR_KEY --header x-rapidapi-host: offerup-scraper.p.rapidapi.com

获取下一页

bash curl --request GET --url https://offerup-scraper.p.rapidapi.com/search?query=iphone&zipCode=10001&pageToken=PASTE_NEXT_PAGE_TOKEN --header x-rapidapi-key: YOUR_KEY --header x-rapidapi-host: offerup-scraper.p.rapidapi.com

错误响应

• 400：请求参数无效或缺失
• 404：未找到列表（详情端点）
• 500：上游 OfferUp 或内部处理错误

错误格式： json { "error": "human readable message" }

重要说明

• 使用 nextPageToken 对额外结果进行分页。
• items 是原始的 OfferUp 有效载荷，可能包含动态字段。
• 使用 GET /details 和 listingId 来获取完整的列表详情。