Xianyu Goofish Scraper — China Resale Search, Item & Seller Data 🛍️

🎉 Search + Item Detail + full Seller profile in ONE actor — the deepest Xianyu (Goofish) data on Apify

Built for resellers, arbitrage traders, sourcing teams and market researchers who need clean, structured second-hand marketplace data

---

📋 Overview

Xianyu (Goofish, 闲鱼) is Alibaba's C2C second-hand marketplace — China's largest resale platform with hundreds of millions of users. This actor searches it by keyword and looks listings up by item ID, returning clean structured rows with prices, condition, location, demand signals and full seller profiles — no account, no API key, no setup.

Why thousands of professionals choose us:

• ✅ Search + Detail + Seller in one tool: Most scrapers split these across separate actors — here keyword listing search, deep item detail and full seller profiles live in a single actor with one clean dataset.
• ⚡ Sortable, paginated search: Sort cheapest-first for arbitrage or newest-first for monitoring, and paginate up to 200 listings per keyword — no manual page-flipping.
• 🎯 Seller-trust intelligence: Every Item Detail row carries seller credit tags, Sesame (Zhima) verification, account age, listing count and 24h reply ratio — screen counterparties before you buy or source.
• 💰 Transparent per-listing / per-item billing: Pay only for the listings and items you actually receive. Bulk keyword and item-ID input, JSON/CSV/Excel export.
• 💎 Structured specs & condition: Brand, model, storage, version, condition and repair status arrive as filterable columns — plus price-drop, want-count, verified-serial and free-shipping flags.
• ✨ NEW: Item Detail by ID returns the full description, demand counts (want / browse / collect) and the complete seller profile for deep due diligence.

---

✨ Features

• 🔍 Keyword Listing Search: Find second-hand listings by any keyword (English or Chinese) with relevance, recency, credit and price sorting.
• 📦 Item Detail Lookup: Pull the full listing + seller profile for one or many item IDs.
• ↕️ 7 Sort Modes: Active, recent, seller-credit, price low→high, price high→low, price-drop and newest.
• 🚀 Bulk Input: Single keyword, a keyword list, a keywords-from-file URL, or a list of item IDs in one run.
• ⭐ Seller Profiles: Credit tags, Sesame verification, account age, listing count, 24h reply ratio and city.
• 🏷️ Structured Specs: Brand, model, storage, version, condition and repair status as discrete fields.
• 💴 Clean Pricing: Listed price, original price and shipping fee in CNY, plus the displayed price text.
• 📈 Demand Signals: Want-count, browse-count and favourite-count to gauge interest and liquidity.
• 🖼️ Full Image Galleries: Cover image plus every listing photo, normalized to HTTPS.
• 📊 Export Anywhere: JSON, CSV and Excel straight from the Apify dataset.

---

🎬 Quick Start

Pick an operation, enter a keyword (or item ID), and run. Search returns relevance-ranked second-hand listings; Item Detail returns the full listing and seller profile. Results stream into a clean, structured dataset.

curl -X POST "https://api.apify.com/v2/acts/sian.agency~xianyu-goofish-product-scraper/runs?token=YOUR_TOKEN" \
-H 'Content-Type: application/json' \
-d '{"operation": "keywordSearch", "keyword": "iPhone", "sort": "price_asc", "maxResults": 30}'

---

🚀 Getting Started (3 Simple Steps)

Step 1: Choose your operation

Pick Listing Search (by keyword) or Item Detail (by item ID).

Step 2: Enter your input

Type a keyword (e.g. iPhone, Rolex, 球鞋) or paste item IDs. Add bulk keywords / IDs to process many at once.

Step 3: Run and export

Click Start and watch clean rows fill the dataset. Download as JSON, CSV or Excel.

That's it! In under a minute, you'll have:

• Relevance-ranked second-hand listings with price, condition and location
• Full item details with structured specs and demand counts
• Complete seller profiles for trust and arbitrage screening

---

