闲鱼 Search Scraper / Xianyu (Goofish) Search Scraper

闲鱼商品搜索数据采集器 · Xianyu (Goofish) Search API
中英双语 · Bilingual (ZH + EN)

---

What does this Actor do? 这个 Actor 做什么？

English: A Xianyu (Goofish) search API alternative that returns structured product data — titles, prices, seller info, location — by calling the official mtop search endpoint.

中文： 一个闲鱼搜索 API 替代方案，通过调用闲鱼 mtop 搜索接口返回结构化商品数据——商品标题、价格、卖家、所在地等信息。

Features / 功能：

• Keyword search / 关键词搜索
• 9 sort modes / 9 种排序方式
• Price range filter / 价格区间筛选
• Auto API signing & token refresh / 自动签名和 token 刷新

Not supported / 不支持： Product detail scraping, login, checkout. / 商品详情抓取、用户登录、下单。

Run on Apify / 立即使用 →

---

Why scrape Xianyu? 为什么要采集闲鱼？

EN	中文
Second-hand market price trends	监控二手商品价格趋势
Competitor pricing monitoring	竞品定价追踪
Product sourcing & arbitrage	选品参考和套利机会
AI training data (Chinese e-commerce)	AI 训练数据（中文电商）
Academic research (C2C marketplace)	学术研究（C2C市场）

With Apify platform: scheduling, API access, proxy rotation, monitoring. / 借助 Apify 平台：定时任务、API 访问、代理轮换、用量监控。

---

What data can it extract? 能提取什么数据？

Field / 字段	Type / 类型	Description / 描述
title	string	Product title / 商品标题
price	string	Current price / 当前售价
originalPrice	string	Original price / 原价
itemId	string	Product ID / 商品 ID
sellerNick	string	Seller nickname / 卖家昵称
sellerCredit	string	Seller credit rating / 卖家信用
location	string	Item location / 商品所在地
images	array	Product image URLs / 商品图片
createTime	string	Listing time / 发布时间
itemUrl	string	Product detail link / 商品链接

---

How to use 如何使用

English:

1. Open the Input tab
2. Fill in keyword (required), e.g. "iPhone 15"
3. Choose sort_type (optional)
4. Set priceRange if needed, e.g. 100,600
5. Click Start
6. Download results from Dataset (JSON, CSV, Excel)

中文：

1. 打开 Input 输入选项页
2. 填写 keyword（必填），如「小米」
3. 选择排序方式（可选）
4. 需要时填写价格区间（可选），如 100,600
5. 点击 Start 运行
6. 在 Dataset 下载结果

---

How much does it cost? 如何收费？

Pay-Per-Event pricing / 按事件计费：

Event / 计费事件	Price / 价格
Search request / 搜索请求	$0.01 / call
Search results / 搜索结果	$1.00 / 1,000 items

Apify provides $5 free credits/month (~5,000 items free). Upgrade for higher volume.

Apify 每月提供 $5 免费额度（约 5,000 条免费）。

---

Input 输入参数

Parameter / 参数	Required / 必填	Description / 说明
keyword	是/Yes	Search keyword / 搜索关键词
pageNumber	否/No	Page number, default 1 / 页码，默认 1
sort_type	否/No	Sort order (see below) / 排序方式（见下）
priceRange	否/No	Price range, e.g. 100,600 / 价格区间

Sort types / 排序方式

Value / 值	EN	中文
"" (empty)	Default	默认综合
create	New Listed	新发布
modify	Recently Active	最近活跃
reduce	Price Drop	新降价
credit	Credit	信用排序
down_price	Price High→Low	价格从高到低
up_price	Price Low→High	价格从低到高
publishDays:1	Within 1 Day	1 天内发布
publishDays:7	Within 7 Days	7 天内发布

---

Output 输出示例

{
  "itemId": "1059910028276",
  "title": "小米14 12+256G 在保 99新",
  "price": "2999.00",
  "originalPrice": "4299.00",
  "sellerNick": "数码玩家小张",
  "sellerCredit": "信用极好",
  "location": "深圳",
  "createTime": "2026-06-10 14:30:00",
  "itemUrl": "https://www.goofish.com/item?id=1059910028276"
}

Export formats / 导出格式：JSON, CSV, Excel, HTML.

---

Tips 使用技巧

• Proxy / 代理: This Actor uses built-in residential proxy rotation. No additional configuration needed.
• Bulk scraping / 批量采集: Call multiple times with increasing pageNumber.
• Scheduled monitoring / 定时监控: Set up Apify Schedules for automated price tracking.

---

FAQ

Q: Why do I get "被挤爆了" (too crowded) error? / 为什么返回"被挤爆了"？

A: Xianyu blocks datacenter IPs. This Actor uses residential proxies to avoid this. / 闲鱼限制数据中心 IP，本 Actor 使用住宅代理规避。

Q: Do I need a Xianyu account? / 需要闲鱼账号吗？

A: No. Uses public search API only. / 不需要，仅使用公开搜索接口。

Q: What is the rate limit? / 速率限制是多少？

A: Recommended ~5 requests/min. The proxy handles rotation automatically. / 建议每分钟约 5 次请求。

Q: Is this legal? / 是否合规？

A: Only collects publicly accessible data. No login bypass or private data extraction. Users must comply with Xianyu ToS and applicable laws. Do NOT use for shop cloning (一键搬家).

仅采集公开数据，不绕过登录、不提取私密信息。用户有责任遵守闲鱼服务条款。请勿用于一键搬家等违规用途。

---

Disclaimer

Our Actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our Actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

---

Issues / 问题反馈：Apify Console API access / API 调用：API Tab