# Goofish Scraper: 闲鱼 Xianyu Sellers, Inventory & Reviews (`scraperpro/goofish-xianyu-seller-scraper`) Actor

Extract Goofish 闲鱼 (Xianyu / Idlefish) seller profiles, active & sold inventory catalogs, buyer reviews, Zhima Credit ratings, unboxing photos, and shop statistics. Supports seller URLs, item URLs, and numeric IDs. Pay per result with zero compute fees.

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

## Pricing

from $2.80 / 1,000 product listing records

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 Sellers & Reviews Scraper: 闲鱼 Xianyu Shop Profiles, Inventory & Feedback (Idlefish)

<div align="center">

[![Available on Apify](https://img.shields.io/badge/Available_on-Apify-28B52A?style=for-the-badge\&logo=apify\&logoColor=white)](https://apify.com/scraperpro/goofish-xianyu-seller-scraper?fpr=939u3w\&fp_sid=gh_goofish_seller)
[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg?style=for-the-badge)](#)
[![Success Rate](https://img.shields.io/badge/Success_Rate-99%25+-brightgreen?style=for-the-badge)](#)
[![Zero Login](https://img.shields.io/badge/Account_Required-None-blue?style=for-the-badge)](#)
[![Pricing](https://img.shields.io/badge/Pricing-Pay_Per_Result-orange?style=for-the-badge)](#)
[![Free Compute](https://img.shields.io/badge/Compute_Fee-$0.00_Free-brightgreen?style=for-the-badge)](#)

**The most comprehensive, reliable, and cost-effective Goofish (闲鱼 / Xianyu / Idlefish) seller intelligence scraper on Apify. Extract complete seller profile credentials, Zhima Credit (芝麻信用) ratings, full active & sold inventory catalogs, deep specifications, and buyer reviews with real unboxing photos — 100% autonomously with Zero Login & Zero Chinese Phone Number Required.**

[**🚀 Try it Live on Apify**](https://apify.com/scraperpro/goofish-xianyu-seller-scraper?fpr=939u3w\&fp_sid=gh_goofish_seller) • [**📖 Documentation**](https://apify.com/scraperpro/goofish-xianyu-seller-scraper?fpr=939u3w\&fp_sid=gh_goofish_seller) • [**💬 Support**](https://apify.com/scraperpro/goofish-xianyu-seller-scraper/issues)

</div>

***

<p align="center">
  <a href="https://console.apify.com/actors/xma6AWAwibFiZHSqo/input">
    <img src="https://raw.githubusercontent.com/RNFS/Goofish-Sellers-Reviews-Scraper/main/assets/banner.jpg" alt="Goofish Sellers &amp; Reviews Scraper by ScraperPro" width="100%">
  </a>
</p>

<p align="center">
  <a href="https://console.apify.com/actors/xma6AWAwibFiZHSqo/input">
    <img src="https://raw.githubusercontent.com/RNFS/1688-Wholesale-Scraper-API/main/try-it-for-free.svg" width="240" height="48" alt="Try it for Free">
  </a>
  <br>
  <sub>⚡ <b>1-Click Free Trial:</b> Test live queries using Apify's $5 free monthly credit • No credit card required</sub>
</p>

***

### 📖 Overview

**Goofish (闲鱼 / Xianyu / Idle Fish)** is Alibaba's flagship C2C second-hand trading ecosystem with over **500 million registered users**. It represents the world's most dynamic marketplace for authentic pre-owned luxury, electronics, vintage fashion, anime figures, and rare collectibles.

However, gathering seller background intelligence, inventory history, and buyer feedback on Goofish is guarded by stringent anti-scraping barriers:

- Mandatory Chinese mobile (+86) SMS verification and QR code login screens.
- Dynamic Alibaba mtop encryption handshakes (`_m_h5_tk`, `tfstk`).
- Deeply nested mobile data structures that break typical spreadsheet exports.

**Goofish Sellers & Reviews Scraper by ScraperPro** solves these challenges permanently. Using an ultra-fast hybrid stealth engine with automated session reuse, this Actor extracts rich merchant profiles, active & historical listings, and buyer feedback at scale — **with zero login, zero cookies, and zero server compute fees ($0.00 compute)**.

<table>
  <tr>
    <td colspan="4" style="padding:10px 14px;background:#FF6A00;color:#FFFFFF;font-size:13px;font-weight:700;border-radius:6px 6px 0 0">
      ⚡ ScraperPro · Chinese E-Commerce &amp; B2B Sourcing Ecosystem
    </td>
  </tr>
  <tr>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FAFAFA;vertical-align:top;width:25%">
      <span style="white-space:nowrap">🌐 <b><a href="https://apify.com/scraperpro/alibaba-wholesale-scraper?fpr=939u3w&fp_sid=gh_alibaba" style="color:#0F172A;text-decoration:none;font-size:13px">Alibaba Wholesale</a></b></span><br>
      <span style="color:#2563EB;font-size:11px;font-weight:600">Global B2B Wholesale</span><br>
      <span style="color:#64748B;font-size:11px">Tiered prices, MOQ &amp; audits</span>
    </td>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FAFAFA;vertical-align:top;width:25%">
      <span style="white-space:nowrap">🇨🇳 <b><a href="https://apify.com/scraperpro/1688-wholesale-scraper?fpr=939u3w&fp_sid=gh_1688" style="color:#0F172A;text-decoration:none;font-size:13px">1688 Factory Direct</a></b></span><br>
      <span style="color:#2563EB;font-size:11px;font-weight:600">Domestic Factory Prices</span><br>
      <span style="color:#64748B;font-size:11px">SKU matrices &amp; FBA specs</span>
    </td>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FAFAFA;vertical-align:top;width:25%">
      <span style="white-space:nowrap">🐟 <b><a href="https://apify.com/scraperpro/goofish-xianyu-search-scraper?fpr=939u3w&fp_sid=gh_goofish" style="color:#0F172A;text-decoration:none;font-size:13px">Goofish Products</a></b></span><br>
      <span style="color:#2563EB;font-size:11px;font-weight:600">C2C Resale &amp; Arbitrage</span><br>
      <span style="color:#64748B;font-size:11px">Zero-login search engine</span>
    </td>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FFF4ED;vertical-align:top;width:25%">
      <span style="white-space:nowrap">⭐ <b><a href="https://apify.com/scraperpro/goofish-xianyu-seller-scraper?fpr=939u3w&fp_sid=gh_goofish_seller" style="color:#C2410C;text-decoration:none;font-size:13px">Goofish Sellers</a></b></span><br>
      <span style="color:#EA580C;font-size:11px;font-weight:700">📍 You are here</span><br>
      <span style="color:#64748B;font-size:11px">Zhima credit &amp; reviews</span>
    </td>
  </tr>
</table>

***

### 🌟 Why Choose This Scraper? (Marketplace Comparison)

| Feature / Metric | Other Scrapers / Alternatives | ScraperPro Goofish Sellers & Reviews Scraper |
| :--- | :--- | :--- |
| **Product Listing Price** | $0.00899 / item (~$9.00 per 1k) | 💰 **$0.0035 / item (Save 60%!)** |
| **Buyer Review Price** | $0.001 / review | 💰 **$0.001 / review (Best value)** |
| **Server Compute Fees** | Billed for platform compute RAM/time | 🆓 **$0.00 (Zero compute fees)** |
| **Item Link Auto-Resolution** | User must manually find seller ID | ✅ **Auto-resolves seller from product URLs & mobile deeplinks** |
| **Listing Extraction Depth** | Summary cards only | 🚀 **Dual Modes (`summary` fast catalog vs `full` 150+ field specs & condition)** |
| **Product Specifications** | Raw unstructured text or missing | 💎 **Structured Key-Value dictionary (`specs` brand, model, edition)** |
| **Physical Condition Grade** | Omitted or raw code | 💎 **Standardized grades (`全新` Brand New, `99新`, `95新`, etc.)** |
| **Status Filter** | Mixed inventory | 🎯 **Filter by `all`, `onsale` (active), or `sold` (historical sales velocity)** |
| **Buyer Review Unboxing Media** | Text only / missing | 📸 **Full HD buyer unboxing photos (`reviewImages`)** |
| **Review Sentiment Filtering** | None | 🔍 **Isolate disputes (`negative_only`), praises, or photo reviews** |
| **Output Data Flexibility** | Rigid nested JSON (breaks CSV) | 📊 **Dual format (`nested` for APIs + `tabular` for clean Excel/CSV rows)** |
| **Seller Zhima Credit Breakdown** | Single generic badge | 🛡️ **Distinct Seller & Buyer Zhima Credit levels (1–5)** |

<p align="center">
  <a href="https://console.apify.com/actors/xma6AWAwibFiZHSqo/input">
    <img src="https://raw.githubusercontent.com/RNFS/1688-Wholesale-Scraper-API/main/try-it-for-free.svg" width="240" height="48" alt="Try it for Free">
  </a>
</p>

***

### 🧩 The Goofish Scraper Ecosystem

Combine our specialized scrapers to build complete market intelligence pipelines across Alibaba's secondhand marketplace:

| Scraper | Focus | Best For | Status |
| :--- | :--- | :--- | :--- |
| 🔍 **[Goofish Search & Deals Scraper](https://apify.com/scraperpro/goofish-xianyu-search-scraper?fpr=939u3w\&fp_sid=gh_goofish)** | Keyword discovery, market price alerts, deals | Finding items by keyword, tracking category trends | 🟢 **Published** |
| 🏬 **[Goofish Sellers & Reviews Scraper](https://apify.com/scraperpro/goofish-xianyu-seller-scraper?fpr=939u3w\&fp_sid=gh_goofish_seller)** | Profiles, shop inventory, buyer reviews, unboxing photos | Deep seller vetting, catalog extraction, supplier audits | 🌟 **You are here** |

***

### 🤖 Copy to Your AI Assistant (Apify Agent Prompt)

If you are using **Cursor**, **ChatGPT**, **Claude**, or autonomous agents, paste this snippet directly:

```text
Apify Actor scraperpro/goofish-xianyu-seller-scraper. Extracts complete Goofish (闲鱼 / Xianyu / Idlefish) seller intelligence, product inventory catalogs, and buyer transaction reviews. Accepts seller profile URLs, product listing URLs (resolves seller automatically), fleamarket:// mobile deeplinks, or numeric seller IDs. Supports dual output formats: nested JSON (1 record per seller for APIs) or tabular flat rows (clean spreadsheets for Excel/CSV).
Call via ApifyClient:
client.actor("scraperpro/goofish-xianyu-seller-scraper").call(run_input={"sellerInputs":["https://www.goofish.com/personal?spm=a21ybx.item.itemHeader.1.740c3da6vQDa24&userId=2216555697343"],"includeListings":true,"includeReviews":true,"maxListings":20,"maxReviews":30,"outputFormat":"nested"})
```

***

### 🎯 Popular Use Cases

#### 1. Cross-Border Supplier & Seller Due Diligence

Before wiring funds or purchasing high-ticket items through shopping agents (**Superbuy, Pandabuy, Sugargoo, CSSBuy, Mulebuy**), audit the seller's complete reputation:

- Verify Zhima Credit ratings (芝麻信用等级).
- Check real-name and real-person identity badges.
- Isolate negative buyer feedback (`reviewFilter: "negative_only"`) to identify fake goods, Bait-and-Switch tactics, or poor communication.

#### 2. E-Commerce & Dropshipping Catalog Sourcing

Discover high-volume, reliable Chinese merchants. Export their complete active product listings (`statusFilter: "onsale"`), along with high-definition original product photos, descriptions, and structured specifications.

#### 3. Competitor Tracking & Inventory Turnover Velocity

Track how fast items sell by comparing active listings against sold items (`statusFilter: "sold"`). Monitor historical selling prices, discount frequencies, and buyer review volume over time.

#### 4. Brand Protection & Counterfeit Intelligence

Monitor unauthorized liquidations, grey-market imports, and replica sellers. Extract high-resolution buyer unboxing photos (`reviewImages`) to build verified evidence of intellectual property violations.

***

### 📥 Input Settings & Parameters

| Parameter | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| `sellerInputs` | Array | `["2216555697343"]` | Target seller profile URLs (`https://www.goofish.com/personal?userId=...`), product listing URLs (`https://www.goofish.com/item?id=...`), mobile deeplinks (`fleamarket://...`), or numeric IDs. |
| `includeListings` | Boolean | `true` | Extract product listings and inventory catalog from target sellers. |
| `includeReviews` | Boolean | `true` | Extract buyer reviews, star ratings, and unboxing photos. |
| `maxListings` | Number | `20` | Maximum product listings to extract per seller (supports extracting complete shops with thousands of items; set `0` for unlimited complete catalog extraction). |
| `maxReviews` | Number | `30` | Maximum buyer reviews to extract per seller (supports extracting all historical reviews; set `0` for unlimited). |
| `detailLevel` | String | `"summary"` | Listing extraction depth: `"summary"` (ultra-fast card data) or `"full"` (deep specs, brand, model, condition grade, and full description). |
| `statusFilter` | String | `"all"` | Filter listings by status: `"all"` (everything), `"onsale"` (active stock only), or `"sold"` (completed sales only). |
| `reviewFilter` | String | `"all"` | Filter buyer reviews: `"all"`, `"negative_only"` (disputes & complaints), `"with_photos"` (unboxing images), or `"positive_only"`. |
| `outputFormat` | String | `"nested"` | Output structure: `"nested"` (1 unified JSON per seller for APIs) or `"tabular"` (flat rows optimized for Excel / CSV export). |
| `proxyConfiguration` | Object | `Residential Proxy` | Residential Proxy (HK / AP) is automatically enforced for maximum anti-bot stability. |

***

### 💻 Input Samples

#### Sample 1: Comprehensive Seller Reputation & Catalog Audit

```json
{
  "sellerInputs": [
    "https://www.goofish.com/personal?spm=a21ybx.item.itemHeader.1.740c3da6vQDa24&userId=2216555697343"
  ],
  "includeListings": true,
  "includeReviews": true,
  "maxListings": 20,
  "maxReviews": 50,
  "detailLevel": "full",
  "statusFilter": "all",
  "reviewFilter": "all",
  "outputFormat": "nested"
}
```

#### Sample 2: Direct Item Link Resolution (Auto-Detect Seller)

```json
{
  "sellerInputs": [
    "https://www.goofish.com/item?id=1084132717206"
  ],
  "includeListings": true,
  "includeReviews": true,
  "maxListings": 10,
  "maxReviews": 20,
  "detailLevel": "summary",
  "outputFormat": "nested"
}
```

#### Sample 3: Excel & CSV Friendly Tabular Export

```json
{
  "sellerInputs": [
    "2212259311853"
  ],
  "includeListings": true,
  "includeReviews": false,
  "maxListings": 100,
  "statusFilter": "onsale",
  "detailLevel": "summary",
  "outputFormat": "tabular"
}
```

***

### 📤 Output Data Samples

#### 1. Nested Output (`outputFormat: "nested"`)

*Delivers 1 consolidated JSON record per seller. Perfect for API backends, webhooks, and AI pipelines.*

```json
{
  "rowStatus": "ok",
  "recordType": "seller_complete",
  "id": "2217730303960",
  "displayName": "数码电玩玩家",
  "avatarUrl": "https://img.alicdn.com/sns_logo/i1/TB1xxx.jpg",
  "location": "广东深圳",
  "ipProvince": "广东",
  "verification": {
    "realName": true,
    "realPerson": true,
    "zhimaCredit": true,
    "verified": true
  },
  "creditBadge": {
    "role": "seller",
    "rating": "信用极好",
    "level": 5
  },
  "social": {
    "followers": 1420,
    "following": 86
  },
  "counts": {
    "activeListings": 48,
    "reviews": 312,
    "sold": 196
  },
  "responseRate": "98%",
  "listings": [
    {
      "id": "847291847192",
      "title": "任天堂 Switch OLED 日版 续航增强版 白色 99新",
      "price": 1450.0,
      "originalPrice": 2199.0,
      "status": "onsale",
      "freeShipping": true,
      "condition": "99新",
      "specs": {
        "品牌": "Nintendo/任天堂",
        "型号": "Switch OLED",
        "存储容量": "64GB",
        "包装": "原装全套"
      },
      "url": "https://www.goofish.com/item?id=847291847192"
    }
  ],
  "reviews": [
    {
      "reviewId": "918273645",
      "feedback": "成色非常新，顺丰很快，老板沟通很耐心，非常愉快的交易！",
      "rateType": "positive",
      "reviewerRole": "buyer",
      "reviewDate": "2026-03-15",
      "tradedItem": {
        "id": "847291847192",
        "title": "Switch 游戏卡带 塞尔达传说 王国之泪",
        "price": 280.0
      },
      "reviewImages": [
        "https://img.alicdn.com/bao/uploaded/i4/review_unboxing_1.jpg"
      ]
    }
  ]
}
```

#### 2. Tabular Output (`outputFormat: "tabular"`)

*Delivers flat individual rows tagged with `recordType: "item"` or `"review"`. Exports directly to CSV, Google Sheets, or Excel without nested JSON formatting issues.*

```json
{
  "rowStatus": "ok",
  "recordType": "item",
  "sellerId": "2217730303960",
  "sellerName": "数码电玩玩家",
  "sellerCreditRating": "信用极好",
  "sellerLocation": "广东深圳",
  "itemId": "847291847192",
  "title": "任天堂 Switch OLED 日版 续航增强版 白色 99新",
  "price": 1450.0,
  "originalPrice": 2199.0,
  "status": "onsale",
  "freeShipping": true,
  "url": "https://www.goofish.com/item?id=847291847192"
}
```

***

### 🐍 Programmatic Integration

#### Python (`apify-client`)

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_API_TOKEN")

run_input = {
    "sellerInputs": ["https://www.goofish.com/personal?spm=a21ybx.item.itemHeader.1.740c3da6vQDa24&userId=2216555697343"],
    "includeListings": True,
    "includeReviews": True,
    "maxListings": 30,
    "maxReviews": 50,
    "detailLevel": "full",
    "outputFormat": "nested"
}

run = client.actor("scraperpro/goofish-xianyu-seller-scraper").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"Seller: {item.get('displayName')} | Zhima: {item.get('creditBadge', {}).get('rating')}")
    print(f"Listings: {len(item.get('listings', []))} | Reviews: {len(item.get('reviews', []))}")
```

#### JavaScript / Node.js (`apify-client`)

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

const client = new ApifyClient({
    token: 'YOUR_APIFY_API_TOKEN',
});

const input = {
    sellerInputs: ['https://www.goofish.com/personal?spm=a21ybx.item.itemHeader.1.740c3da6vQDa24&userId=2216555697343'],
    includeListings: true,
    includeReviews: true,
    maxListings: 20,
    outputFormat: 'nested',
};

const run = await client.actor('scraperpro/goofish-xianyu-seller-scraper').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();

console.log(`Extracted ${items.length} seller profiles!`);
```

***

### ❓ Frequently Asked Questions

#### Do I need a Chinese mobile number (+86) or Goofish account?

**No.** The scraper operates entirely autonomously in guest mode with automated session harvesting. No login, SMS codes, or personal account credentials are required.

#### Can I paste an item link instead of a seller profile?

**Yes.** The scraper features automatic item resolution. Paste any Goofish item link (e.g. `https://www.goofish.com/item?id=...`), and the actor will identify the seller and scrape their complete profile, inventory, and reviews.

#### What is the difference between `summary` and `full` detail level?

- `summary`: Extremely fast and cost-efficient. Fetches product titles, prices, primary images, locations, and status tags.
- `full`: Performs deep product inspection. Extracts the complete description text, exact physical condition grade, and structured specification attributes (`specs`).

#### How do I export to Excel or Google Sheets without broken columns?

Set `"outputFormat": "tabular"`. This produces flat, spreadsheet-ready rows where each listing or review is its own record with seller metadata attached.

***

### 🔍 Related Keywords & Search Terms (SEO Index)

`Goofish Scraper` • `Goofish API` • `Goofish Seller Scraper` • `Goofish Store Catalog` • `Goofish Reviews Scraper` • `Goofish Buyer Feedback` • `Goofish Unboxing Photos` • `Goofish Zhima Credit Check` • `Goofish Sesame Credit` • `Xianyu Scraper` • `Xianyu API` • `Xianyu Seller Profile` • `Xianyu Shop Scraper` • `Xianyu Reviews` • `Xianyu Dispute Scanner` • `Idlefish Scraper` • `Idle Fish API` • `Idlefish Seller Data` • `Alibaba Secondhand Scraper` • `Taobao Flea Market Scraper` • `闲鱼爬虫` • `闲鱼数据采集` • `闲鱼卖家信息采集` • `闲鱼评价采集` • `闲鱼店铺商品导出` • `闲鱼芝麻信用` • `闲鱼实名认证` • `闲鱼差评监控` • `Superbuy Goofish Check` • `Pandabuy Xianyu Seller Audit` • `Sugargoo Goofish Scraper` • `CSSBuy Seller Due Diligence` • `Mulebuy Xianyu Verification` • `CNfans Goofish` • `Kakobuy Goofish` • `Goofish Excel Export` • `Xianyu CSV Export` • `Goofish Google Sheets` • `Alibaba C2C Market Intelligence` • `Secondhand Luxury Scraper` • `Vintage Fashion Goofish` • `Used Electronics Wholesale Xianyu` • `Anime Figures Goofish Sourcing`

***

### 📄 License & Terms

This repository contains documentation, visual assets, and integration guides for the **Goofish Sellers & Reviews Scraper** hosted on the [Apify Platform](https://apify.com/scraperpro/goofish-xianyu-seller-scraper?fpr=939u3w\&fp_sid=gh_goofish_seller). Distributed under the MIT License.

# Actor input Schema

## `sellerInputs` (type: `array`):

Enter Goofish (闲鱼 / Xianyu) seller profile URLs, item listing URLs (seller will be resolved automatically), fleamarket:// mobile deeplinks, or numeric seller IDs. Supports up to 100 targets per run.

## `includeListings` (type: `boolean`):

Extract the seller's catalog and inventory.

## `includeReviews` (type: `boolean`):

Extract buyer transaction reviews, ratings, traded item context, and unboxing photos.

## `outputFormat` (type: `string`):

Choose 'nested' for 1 consolidated record per seller (matching Zen Studio format, best for API & JSON workflows) or 'tabular' for flat individual rows per product/review (best for Excel, Google Sheets & CSV exports).

## `maxListings` (type: `integer`):

Maximum number of product listings to scrape per seller. Set 0 for unlimited.

## `maxReviews` (type: `integer`):

Maximum number of buyer reviews to scrape per seller. Set 0 for unlimited.

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

Choose 'summary' for fast catalog extraction with photos and pricing, or 'full' to deeply enrich every item with complete descriptions, condition grades, and specs dictionary.

## `statusFilter` (type: `string`):

Filter extracted seller items by status: 'all' (complete catalog), 'onsale' (active items), or 'sold' (historical sold items).

## `reviewFilter` (type: `string`):

Filter buyer reviews: 'all' (all reviews), 'with\_photos' (only reviews with buyer unboxing photos), 'negative\_only' (1-star complaints and disputes), or 'positive\_only' (5-star praises).

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

Select Apify Residential Proxy (enforced for Xianyu anti-bot compatibility) or configure a custom sticky residential proxy.

## Actor input object example

```json
{
  "sellerInputs": [
    "https://www.goofish.com/personal?spm=a21ybx.item.itemHeader.1.740c3da6vQDa24&userId=2216555697343"
  ],
  "includeListings": true,
  "includeReviews": true,
  "outputFormat": "nested",
  "maxListings": 20,
  "maxReviews": 30,
  "detailLevel": "summary",
  "statusFilter": "all",
  "reviewFilter": "all",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "HK"
  }
}
```

# Actor output Schema

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

Extracted Goofish seller profiles, active and sold item catalogs, buyer reviews, ratings, unboxing photos, Zhima credit ratings, and shop analytics.

# 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 = {
    "sellerInputs": [
        "https://www.goofish.com/personal?spm=a21ybx.item.itemHeader.1.740c3da6vQDa24&userId=2216555697343"
    ],
    "includeListings": true,
    "includeReviews": true,
    "outputFormat": "nested",
    "maxListings": 20,
    "maxReviews": 30,
    "detailLevel": "summary",
    "statusFilter": "all",
    "reviewFilter": "all",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "HK"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scraperpro/goofish-xianyu-seller-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 = {
    "sellerInputs": ["https://www.goofish.com/personal?spm=a21ybx.item.itemHeader.1.740c3da6vQDa24&userId=2216555697343"],
    "includeListings": True,
    "includeReviews": True,
    "outputFormat": "nested",
    "maxListings": 20,
    "maxReviews": 30,
    "detailLevel": "summary",
    "statusFilter": "all",
    "reviewFilter": "all",
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "HK",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("scraperpro/goofish-xianyu-seller-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 '{
  "sellerInputs": [
    "https://www.goofish.com/personal?spm=a21ybx.item.itemHeader.1.740c3da6vQDa24&userId=2216555697343"
  ],
  "includeListings": true,
  "includeReviews": true,
  "outputFormat": "nested",
  "maxListings": 20,
  "maxReviews": 30,
  "detailLevel": "summary",
  "statusFilter": "all",
  "reviewFilter": "all",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "HK"
  }
}' |
apify call scraperpro/goofish-xianyu-seller-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scraperpro/goofish-xianyu-seller-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/xma6AWAwibFiZHSqo/builds/UzBCXcQ2ArD42pyYY/openapi.json