📥 Input Configuration

Field	Type	Required	Description
operation	string	No	keywordSearch (default) or productDetail
keyword	string	No	Single keyword for Listing Search
keywords	array	No	Multiple keywords for bulk Listing Search
keywordsFileUrl	string	No	Public URL to a text file, one keyword per line
sort	string	No	active, recent, credit, price_asc, price_desc, price_drop, newest
itemId	string	No	Single item ID for Item Detail
itemIds	array	No	Multiple item IDs for bulk Item Detail
maxResults	integer	No	Max listings per keyword for Listing Search (8–200, default 30)

Listing Search example:

{
  "operation": "keywordSearch",
  "keyword": "Air Jordan 1",
  "sort": "price_asc",
  "maxResults": 50
}

Bulk Item Detail example:

{
  "operation": "productDetail",
  "itemIds": ["1031168370989", "1052014412765"]
}

---

📤 Output

Results are saved to the Apify dataset with 25+ fields including:

Field	Type	Description
itemTitle	string	Listing title as posted by the seller
itemId	string	Unique Xianyu (Goofish) item identifier
priceYuan	number	Listed price in CNY (yuan)
originalPriceYuan	number	Original / pre-discount price in yuan
transportFeeYuan	number	Shipping fee in yuan (0 = free shipping)
area	string	Seller location (province / city)
conditionText	string	Item condition label
wantCount	number	Users who marked the listing as wanted
browseCount	number	Listing views (Item Detail)
collectCount	number	Listing favourites (Item Detail)
tags	array	Condition, brand, spec, price-drop, verified-serial & shipping flags
specs	array	Structured attributes (brand, model, storage, version, condition, repair)
itemDescription	string	Full listing description (Item Detail)
imageUrl / imageUrls	string / array	Cover image and the full photo gallery
itemUrl	string	Public Goofish listing URL
sellerNick	string	Seller display name
sellerRegDays	number	Days since the seller registered (account age)
sellerReplyRatio24h	string	Seller's 24-hour reply ratio
sellerZhimaAuth	boolean	Seller has Sesame (Zhima) credit verification
sellerCreditTags	array	Seller credit / identity badges

Example (Listing Search row):

{
  "itemTitle": "苹果15国行256g黑色 屏幕少量轻微划痕不影响使用",
  "itemId": "1031168370989",
  "priceYuan": 1997,
  "priceText": "¥1997",
  "shippingText": "包邮",
  "area": "四川",
  "conditionText": "少量磕碰划痕",
  "wantCount": 12,
  "tags": ["少量磕碰划痕", "Apple/苹果", "256GB", "已降553元", "12人想要", "卖家信用极好", "包邮", "已验证序列号"],
  "imageUrl": "https://img.alicdn.com/bao/uploaded/...",
  "itemUrl": "https://www.goofish.com/item?id=1031168370989",
  "_operation": "keywordSearch",
  "_sourceKeyword": "iPhone",
  "status": "success"
}

---

💼 Use Cases & Examples

1. Resale Price Monitoring

Resellers tracking second-hand prices across a product roster.

Input: A bulk keyword watchlist + sort: price_drop or price_asc Output: Listed price, original price, shipping and condition per listing Use: Schedule daily runs to catch price drops and watch the floor on Xianyu / Goofish.

2. Second-Hand Arbitrage Research

Arbitrage traders comparing China-side resale prices against Western markets.

Input: Keyword search sorted cheapest-first Output: Price, condition, location, shipping and demand (want-count) per listing Use: Spot spreads between Xianyu (Goofish) and platforms like eBay, StockX or Grailed.

3. Seller-Trust Screening

Buyers and sourcing teams vetting sellers before a deal.

Input: Item IDs via Item Detail Output: Seller credit tags, Sesame verification, account age, listing count, reply ratio Use: Screen counterparties and filter out low-trust sellers automatically.

4. Brand & Condition Tracking

Category analysts tracking supply and condition for specific brands or models.

