# Goofish Scraper: 闲鱼 Xianyu (Idlefish) Search & Deals (`scraperpro/goofish-xianyu-search-scraper`) Actor

The fastest and most affordable Goofish 闲鱼 (Xianyu / Idlefish) scraper. Dual modes: ultra-fast summary and 150+ field full details with zero compute fees.

- **URL**: https://apify.com/scraperpro/goofish-xianyu-search-scraper.md
- **Developed by:** [ScraperPro](https://apify.com/scraperpro) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 60.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.60 / 1,000 search item (summary)s

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 🐟 Goofish Scraper: 闲鱼 Xianyu (Idlefish) Search & Deals

Extract real-time product listings, historical pricing, uncompressed HD photo galleries, and verified seller reputation metrics from **Goofish (闲鱼 / Xianyu / Idle Fish)** — Alibaba’s premier second-hand marketplace with over **500 million active users**.

Whether you are scouting cross-border e-commerce arbitrage opportunities, monitoring secondhand electronics depreciation, sourcing rare collectibles, or vetting Chinese suppliers, this Actor delivers the **fastest and most affordable** data extraction pipeline on Apify Store, engineered for 99.9% reliability and clean spreadsheet-ready data.

***

### ⚡ Why Choose This Goofish / Xianyu Scraper?

| Advantage | This Scraper | Traditional / Alternative Scrapers |
| :--- | :--- | :--- |
| **Extraction Speed** | ⚡ **Fastest on Apify** (Scrapes hundreds of items in seconds with dual modes) | ⏳ Slow (frequent page timeouts and minutes of waiting) |
| **Affordability & Rates** | 💰 **Cheapest Rates on Store** (Up to 75% lower cost + $0.00 Free Compute) | 💸 Expensive per-item rates plus heavy hourly server charges |
| **Reliability & Uptime** | 🛡️ **Auto-Healing Sessions** (Handles thousands of items smoothly) | ⚠️ Crashes or freezes when websites challenge sessions |
| **Compute & RAM Fees** | 🆓 **$0.00 Free Compute** (You only pay for successful items) | 💸 Expensive hourly server and heavy memory fees |
| **Dual Extraction Modes** | ✅ **Summary Mode** (Fast & Cheap) + **Full Detail Mode** | ❌ Rigid single-mode extraction with high costs |
| **Seller Zhima Credit** | ✅ **Full Seller Verification** (`信用极好`, sales count, review rate) | ❌ Missing or incomplete seller background data |
| **Worldwide Accessibility** | 🌍 **No Chinese phone number or account required** | ⚠️ Frequently blocked by login popups and SMS walls |
| **Data Cleanliness** | 💎 **Ready for Business** (Clean columns for Excel & Google Sheets) | ⚠️ Cluttered with raw nested codes and internal IDs |

***

### 💰 Transparent Pay-Per-Event (PPE) Pricing

You only pay for actual results extracted into your dataset. **Server compute time and memory usage are 100% free ($0.00)**:

| Event Name | Mode | What You Receive | Ideal For |
| :--- | :--- | :--- | :--- |
| **`search-item`** | **Summary Mode** | 13 essential fields: Title, Price (¥ CNY), Product URL, Image, City, Free Shipping flag, Wants count, Seller Name & ID, and Post Timestamp. | Large-scale price tracking, competitive market discovery, new deal alerts, dropshipping margin research. |
| **`detail-item`** | **Enriched Full Detail** | 25+ comprehensive fields: Full HD photo gallery, detailed description, physical condition, key specifications, seller Zhima credit rating, positive review rate, total items sold, and 24h reply rate. | In-depth supplier vetting, physical condition inspection, catalog cloning, complete listing archiving. |

> 💡 **Tier Discounts**: Apify subscribers automatically receive platform volume discounts. Check the **Pricing** tab on this Actor page for current rates.

***

### 🎯 High-Value Business Use Cases & Arbitrage

#### 1. 🌐 Cross-Border E-Commerce Arbitrage (eBay, Mercari, Amazon, Shopee)

Source heavily discounted secondhand electronics, vintage cameras, designer goods, and gaming hardware from Chinese sellers on Goofish. Verify item condition with uncompressed HD photos and resell globally at substantial profit margins.

#### 2. 🛡️ Safe Sourcing & Supplier Background Vetting

Inspect verified **Zhima Credit ratings** (`信用极好` / `信用良好`), historical transaction volume (`totalSold`), positive review percentage (`goodReviewRate`), and response times before placing wholesale or proxy buying orders.

#### 3. 📉 Real-Time Secondary Market Intelligence & Price Alerts

Track genuine secondary-market pricing and depreciation trends across major global brands (Apple, DJI, Nintendo, Sony, Leica, NVIDIA, luxury watches, designer apparel). Use the `wants` counter to measure real consumer demand.

#### 4. 🧸 Rare Collectibles & Limited-Edition Imports

Monitor rare Japanese import consoles, vintage film cameras, anime figures, designer sneakers, and custom mechanical keyboards before they appear on international marketplaces.

***

### 📦 Dual Extraction Modes: What Data Do You Get?

Data is automatically structured into clean, human-readable fields ready for Excel, Google Sheets, or database pipelines:

| Field | Summary Mode (`search-item`) | Full Detail Mode (`detail-item`) | Description |
| :--- | :---: | :---: | :--- |
| `id` | ✅ | ✅ | Goofish unique product ID |
| `title` | ✅ | ✅ | Product listing title |
| `price` | ✅ | ✅ | Listed price in Chinese Yuan (¥ CNY) |
| `currency` | ✅ | ✅ | Currency code (`CNY`) |
| `url` | ✅ | ✅ | Direct product URL |
| `pictureUrl` | ✅ | ✅ | Primary product photo |
| `city` | ✅ | ✅ | Seller location / shipping origin city |
| `freeShipping` | ✅ | ✅ | Free shipping availability |
| `tags` | ✅ | ✅ | Listing tags (e.g. `6小时前发布`, `卖家信用极好`, `验货宝`, `freeShippingIcon`) |
| `wants` | ✅ | ✅ | Number of interested buyers (`想要`) |
| `seller.id` | ✅ | ✅ | Seller profile ID |
| `seller.name` | ✅ | ✅ | Seller display username |
| `postedAt` | ✅ | ✅ | Listing publication timestamp |
| `priceOriginal` | — | ✅ | Original retail price before discount (¥ CNY) |
| `priceDropPercent` | — | ✅ | Percentage price drop from original price (e.g. `50.4%`) |
| `description` | — | ✅ | Full product description |
| `condition` | — | ✅ | Physical condition (e.g. `全新` Brand New, `良好` Good, `轻微划痕磨损`) |
| `images` | — | ✅ | Complete array of uncompressed HD photos |
| `specs` | — | ✅ | Key product attributes (Brand, Model, Version, Storage capacity, Packaging, etc.) |
| `tradeGuarantee` | — | ✅ | Alibaba Alipay trade guarantee escrow protection flag |
| `reportUrl` | — | ✅ | Official Alibaba dispute resolution & counterfeit reporting URL |
| `seller.signature` | — | ✅ | Seller personal bio / store signature |
| `seller.lastActive` | — | ✅ | Seller last seen online status (e.g. `6小时前来过`) |
| `seller.averageReplyTime` | — | ✅ | Average response time (e.g. `2小时`) |
| `seller.registeredDays` | — | ✅ | Account age in days (e.g. `1811` days) |
| `seller.zhimaAuth` | — | ✅ | Real-name identity and Alipay authentication flag |
| `seller.zhimaCredit` | — | ✅ | Official Zhima Credit tier (`信用极好` Excellent, `信用良好` Good, `信用中等` Medium) |
| `seller.totalSold` | — | ✅ | Historical number of completed sales |
| `seller.goodReviewRate`| — | ✅ | Positive customer feedback percentage (e.g. `100%`) |
| `seller.replyRate24h` | — | ✅ | 24-hour message response rate |
| `stats.views` | — | ✅ | Number of listing page views |
| `stats.wants` | — | ✅ | Number of direct buyer inquiries |
| `stats.favorites` | — | ✅ | Number of buyer bookmarks |

***

### 🚀 Easy-to-Run Input Examples

#### Example 1: High-Speed Market Discovery (Summary Mode)

Find used iPhones under ¥4,000 from private sellers:

```json
{
  "keyword": "iPhone 15",
  "detailLevel": "summary",
  "maxItems": 100,
  "priceMax": 4000,
  "sortBy": "priceAsc",
  "quickFilters": ["filterPersonal"]
}
```

#### Example 2: Deep Product Enrichment & Seller Vetting (Full Detail)

Extract complete specifications, HD image galleries, and Zhima credit ratings for Nintendo Switch consoles:

```json
{
  "keyword": "Switch OLED",
  "detailLevel": "full",
  "maxItems": 50,
  "sortBy": "newest"
}
```

#### Example 3: Direct Item URL or ID Enrichment (Auto-Full Detail)

Enrich specific Goofish listings directly by URL or product ID (automatically defaults to `full` detail):

```json
{
  "startUrls": [
    "https://www.goofish.com/item?id=1082638287441",
    "1084132717206"
  ]
}
```

***

### ⚙️ Input Parameters Reference

| Parameter | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| `keyword` | `string` | — | Search query in English or Chinese (e.g. `iPhone 15`, `Switch OLED`, `RTX 4090`, `手办`). You can also paste a Goofish web link directly! |
| `startUrls` | `array` | `[]` | Direct Goofish item URLs or numeric product IDs to enrich. **Defaults automatically to `detailLevel: "full"` and charges `detail-item`** for comprehensive specs. |
| `searchUrls` | `array` | `[]` | Goofish search URLs (keywords and parameters extracted automatically; scrapes multiple search queries sequentially). |
| `detailLevel` | `string` | `"summary"` | `"summary"` (ultra-fast, 13 core fields) or `"full"` (complete specs, HD gallery, seller stats). |
| `maxItems` | `integer` | `100` | Maximum number of items to collect (supports long runs up to 3,000+ items). |
| `sortBy` | `string` | `"newest"` | Sort order: `newest`, `priceAsc`, `priceDesc`, `priceDrop`, `credit`, `relevance`. |
| `priceMin` | `integer` | — | Minimum price in Chinese Yuan (¥ CNY). |
| `priceMax` | `integer` | — | Maximum price in Chinese Yuan (¥ CNY). |
| `quickFilters` | `array` | `[]` | `filterPersonal` (private sellers only), `filterFreePostage` (free shipping), `filterNew` (brand new), `filterAppraise` (verified authentic). |
| `regionIds` | `array` | `[]` | Filter by Chinese province or city code (e.g. `440100` for Guangzhou, `310100` for Shanghai). |
| `proxyConfiguration` | `object` | Residential | Apify Proxy configuration (residential proxies recommended for large-scale runs). |

***

### 📤 Sample Output Data

```json
{
  "id": "1082638287441",
  "title": "switch oled 喷射战士3限定港版",
  "price": 1340,
  "currency": "CNY",
  "url": "https://www.goofish.com/item?id=1082638287441",
  "pictureUrl": "http://img.alicdn.com/bao/uploaded/i2/2212259311853/O1CN01Dd3gwqAchoG3thAe_!!4611686018427384045-0-xy_item.jpg",
  "city": "九江",
  "freeShipping": true,
  "tags": [
    "6小时前发布",
    "freeShippingIcon"
  ],
  "postedAt": "2026-09-16T14:34:20+00:00",
  "description": "switch oled 喷射战士3限定港版\n原装配件齐全，箱说全，五码合一，轻微使用痕迹，机身有轻微划痕，滑轨有轻微掉漆，按键灵敏，功能正常\n外加一张64g和一个港版电源转接头\n支持自提，外地顺丰到付不议价",
  "status": "online",
  "condition": "轻微划痕磨损",
  "specs": {
    "品牌": "Nintendo/任天堂",
    "型号": "Switch OLED",
    "成色": "轻微划痕磨损",
    "游戏机版本": "港版",
    "内存容量": "64GB",
    "包装": "有原包装盒"
  },
  "seller": {
    "id": "2212259311853",
    "name": "寄存器0x00",
    "url": "https://www.goofish.com/personal?userId=2212259311853",
    "city": "九江",
    "lastActive": "6小时前来过",
    "averageReplyTime": "2小时",
    "registeredDays": 1811,
    "zhimaAuth": true,
    "zhimaCredit": "信用中等",
    "totalSold": 9,
    "totalListed": 8,
    "goodReviewRate": "100%",
    "replyRate24h": "66%"
  },
  "tradeGuarantee": true,
  "reportUrl": "https://h5.m.goofish.com/wow/moyu/moyu-project/cro-report-center/pages/report-type?...",
  "stats": {
    "views": 41,
    "wants": 0,
    "favorites": 0
  },
  "detailLevel": "full"
}
```

***

### 🔌 Automated Integrations & Workflows

Connect your scraped Goofish dataset directly to your favorite tools:

- **📊 1-Click Spreadsheet Exports**: Download data instantly as Excel (`.xlsx`), CSV, or JSON from the Apify Console, or schedule continuous sync to **Google Sheets**.
- **🤖 AI Translation & Analysis**: Pipe data directly into OpenAI (ChatGPT) or Anthropic (Claude) to auto-translate Chinese descriptions, summarize seller notes, or detect counterfeit risks.
- **⚡ Webhooks & Alerts**: Trigger instant notifications to Slack, Discord, or Telegram via Zapier or Make.com whenever new deals or price drops match your criteria.

***

### ❓ Frequently Asked Questions (FAQ)

##### Do I need a Chinese phone number or Goofish account?

No! This scraper works completely out-of-the-box worldwide. You do not need a Chinese phone number, Alipay account, or identity verification.

##### Can I search using English keywords?

Yes. Global brand names, models, and numbers (e.g. `iPhone 15`, `Switch OLED`, `RTX 4090`, `Sony A7M4`, `Leica`) work natively. For specialized local goods (such as anime figures or vintage tea sets), searching with Chinese terms (e.g. `手办`, `胶片相机`) returns the highest volume of listings.

##### How does the scraper handle large jobs (e.g. 3,000+ items)?

The scraper is engineered for high durability on massive jobs. It features automatic session refresh, pre-emptive token renewal, and built-in auto-healing session rotation. Data is streamed continuously into the dataset as it is scraped, so even large multi-thousand item jobs run smoothly and reliably without data loss.

##### What does Zhima Credit tell me about a seller?

Zhima Credit (`芝麻信用`) is Alibaba's official credit rating system. Sellers with `信用极好` (Excellent Credit) have verified government identities, linked banking credentials, and an exemplary transaction track record. Filtering by credit score helps you avoid unverified accounts and counterfeit goods.

##### What is the benefit of `filterPersonal`?

Goofish hosts both individual sellers and commercial vendors. Enabling `filterPersonal` filters out commercial dropshippers and shows only personal individuals selling their own pre-owned items, where the best arbitrage deals are found.

##### How fast does the scraper collect data?

The scraper is optimized for maximum throughput. It collects hundreds of listings in seconds—consistently outperforming traditional scrapers by up to 10x while consuming zero server compute fees.

# Actor input Schema

## `keyword` (type: `string`):

Keyword in Chinese or English (e.g. 'iPhone 15', '手机', '显卡', 'Switch', '乐高'). Ignored if startUrls or searchUrls is provided.

## `startUrls` (type: `array`):

Direct Goofish item URLs (e.g. 'https://www.goofish.com/item?id=1084132717206') or numeric item IDs to enrich directly with 150+ fields using ultra-fast session warm-up without searching.

## `searchUrls` (type: `array`):

One or more Goofish search URLs (e.g. 'https://www.goofish.com/search?q=iPhone+15'). Search keywords and parameters are automatically extracted and scraped.

## `maxItems` (type: `integer`):

Maximum number of items to scrape (1 to 1,500).

## `detailLevel` (type: `string`):

'summary' (ultra-fast card extraction) or 'full' (enriches each item with 150+ fields including multi-image gallery, full specs, and seller intelligence).

## `sortBy` (type: `string`):

Sorting order of the listings.

## `priceMin` (type: `integer`):

Minimum price in Chinese Yuan (CNY ¥).

## `priceMax` (type: `integer`):

Maximum price in Chinese Yuan (CNY ¥).

## `quickFilters` (type: `array`):

One-click filters provided by Goofish.

## `regionIds` (type: `array`):

Chinese administrative region/city codes (e.g., '440100' for Guangzhou, '310100' for Shanghai).

## `proxyConfiguration` (type: `object`):

Apify Residential Proxy is strictly required. Goofish (Alibaba) aggressively blocks all datacenter IPs and non-sticky proxies.

## Actor input object example

```json
{
  "keyword": "iPhone 15",
  "maxItems": 30,
  "detailLevel": "full",
  "sortBy": "newest",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Extracted Goofish product listings, prices, seller profiles, Zhima credit, condition, and image galleries.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keyword": "iPhone 15",
    "maxItems": 30,
    "detailLevel": "full",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scraperpro/goofish-xianyu-search-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keyword": "iPhone 15",
    "maxItems": 30,
    "detailLevel": "full",
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("scraperpro/goofish-xianyu-search-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keyword": "iPhone 15",
  "maxItems": 30,
  "detailLevel": "full",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call scraperpro/goofish-xianyu-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scraperpro/goofish-xianyu-search-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/qV671U8clNpxf88gr/builds/3AIA8w99gYnvObGd4/openapi.json