# Goofish Xianyu Scraper: Listings, Prices, Sellers (`themineworks/goofish-xianyu-scraper`) Actor

Scrape Goofish (Xianyu, 闲鱼) listings by item link, seller, similar items or channel feed: price, original price, want count, condition, seller nickname and city, publish time, pictures. No login. Keyword search is not offered: Goofish answers it with a login or slider check.

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

## Pricing

from $3.00 / 1,000 listings

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 Xianyu Scraper: Listings, Prices, Sellers

[![20 Goofish listings with full seller details in 30 seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/goofish-xianyu-scraper-hero.png)](https://console.apify.com/actors/iwEfdrjvi8Ehg9gZ8/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

From **The Mine Works**, makers of [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) and [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), with over 305,000 runs across 310+ public actors.

Updated 4 Nov 2026: first release. Listings by item link or id, by seller, by "similar items" and from the home and channel feeds, with price, original price, want count, view count, condition, publish time, all pictures and the seller's nickname, city, credit and sales record, one flat row per listing. Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **The numbers a reseller compares, in columns.** Every row has the asking price, the seller's original price when one is set, the price the listing was first posted at (so you can see price cuts), the want count, the view count, the condition grade and the exact publish time in UTC. Sort a whole seller or product line by price or want count without cleaning text.
- **The seller next to the listing.** Full nickname (the listing itself shows only a masked form such as 我\*\*\*旧), city and province, credit level, Sesame and real-person checks, items for sale and sold, good review rate, 24 hour reply rate, last seen, followers and shop level.
- **Many listings of one product without keyword search.** Goofish answers a logged-out search with a login or slider check, so this actor does not offer keyword search and says so here. Instead, paste one example listing and it reads Goofish's own list of similar listings for it, 30 a page, then applies your price, title and date filters.
- **Pay per listing, nothing for errors.** Listings that no longer exist, links that are not Goofish links, the summary row and duplicates are never charged. No Goofish account, cookies or API key.

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/iwEfdrjvi8Ehg9gZ8/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Part of The Mine Works E-commerce and marketplaces family:** [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [AliExpress Scraper](https://apify.com/themineworks/aliexpress-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Kleinanzeigen.de Scraper](https://apify.com/themineworks/kleinanzeigen-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

### Try it in one minute

Paste this into the input (JSON view) and press Start. It returns the first 20 listings of Goofish's "phones and digital" channel with their pages opened and the full seller name. It took 30 seconds in our test run:

```json
{
  "channels": ["digital"],
  "maxItems": 20
}
```

For one product line, paste an example listing into `similarTo` and add a price cap:

```json
{
  "similarTo": ["https://www.goofish.com/item?id=1089872772258"],
  "maxItems": 100,
  "maxPrice": 3000,
  "sortBy": "priceAsc"
}
```

Apify's free plan includes $5 of credit every month, which covers about 690 listings at this actor's price.

#### Copy to your AI assistant

```text
themineworks/goofish-xianyu-scraper on Apify. Reads Goofish (Xianyu, 闲鱼, Alibaba's second-hand marketplace) listings by item link or id, by seller, by similar listings or from the home and channel feeds, and returns one flat row per listing with price in CNY, original price, want count, view count, condition, publish time, pictures and the seller's nickname, city and record, with no login. Keyword search is not offered because Goofish answers it with a login or slider check. Call ApifyClient("TOKEN").actor("themineworks/goofish-xianyu-scraper").call(run_input={"itemUrls": ["https://www.goofish.com/item?id=1089872772258"]}), then client.dataset(run["defaultDatasetId"]).list_items().items. Give itemUrls (links or ids), sellerUrls (profile links or ids), similarTo (example listings; Goofish's similar list for each is read) or channels (any of home, wardrobe, acg, digital, vouchers), or any mix. Optional: maxItems (default 50, 1 to 2000, per seller, example item and channel), includeDetails (default true), includeSellerProfile (default true), minPrice, maxPrice (CNY), publishedWithinDays, titleContains (list of words), freeShippingOnly, sortBy (source, newest, priceAsc, priceDesc, mostWanted), proxyMode (residential default, or datacenter). Listing rows have no _type field and carry item_id, item_url, title, description, price_cny, original_price_cny, first_listed_price_cny, shipping_fee_cny, free_shipping, want_count, view_count, collect_count, quantity, units_sold, status, is_available, condition, category_id, category_name, attributes, tags, has_video, video_url, published_at, image_url, images, image_count, seller_id, seller_nickname, seller_nickname_is_masked, seller_city, seller_province, seller_url, seller_avatar_url, seller_credit_level, seller_sesame_verified, seller_real_person_verified, seller_registered_at, seller_items_for_sale, seller_items_sold, seller_good_review_rate, seller_reviews_good, seller_reviews_bad, seller_reply_rate_24h, seller_reply_time, seller_last_seen, seller_bio, seller_followers, seller_following, seller_review_count, seller_praise_rate, seller_shop_level, seller_items_listed_total, source, source_ref, position, details_scraped, details_error, scraped_at. Each run also writes one row with _type "summary", one with _type "info" when listings were delivered, and a row with _type "error" for each input that could not be read; none of these is charged. Full spec: GET https://api.apify.com/v2/acts/themineworks~goofish-xianyu-scraper/builds/default (Bearer TOKEN), which returns inputSchema and readme. Token: https://console.apify.com/account/integrations?fpr=ymnoit&utm_source=apify-readme&utm_medium=referral
```

### Key features

- **Item link or id.** Paste `https://www.goofish.com/item?id=1089872772258` or just the number. Each one gives one full row: title, description, price, original price, want, view and save counts, condition, category, structured attributes (brand, model, storage), publish time, every picture and the seller block. A listing that was sold and removed gets an error row and no charge.
- **Seller listings.** Paste a profile link such as `https://www.goofish.com/personal?userId=47656566`. The seller's listings are read, 20 a page. Goofish shows at most 50 pages of a seller, so the most you can get from one seller is 1,000 listings. Good for tracking a shop or a reseller.
- **Similar listings.** Goofish's own "similar items" list for an example listing, 30 a page, about 300 listings per example before it runs dry. In our test, the list for an iPhone 15 listing returned iPhone 15 listings from other sellers.
- **Home and channel feeds.** The home feed and four channels (wardrobe bargains, anime and games, phones and digital, vouchers and cards), the same lists the site shows on its front page. Each one holds 240 to 320 different listings in our tests.
- **Filters and sorting.** Price range in yuan, posted within N days, title words, free shipping only, and sorting by newest, price or want count.
- **Full seller names.** The item data shows a masked nickname. With `includeSellerProfile` on (the default), one light extra request per seller adds the full name, province, followers and shop level.
- **Stops cleanly.** Two list pages in a row with nothing new end a read; if the first request is refused on 3 IPs the run ends at once with no charge; eight listings in a row that cannot be opened end the run; the run stops before its time limit and keeps every row it read. The summary row says why.

### What this actor does not do

**No keyword search.** When a search for a word goes to Goofish without a login, the site answers with a login or slider check, for a program and for a real browser window driven by a program alike. This actor never logs in, never uses someone else's account cookies, never solves a slider and does not disguise itself as a person, so it has no keyword input. Use `similarTo` with one example listing, `sellerUrls`, or `channels` instead, and narrow the result with `titleContains` and the price filters.

### How to use it

#### Full data for a list of listings

```json
{
  "itemUrls": [
    "https://www.goofish.com/item?id=1089872772258",
    "590231215545"
  ]
}
```

One full row per listing. Run it on a schedule and compare `price_cny`, `want_count` and `status` between runs to watch a fixed list.

#### Everything a seller has on sale

```json
{
  "sellerUrls": ["https://www.goofish.com/personal?userId=2562709971"],
  "maxItems": 300,
  "sortBy": "newest"
}
```

Up to 300 of the seller's listings, newest first, each with its full page data.

#### Price research for one product

```json
{
  "similarTo": ["https://www.goofish.com/item?id=1089872772258"],
  "maxItems": 200,
  "titleContains": ["iPhone 15"],
  "minPrice": 1500,
  "maxPrice": 4000,
  "publishedWithinDays": 14,
  "sortBy": "priceAsc"
}
```

Find one example listing on goofish.com, paste it here, and get up to 200 similar listings from the last two weeks inside your price band, cheapest first. `want_count` and `view_count` show which asking prices attract buyers.

#### New bargains in a channel

```json
{
  "channels": ["wardrobe", "acg"],
  "maxItems": 100,
  "freeShippingOnly": true,
  "sortBy": "mostWanted"
}
```

#### Fast card-only export

```json
{
  "sellerUrls": ["https://www.goofish.com/personal?userId=2562709971"],
  "maxItems": 1000,
  "includeDetails": false,
  "includeSellerProfile": false
}
```

Rows come from the list cards only: title, price, want count, main picture, tags. No description, no full picture set, no seller block. It is faster and uses far less proxy traffic. Same price per listing.

### Input parameters

| Parameter | Type | Default | What it does |
|---|---|---|---|
| `itemUrls` | array of strings | empty | Listing links or ids. Each gives one full row. Up to 200. |
| `sellerUrls` | array of strings | empty | Seller profile links or ids. Their listings are read, 20 a page. Up to 200. |
| `similarTo` | array of strings | empty | Example listings (links or ids). Goofish's similar list for each is read, 30 a page. The example itself is not returned. |
| `channels` | array | empty | Any of `home`, `wardrobe`, `acg`, `digital`, `vouchers`. |
| `maxItems` | integer | `50` | Most listings per seller, per example and per channel, 1 to 2,000. Item links are not limited by it. |
| `includeDetails` | boolean | `true` | Opens each listing found by a seller, similar or channel read for the description, all pictures, original price, publish time and seller block. |
| `includeSellerProfile` | boolean | `true` | One light request per seller for the full nickname, province, followers and shop level. |
| `minPrice`, `maxPrice` | number | empty | Price range in yuan. |
| `publishedWithinDays` | integer | empty | Keep listings posted in the last N days. |
| `titleContains` | array of strings | empty | Keep listings whose title has at least one of these words. |
| `freeShippingOnly` | boolean | `false` | Keep listings that ship free. |
| `sortBy` | string | `source` | `source` (Goofish order), `newest`, `priceAsc`, `priceDesc` or `mostWanted`, applied to each source's listings before delivery. |
| `proxyMode` | string | `residential` | `residential` (reliable) or `datacenter` (cheaper, its small shared pool is often refused). |

Give `itemUrls`, `sellerUrls`, `similarTo`, `channels` or any mix.

### What data do you get?

One row per listing. Listing rows have no `_type` field; the summary, info and error rows do, so a filter on `_type` separates them. Fields marked "details" need `includeDetails` on (or an item link); fields marked "profile" need `includeSellerProfile` on.

| Field | What it is |
|---|---|
| `item_id`, `item_url`, `title` | The item id, the link on goofish.com and the title (Chinese) |
| `description` | The seller's text (details) |
| `price_cny`, `original_price_cny`, `first_listed_price_cny` | Asking price, the seller's stated original price when set, and the price it was first posted at |
| `shipping_fee_cny`, `free_shipping` | Shipping fee and the free shipping flag |
| `want_count`, `view_count`, `collect_count` | Buyers who tapped 想要, views and saves (views and saves: details) |
| `quantity`, `units_sold`, `status`, `is_available` | Stock, units sold, status text such as 在线, and an on-sale flag (details) |
| `condition` | Condition grade, e.g. 几乎全新 almost new (details) |
| `category_id`, `category_name`, `attributes`, `tags` | Category, structured attributes (brand, model, storage, version), and tags such as 包邮 |
| `published_at` | When the listing was posted, UTC |
| `image_url`, `images`, `image_count` | Main picture, all pictures (details), picture count |
| `has_video`, `video_url` | Video flag, and the video link (details) |
| `seller_id`, `seller_url`, `seller_nickname`, `seller_nickname_is_masked`, `seller_avatar_url` | The seller and the nickname (full with profile on, masked otherwise) |
| `seller_city`, `seller_province` | City on the listing, province from the profile (profile) |
| `seller_credit_level`, `seller_sesame_verified`, `seller_real_person_verified`, `seller_registered_at` | Credit label such as 信用极好, verification marks, account age (details) |
| `seller_items_for_sale`, `seller_items_sold`, `seller_good_review_rate`, `seller_reviews_good`, `seller_reviews_bad` | Seller record (details) |
| `seller_reply_rate_24h`, `seller_reply_time`, `seller_last_seen`, `seller_bio` | Responsiveness and profile line (details) |
| `seller_followers`, `seller_following`, `seller_review_count`, `seller_praise_rate`, `seller_shop_level`, `seller_items_listed_total` | Shop page figures (profile) |
| `source`, `source_ref`, `position` | `item`, `seller`, `similar` or `channel`, which seller, example or channel found it, and its place there |
| `details_scraped`, `details_error`, `scraped_at` | Whether the listing page was read, why not, and when |

**Summary row** (`_type: "summary"`, never charged): `sources_requested`, `sources_read`, `sources_failed`, `list_pages_read`, `listings_found`, `items_delivered`, `charged_for`, `duplicates_skipped`, `filtered_out`, `details_requested`, `details_ok`, `details_failed`, `items_not_found`, `seller_profiles_read`, `http_requests`, `http_retries`, `http_blocked_answers`, `proxy_sessions`, `proxy_sessions_refused`, `http_megabytes_estimated`, `ended_on_deadline`, `stopped_by_max_cost`, `stopped_by_block_guard`, `shortfall_reason`, `per_source`, `run_seconds`.

**Error rows** (`_type: "error"`, never charged): one per input that could not be read, with `error_type` (`invalid_input`, `not_found`, `blocked`, `fetch_error`), `identifier` and `reason`.

#### Output examples

A listing row from a seller read with listing pages and seller profile on (lists shortened to two entries):

```json
{
  "item_id": "1092854211121",
  "title": "苹果 iPad 6 128G 深空灰 国行",
  "price_cny": 498,
  "want_count": 0,
  "free_shipping": true,
  "image_url": "https://img.alicdn.com/bao/uploaded/i2/47656566/O1CN016cpdzYI6g9C2vHAO_!!4611686018427383414-0-xy_item.jpg",
  "published_at": "2026-10-25T08:02:54.000Z",
  "category_id": "50025387",
  "tags": [
    "包邮"
  ],
  "position": 6,
  "item_url": "https://www.goofish.com/item?id=1092854211121",
  "description": "苹果 iPad 6 128G 深空灰 国行\n型号 DMPQYH/FBM，A1893芯片，WiFi版  电池健康度84.\n系统17.7.11，功能正常，屏幕显示正常，主板摄像头电池都...",
  "shipping_fee_cny": 0,
  "view_count": 25,
  "collect_count": 0,
  "quantity": 1,
  "units_sold": 0,
  "status": "在线",
  "is_available": true,
  "condition": "轻微磕碰划痕",
  "category_name": "平板电脑",
  "attributes": {
    "品牌": "Apple/苹果",
    "内存容量": "128GB",
    "成色": "轻微磕碰划痕"
  },
  "images": [
    "https://img.alicdn.com/bao/uploaded/i2/47656566/O1CN016cpdzYI6g9C2vHAO_!!4611686018427383414-0-xy_item.jpg",
    "https://img.alicdn.com/bao/uploaded/i3/47656566/O1CN01Vy6AT2T8c4G2vHAO_!!4611686018427383414-0-xy_item.jpg",
    "..."
  ],
  "image_count": 8,
  "seller_id": "47656566",
  "seller_city": "徐州",
  "seller_url": "https://www.goofish.com/personal?userId=47656566",
  "seller_avatar_url": "https://img.alicdn.com/bao/uploaded/i2/O1CN01tRrbvn1yNHXdICJLu_!!0-mtopupload.jpg",
  "seller_credit_level": "信用极好",
  "seller_sesame_verified": true,
  "seller_real_person_verified": true,
  "seller_registered_at": "2018-03-15T05:44:59.000Z",
  "seller_items_for_sale": 1129,
  "seller_items_sold": 987,
  "seller_good_review_rate": 98,
  "seller_reviews_good": 268,
  "seller_reviews_bad": 5,
  "seller_reply_rate_24h": 92,
  "seller_reply_time": "21分钟",
  "seller_last_seen": "1分钟前来过",
  "seller_bio": "我是个活泼的人,也是个爱笑的人,我精力旺盛、思想新潮,有获得成功的坚定决心。",
  "details_scraped": true,
  "seller_nickname": "我心依旧",
  "seller_province": "江苏省",
  "seller_followers": 1188,
  "seller_following": 55,
  "seller_review_count": 420,
  "seller_praise_rate": 98,
  "seller_shop_level": "L5",
  "seller_items_listed_total": 560,
  "seller_nickname_is_masked": false,
  "source": "seller",
  "source_ref": "47656566",
  "scraped_at": "2026-10-26T10:58:46.967Z"
}
```

An item id that is gone from Goofish gets an error row and no charge:

```json
{ "_type": "error", "error_type": "not_found", "identifier": "123456789012", "reason": "This listing or seller is no longer on Goofish (sold and removed, or the id does not exist)." }
```

The summary row closes every run; it is never charged:

```json
{"_type": "summary", "sources_requested": 1, "sources_read": 1, "list_pages_read": 1, "listings_found": 30, "details_requested": 20, "details_ok": 20, "items_delivered": 20, "charged_for": 20, "http_requests": 53, "proxy_sessions": 6, "proxy_sessions_refused": 0, "run_seconds": 26}
```

### Pricing

Pay per event: you pay for the listings you receive, plus a flat $0.003 per run, whatever memory you choose. Opening listing pages and seller profiles costs nothing extra.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `item-scraped` | Once per listing row stored in your dataset | $3.15 per 1,000 | $3.10 per 1,000 | $3.05 per 1,000 | $3.00 per 1,000 |
| `run-start` | Once per run, right after the first listing is stored | $0.003 | $0.003 | $0.003 | $0.003 |

The price of one listing is the price per 1,000 divided by 1,000.

Never charged:

- inputs that are not a Goofish item link or id, a seller link or id, or a channel (each gets an error row);
- a listing that no longer exists on Goofish;
- a listing that a second source of the same run finds again;
- listings past your `maxItems`, and listings your filters drop;
- the summary, info and error rows;
- a run with no valid input, or one where Goofish returned nothing: the start fee is charged only once a listing is stored;
- anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit, so the run ends SUCCEEDED with a partial result and a status message saying so.

### Run it on a schedule

1. Open the actor in Apify Console, set your input and click **Save as a new task**.
2. In the task, open **Schedules**, click **Add schedule** and pick how often (every day, every Monday at 08:00 and so on).
3. Compare runs on `item_id`, `price_cny`, `want_count` and `status` to see new listings, price cuts, rising interest and items that sold.
4. Optional: add an integration (Google Sheets, Slack, a webhook) so each run lands where your team works.

### FAQ

#### What does this actor read?

The public calls Goofish's own pages and app make to Alibaba's mtop gateway (h5api.m.goofish.com) without being logged in: the item call that Goofish's mobile item page uses, a seller's list, the similar items list, the seller profile and the home and channel feeds. It sends its own user agent (TheMineWorksBot) and no cookies except the anonymous token the gateway hands out. It does not log in, send messages, or read anything behind a sign in.

#### Why is there no keyword search?

Goofish answers a logged-out keyword search with a login or slider check. We tested it again on 4 Nov 2026: the search call was refused all 34 times across residential IPs in 8 countries, and a real browser window driven by a program got the slider 8 times out of 8. Getting past that would take a logged-in account, solving the slider or hiding that a program is asking. This actor does none of those. If you need keyword search, the listing links, sellers and similar lists here will not replace it; start from a listing you already found on goofish.com with `similarTo`.

#### How many listings can I get?

It depends on the source, and these are Goofish's own limits, measured on 26 Oct 2026 with `maxItems` at 2,000:

| Source | Listings in our test | Why it stops |
|---|---|---|
| One seller | 1,000 | Goofish serves 50 pages of 20 for a seller and refuses page 51 |
| Similar to one example listing | 298 | The similar list runs dry after 14 pages |
| Home feed | 295 | Pages repeat listings already seen after 20 pages |
| Wardrobe bargains | 300 | The feed ends at page 30 |
| Anime and games | 236 | Pages repeat listings after 22 pages |
| Phones and digital | 316 | The feed ends at page 30 |
| Vouchers and cards | 272 | Pages repeat listings after 25 pages |

A run can read up to 200 sellers, 200 example items, 200 item links and the five channels, so a run with many sources goes far beyond one source's limit. Item links have no limit but the 200. The summary row's `per_source` section says why each read stopped.

#### What is the difference between includeDetails on and off?

Off, each row comes from the list cards: title, price, want count, city, main picture, tags and sometimes the publish time. On, each listing's own data adds the description, every picture, original price, exact publish time, view and save counts, condition, attributes and the seller block. On is slower and uses more proxy traffic; the price per listing is the same. Item links are always opened.

#### Why is the seller nickname sometimes masked?

Goofish masks the nickname in a listing's data (我\*\*\*旧). With `includeSellerProfile` on, the actor reads the seller's profile page data once per seller and fills in the full name; `seller_nickname_is_masked` tells you which you have.

#### Why does a run sometimes stop with a blocked message?

Goofish counts the calls from each IP address and refuses an IP after some number of them. The actor keeps an IP until it is refused, then repeats that request on a new IP, at most twice, and it never solves a verification page. If the first request of a run is refused on all 3 IPs, the run ends at once and charges nothing. If eight listings in a row cannot be opened later in a run, it stops early, keeps the rows it has, and the summary row says so. In our 4 Nov 2026 tests 549 of 554 listings opened fully; the other 5 were delivered from their list card with `details_scraped` false and `details_error` set. Running again a little later usually works.

#### How long does a run take?

In our tests on 4 Nov 2026: 10 seconds for one item link, 30 seconds for the "Try it" input (20 listings with details and full seller names), 52 seconds for 60 item links, 57 seconds for 100 listings of one seller with details, about 5 minutes for 306 listings from 6 sources, and 30 seconds for 200 card-only listings. Listing pages are opened six at a time. Many IPs are refused for listing calls after a while, so the actor tries another one; that is most of the waiting. The default time limit is 3,600 seconds; the actor stops before it and keeps every row.

#### Do I need an account, cookies or a proxy?

No account and no cookies. The actor uses Apify's residential proxy, billed to your Apify usage: about 17 to 25 KB per listing with details and the seller profile, list pages and refused IPs included, and about 1.4 KB per card-only listing, measured on 4 Nov 2026. Goofish refuses most datacenter IPs, so the `datacenter` option is only for a quick test.

#### Which actor should I use for other marketplaces?

[1688 Wholesale Scraper](https://apify.com/themineworks/1688-wholesale-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) for Alibaba's China wholesale marketplace, [Taobao Products Scraper](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) for Taobao and Tmall retail prices, [Vinted Scraper](https://apify.com/themineworks/vinted-listings-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) and [Kleinanzeigen.de Scraper](https://apify.com/themineworks/kleinanzeigen-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) for other second-hand marketplaces.

#### Which formats can I download?

JSON, CSV, Excel, XML, RSS and HTML from the run's Storage tab or through the API. In CSV and Excel, `attributes` is flattened into columns such as `attributes/品牌`.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/goofish-xianyu-scraper

- Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
- ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
- Cursor or VS Code: add it as an HTTP MCP server with that URL.
- Claude Code: `claude mcp add -t http goofish-xianyu-scraper "https://mcp.apify.com/?tools=themineworks/goofish-xianyu-scraper"`

#### Is it legal to scrape Goofish?

The actor reads only public listings that anyone can see without logging in. You are responsible for how you use the data, including Goofish's terms and data protection law such as GDPR, CCPA and China's PIPL, especially for seller names and locations. This is general information, not legal advice. Goofish and 闲鱼 are trademarks of their owners; this actor is not affiliated with or endorsed by Alibaba Group.

### Integrations

- **Google Sheets**: send each run's listings to a sheet with Apify's Google Sheets integration; one row per listing fits a sheet as is.
- **Make, Zapier and n8n**: start a run and read its dataset with the Apify apps and nodes, for example "price cuts on our 50 watched listings every Monday to Slack".
- **Webhooks**: have Apify call your URL when a run succeeds, then fetch the dataset.
- **API and SDKs**: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
- **MCP clients**: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

### More from The Mine Works

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [AliExpress Scraper](https://apify.com/themineworks/aliexpress-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Kleinanzeigen.de Scraper](https://apify.com/themineworks/kleinanzeigen-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Carsales.com.au Scraper](https://apify.com/themineworks/carsales-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [eBay Product Listings Scraper](https://apify.com/themineworks/ebay-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Shopify Store Scraper](https://apify.com/themineworks/shopify-store-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [🛒 TikTok Shop Scraper](https://apify.com/themineworks/tiktok-shop-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Walmart Product & Price Scraper](https://apify.com/themineworks/walmart-product-price-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Vinted Scraper](https://apify.com/themineworks/vinted-listings-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Support

Found a seller or similar list that returns fewer listings than the site, or a field that comes back empty? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or a new source, email dmineworks@gmail.com.

*Read Goofish (Xianyu) listings by item link, seller, similar items or channel feed and get every listing back as one row, with price, original price, want count, condition, publish time, pictures and the seller's name, city and record, no login.*

# Actor input Schema

## `itemUrls` (type: `array`):

Goofish listing links or ids, one per line. A link such as https://www.goofish.com/item?id=1089872772258 or the number 1089872772258 gives one full row. Up to 200 per run; every item is delivered once.

## `sellerUrls` (type: `array`):

Seller profile links or ids, one per line, such as https://www.goofish.com/personal?userId=47656566 or the number 47656566. The seller's listings are read, 20 per page. Goofish serves at most 50 pages, so 1,000 listings per seller is the most. Up to 200 sellers.

## `similarTo` (type: `array`):

One example listing per line, as a link or an id. Goofish's own 'similar items' list is read for each one, 30 per page, about 300 listings in total. This is the way to collect many listings of one kind of product without keyword search: find one example on goofish.com, paste it here. The example itself is not returned.

## `channels` (type: `array`):

Goofish's own front-page feeds, 20 to 30 listings per page: the home feed, wardrobe bargains, anime and games, phones and digital, vouchers and cards. Each feed holds 240 to 320 different listings.

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

The most listings to return for each seller, each example item and each channel, 1 to 2,000. Goofish's own limits come first: 1,000 per seller, about 300 per example item or channel. Item links are not limited by this. Listings your filters drop do not count. Example: 100.

## `includeDetails` (type: `boolean`):

On: every listing found by a seller, similar or channel read is opened too, for the description, all pictures, original price, exact publish time, view and save counts, condition, attributes and the seller block. Off: rows come from the list cards only (title, price, want count, city, main picture, tags), which is faster. Item links are always opened. Same price either way.

## `includeSellerProfile` (type: `boolean`):

On: one light extra request per seller adds the full nickname (the listing itself shows only a masked form such as 我\*\*\*旧), province, followers and shop level. Off: the masked nickname only.

## `minPrice` (type: `number`):

Keep only listings asking at least this many yuan. Leave empty for no limit.

## `maxPrice` (type: `number`):

Keep only listings asking at most this many yuan. Leave empty for no limit.

## `publishedWithinDays` (type: `integer`):

Keep only listings posted in the last N days. Leave empty for any age.

## `titleContains` (type: `array`):

Keep only listings whose title contains at least one of these words, one per line, Chinese or English, not case sensitive. Example: iPhone 15, 苹果. Leave empty to keep all.

## `freeShippingOnly` (type: `boolean`):

Keep only listings that ship free (包邮).

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

Orders the listings of each seller, example item and channel before they are delivered. Goofish order keeps the order the site returned them in and delivers rows as they are read; the other orders hold a source's rows until it is complete.

## `proxyMode` (type: `string`):

Residential proxy (default) is the reliable choice: Goofish refuses an IP after a few dozen item calls, and residential IPs rotate from a large pool. Datacenter proxy is cheaper but its small shared pool is often refused, so use it only for a quick small test.

## Actor input object example

```json
{
  "channels": [
    "digital"
  ],
  "maxItems": 20,
  "includeDetails": true,
  "includeSellerProfile": true,
  "freeShippingOnly": false,
  "sortBy": "source",
  "proxyMode": "residential"
}
```

# Actor output Schema

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

No description

## `summary` (type: `string`):

No description

# 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 = {
    "channels": [
        "digital"
    ],
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/goofish-xianyu-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 = {
    "channels": ["digital"],
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/goofish-xianyu-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 '{
  "channels": [
    "digital"
  ],
  "maxItems": 20
}' |
apify call themineworks/goofish-xianyu-scraper --silent --output-dataset

```

## MCP server setup

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