Input: A brand/model keyword list Output: Structured specs (brand, model, storage, version, condition, repair status) + verified-serial & free-shipping flags Use: Map how a model's second-hand condition mix and pricing shift over time.

5. Market & Demand Research

E-commerce researchers sizing the China second-hand market.

Input: Keyword search across categories Output: Listing volume, want / browse / favourite counts and price distribution Use: Quantify supply and demand on China's largest C2C resale marketplace.

---

🔗 Integration Examples

JavaScript/Node.js

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('sian.agency/xianyu-goofish-product-scraper').call({
  operation: 'keywordSearch',
  keyword: 'iPhone',
  sort: 'price_asc',
  maxResults: 30
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);

Python

from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')

run = client.actor('sian.agency/xianyu-goofish-product-scraper').call(
    run_input={'operation': 'productDetail', 'itemIds': ['1031168370989']}
)

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)

cURL

curl -X POST 'https://api.apify.com/v2/acts/sian.agency~xianyu-goofish-product-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"operation": "keywordSearch", "keywords": ["iPhone", "Rolex"], "maxResults": 30}'

Automation Workflows (N8N / Zapier / Make)

1. Trigger: Schedule or webhook
2. HTTP Request: Call the actor API
3. Process: Handle the JSON results
4. Action: Save to a sheet, alert on price drops, or sync to your database

---

📊 Performance & Pricing

FREE Tier (Try It Now)

• Up to 5 keywords or item IDs per run — full feature access, same data quality
• No credit card required
• Perfect for testing and small projects

PAID Tier (Production Ready)

• Unlimited keywords and item IDs per run
• Deep pagination (up to 200 listings per keyword)
• Pay-per-result: charged per listing returned (search) or per item (detail)

💰 Transparent pricing — you pay for the data you receive, nothing more.

🔗 View current pricing

---

❓ Frequently Asked Questions

Q: How many listings can I get per keyword? A: Up to 200 per keyword on the PAID tier; the actor paginates automatically. FREE runs are limited to 5 keywords/IDs.

Q: Where do I find an item ID? A: It's the numeric id in a Goofish listing URL (goofish.com/item?id=1031168370989) and is returned as itemId by Listing Search.

Q: Do searches work with Chinese keywords? A: Yes — both English and Chinese keywords are fully supported (e.g. 球鞋, 相机, 耐克).

Q: What output formats are available? A: JSON, CSV and Excel — export directly from the Apify dataset.

Q: What currency are prices in? A: Chinese yuan (CNY). Each row carries the numeric price and the displayed price text.

Q: Is this legal? A: Yes — we only extract publicly available marketplace data. See the legal section below.

---

🐛 Troubleshooting

A search returns an error row

• The marketplace can briefly fail to collect; the actor retries automatically. Re-run if a keyword still errors.

Item Detail returns an error for an ID

• Confirm the item ID is correct and the listing is still live (sold/removed listings can no longer be fetched).

Fewer results than maxResults

• Some keywords simply have fewer live listings; the actor stops when the marketplace reports no further pages.

FREE tier limited my run

• FREE runs cap at 5 keywords / item IDs. Upgrade for unlimited input and deeper pagination.

---

⚠️ Trademark Disclaimer

This is an independent tool and is not affiliated with, endorsed by, or sponsored by Alibaba Group, Xianyu (闲鱼), or Goofish. "Xianyu", "闲鱼" and "Goofish" are trademarks of their respective owners. This actor accesses only publicly available listing information and is intended for lawful research, monitoring and analysis. All product names, logos and brands are the property of their respective owners.

---

⚖️ Is it legal to scrape data?

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.

You can also read Apify's blog post on the legality of web scraping.

---

🤝 Support

Join our active support community

• For issues or questions, open an issue in the actor's Issues tab
• Check the SIÁN Agency Store for more automation tools
• 📧 apify@sian-agency.online

---

Built by SIÁN Agency | More Tools