# Goofish Xianyu Scraper - 闲鱼 Items, Sellers, Reviews, Comments (`topapi/xianyu-goofish-scraper`) Actor

Scrape Goofish (闲鱼 Xianyu) items by link or ID and whole seller shops: price, condition, location, wants, views, photos, seller credit, reviews, comments, similar items. No login. Items $2.70 per 1,000; shop listings $0.45, seller profiles and reviews $0.90 per 1,000.

- **URL**: https://apify.com/topapi/xianyu-goofish-scraper.md
- **Developed by:** [Top Api](https://apify.com/topapi) (community)
- **Categories:** E-commerce, Lead generation, Developer tools
- **Features:** Limited permissions
- **Stats:** 16 total users, 7 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.70 / 1,000 items

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

### What does Goofish Xianyu Scraper do?

**Goofish Xianyu Scraper** extracts listings and sellers from [Goofish](https://www.goofish.com) (闲鱼, Xianyu, Idle Fish), Alibaba's second-hand marketplace. Give it item links or IDs, seller links or IDs, or both. Each item comes back as one row with the full listing and the seller. Each seller gives a profile row and the listings of the shop. Seller reviews, item comments, similar items and the home feed are optional add-ons.

Also known as: Goofish scraper · Xianyu scraper · 闲鱼 scraper · Idle Fish scraper · Goofish API · Xianyu seller scraper

- **Full item rows**: price, original price, variant prices, condition, province / city / district, posting and edit time, wants, views, saves, stock, photos, description, category, attributes and tags.
- **The seller inside every item row**: id, display name, city, IP location, followers, items sold, good and bad review counts, reply rate and time, last seen, credit level, Zhima and real-name verification, shop level.
- **Whole seller shops**: every listing of a shop, 20 per page, on sale, sold or both, as listing cards or as full item rows.
- **Seller profiles, reviews, item comments, similar items, home feed**: each is its own row type, charged only when delivered.
- **No login, no cookies, no Chinese phone number**: no Goofish or Taobao account is used.
- **Run it on a schedule**: monitor mode returns only listings, reviews and comments that earlier runs did not deliver.

Keyword search is not offered: Goofish shows search results to signed-in visitors only, and this actor never signs in. Start from item links or seller links (every item row carries `sellerId`, so a run over items gives you the shops to read next).

### What data can you get from Goofish?

<table>
<tr><td>🏷️ Title (`title`)</td><td>💴 Price, original price (`price`, `originalPrice`)</td><td>📉 Price drop (`priceDrop`)</td></tr>
<tr><td>📦 Condition (`condition`, `conditionLevel`)</td><td>📍 Province, city, district (`province`, `city`, `district`)</td><td>📅 Posted, edited, refreshed (`publishedAt`, `modifiedAt`, `refreshedAt`)</td></tr>
<tr><td>❤️ Wants (`wantCount`)</td><td>👀 Views (`viewCount`)</td><td>⭐ Saves (`favoriteCount`)</td></tr>
<tr><td>🖼️ Photos (`images`)</td><td>🧾 Description (`description`)</td><td>🧩 Variants with prices (`variants`)</td></tr>
<tr><td>🚚 Shipping fee, free shipping (`shippingFee`, `freeShipping`)</td><td>🗂️ Category and attributes (`categoryName`, `attributes`)</td><td>🏷️ Tags (`tags`)</td></tr>
<tr><td>👤 Seller name, id, city, IP location</td><td>📈 Seller sold count, followers, reviews</td><td>✅ Credit level, Zhima, real-name, shop level</td></tr>
<tr><td>🏪 Shop listings, on sale / sold</td><td>💬 Seller reviews with photos</td><td>🗨️ Item comments with replies</td></tr>
</table>

Measured on real runs (2026-10-28): 73 item rows from item links and shops had a title, description, price, wants, views, saves, province / city / district, condition level, posting time and the full seller block on 73 of 73 rows. A condition label (成色) was on 6 rows (the rest carry `conditionLevel` only), variants on 7, an original price on 7 and a seller signature on 11. Shop listing cards had an id, title, price, photo and status on 385 of 385 rows, and a want count on every card that shows one. Six seller profiles were full on 6 of 6 rows. Reviews had a rating, reviewer and date on 35 of 35 rows and text on 33; on the "with photos" tab, every review carried its photos.

### How to scrape Goofish with Goofish Xianyu Scraper

1. [Create a free Apify account](https://console.apify.com/sign-up). It comes with $5 of monthly credit and no card is needed.
2. Open **Goofish Xianyu Scraper** and click **Try for free**.
3. Paste item links (`https://www.goofish.com/item?id=...`) into **Item links or IDs**, or seller links (`https://www.goofish.com/personal?userId=...`) into **Seller links or IDs**.
4. For sellers, set **Listings per seller** and turn on **Seller reviews** if you want them. For items, turn on **Item comments** or **Similar items** if you want them.
5. Click **Start**. Rows appear in the dataset as they are read.
6. Open the **Storage** tab and **Export** as JSON, CSV or Excel, or connect a schedule.

### ⬇️ Input

| Parameter | Type | Description |
|---|---|---|
| `itemUrls` | array | Item links (`www.goofish.com/item?id=...`, `h5.m.goofish.com/item?id=...`) or bare item ids. Each returns a full item row. |
| `sellerUrls` | array | Seller links (`www.goofish.com/personal?userId=...`) or bare user ids. Each returns a profile row and the shop's listings. Prefilled with two shops. |
| `maxListingsPerSeller` | integer | Listings per shop (20 per page). `0` = the profile only. Default 20. |
| `listingStatus` | string | `all` (default), `onSale` (在售) or `sold` (已售出): the shop's own tabs; also filters item rows. |
| `listingDetails` | boolean | Open every shop listing and return it as a full item row (charged as an item). Default off. |
| `maxItems` | integer | Most item and listing rows in the run. Default 200. |
| `minPrice` / `maxPrice` | number | Asking-price range in CNY. |
| `publishedWithinDays` | integer | Only items posted in the last N days (rows that carry a posting time). |
| `minConditionLevel` | integer | Only item rows at or above this condition level (10 = brand new). |
| `freeShippingOnly` | boolean | Only items that show free shipping (包邮). |
| `includeSellerProfile` | boolean | A profile row per seller link. Default on. |
| `includeItemSellerProfiles` | boolean | Also a profile row per distinct seller of your item links. Default off. |
| `includeReviews` / `maxReviewsPerSeller` / `reviewFilter` | boolean / integer / string | Seller reviews, newest first; `all`, `positive`, `negative` (中差评), `withPhotos`, `fromBuyers`, `fromSellers`. |
| `includeComments` / `maxCommentsPerItem` | boolean / integer | Comments under each item link, replies inline. |
| `includeSimilar` / `maxSimilarPerItem` | boolean / integer | The listings Goofish recommends under each item link (up to 30). |
| `homeFeedPages` | integer | Pages of the public home feed (猜你喜欢, ~20-30 cards a page). |
| `monitorMode` / `monitorStoreName` / `resetMonitor` | boolean / string / boolean | Only rows earlier runs did not deliver. |
| `proxyConfiguration` | object | Optional: your own proxy. |
| `maxConcurrency` | integer | Items read at once. Default 4. |

#### Input JSON

```json
{
    "itemUrls": ["https://www.goofish.com/item?id=662010153304"],
    "sellerUrls": ["https://www.goofish.com/personal?userId=876017674"],
    "maxListingsPerSeller": 50,
    "listingStatus": "onSale",
    "includeReviews": true,
    "maxReviewsPerSeller": 20,
    "includeComments": true
}
```

#### Paste links as they are

Any Goofish item address works, with or without the `spm=` tracking part: the actor reads the `id=` number. Share short links (`m.tb.cn/...`) are not opened: open one once in a browser and paste the `goofish.com/item?id=...` address it shows, or the id.

#### Shops are read in the shop's own order

A shop is read page by page as the seller's page lists it. `listingStatus` uses the shop's own 在售 (on sale) and 已售出 (sold) tabs, so the count matches what Goofish shows.

### ⬆️ Output

Every row has a `type`: `item`, `listing`, `seller`, `review` or `comment`. The Output tab has a view for each. A real item row (trimmed):

```json
{
    "type": "item",
    "itemId": "1014892439921",
    "url": "https://www.goofish.com/item?id=1014892439921",
    "title": "美国Anvil 家得宝品牌冲子工具，用料厚实，做工精致，外观",
    "price": 12,
    "currency": "CNY",
    "shippingFee": 6,
    "freeShipping": false,
    "condition": "全新",
    "conditionLevel": 10,
    "status": "onSale",
    "negotiable": true,
    "quantity": 7,
    "wantCount": 1,
    "viewCount": 73,
    "favoriteCount": 1,
    "hasVideo": true,
    "province": "辽宁",
    "city": "铁岭",
    "district": "银州区",
    "publishedAt": "2026-01-24T04:22:57.000Z",
    "sellerId": "684927389",
    "sellerCreditLevel": "信用极好",
    "sellerZhimaVerified": true
}
```

A real seller row (trimmed):

```json
{
    "type": "seller",
    "sellerId": "452246201",
    "displayName": "数码宝贝",
    "introduction": "只卖正品！",
    "ipLocation": "山东省",
    "followers": 42,
    "itemCount": 319,
    "onSaleCount": 238,
    "soldCount": 81,
    "reviewCount": 588,
    "praiseRatio": 99,
    "shopLevel": "L4",
    "creditLabel": "卖家信用极好",
    "realNameVerified": true,
    "zhimaVerified": true,
    "url": "https://www.goofish.com/personal?userId=452246201"
}
```

#### Fields

- **item**: `itemId`, `url`, `title`, `description`, `price`, `originalPrice`, `priceDrop`, `minPrice`, `maxPrice`, `currency`, `shippingFee`, `freeShipping`, `condition`, `conditionLevel`, `status`, `statusText`, `itemType`, `negotiable`, `quantity`, `soldQuantity`, `wantCount`, `viewCount`, `favoriteCount`, `images`, `imageCount`, `hasVideo`, `categoryId`, `categoryName`, `channelCategoryId`, `taobaoCategoryId`, `attributes`, `variants`, `tags`, `province`, `city`, `district`, `divisionId`, `publishedAt`, `modifiedAt`, `refreshedAt`, and the seller: `sellerId`, `sellerName`, `sellerNick`, `sellerUrl`, `sellerAvatarUrl`, `sellerCity`, `sellerIpLocation`, `sellerSignature`, `sellerRegisteredAt`, `sellerDaysOnGoofish`, `sellerItemCount`, `sellerSoldCount`, `sellerFollowers`, `sellerGoodReviewRate`, `sellerGoodReviews`, `sellerBadReviews`, `sellerReplyRate24h`, `sellerReplyTime`, `sellerLastActive`, `sellerCreditLevel`, `sellerZhimaVerified`, `sellerRealNameVerified`, `sellerShopLevel`.
- **listing** (a card): `itemId`, `url`, `title`, `price`, `wantCount`, `wantCountIsLowerBound`, `freeShipping`, `status`, `imageUrl`, `images`, `hasVideo`, `labels`, `position`; shop cards add `categoryId`, `sellerId`, `sellerUrl`, `shippingText`; similar items add `city`, `sellerNick`, `publishedAt`, `description`, `similarTo`; home-feed cards add `originalPrice`, `city`, `sellerNick`, `publishedAt`, `categoryId`, `videoUrl`.
- **seller**: `sellerId`, `displayName`, `avatarUrl`, `introduction`, `ipLocation`, `followers`, `following`, `itemCount`, `onSaleCount`, `soldCount`, `reviewCount`, `praiseRatio`, `shopLevel`, `shopScore`, `nextLevelNeedScore`, `shopReviewCount`, `businessQualification`, `creditLabel`, `creditLevel`, `realNameVerified`, `realPersonVerified`, `zhimaVerified`, `isTaobaoUser`, `xianyuUpgraded`, `userType`, `shopGroups`, `url`.
- **review**: `reviewId`, `sellerId`, `rating` (`positive`, `negative` for the 中差评 tab, `none` when the buyer left no rating), `text`, `tags`, `reviewerNick`, `reviewerAvatarUrl`, `reviewerRole` (买家 / 卖家), `reviewerIpLocation`, `createdAt`, `pictures`, `itemImageUrl`, `likeCount`, `highQuality`, `appendCount`.
- **comment**: `commentId`, `itemId`, `itemUrl`, `text`, `authorNick`, `authorId`, `authorAvatarUrl`, `isSeller`, `ipRegion`, `createdAt`, `likeCount`, `replies` (text, author, who it answers, seller flag, time), `replyCount`.
- Every row: `sourceType`, `sourceInput`, `monitorStatus`, `scrapedAt`. Times are ISO 8601 in UTC (Goofish prints Beijing time).

### How can I use Goofish data?

- **Resale pricing**: compare asking prices, original prices and price drops of the same model across sellers.
- **Seller vetting**: credit level, Zhima and real-name verification, sold count, good and bad reviews, reply rate before you buy or source.
- **Shop tracking**: follow competitors' or suppliers' shops and get only their new listings on a schedule.
- **Demand signals**: wants, views and saves per listing.
- **Sourcing from China**: read whole shops of second-hand phones, cameras, collectibles and surplus stock.

### How much does it cost to scrape Goofish?

Pay per result, no start fee:

| Row | Price per row | per 1,000 |
|---|---:|---:|
| Item (full details + seller) | $0.0027 | $2.70 |
| Listing card (shop, similar items, home feed) | $0.00045 | $0.45 |
| Seller profile | $0.0009 | $0.90 |
| Seller review | $0.0009 | $0.90 |
| Item comment | $0.0027 | $2.70 |

Examples: 100 item links = $0.27. A 300-listing shop with its profile = $0.1359. Nothing is charged for duplicates, filtered rows, rows already delivered (monitor mode), deleted items or items Goofish did not serve. Set a spending limit on the run and the actor stops before it.

### Integrations, API, scheduling & MCP

Run it from the [Apify API](https://docs.apify.com/api/v2), the [JavaScript](https://docs.apify.com/api/client/js) or [Python](https://docs.apify.com/api/client/python) client, connect it to Make, Zapier, n8n or Google Sheets, or call it from an AI agent through the [Apify MCP server](https://mcp.apify.com).

#### Run it on a schedule

Create an [Apify schedule](https://docs.apify.com/platform/schedules) (for example every 6 hours) with `monitorMode: true` and your seller links: each run delivers only listings and reviews the earlier runs did not. In monitor mode, **Listings per seller** and **Reviews per seller** are the window checked each run (the shop's first N listings, the newest N reviews), so a check of a quiet shop costs nothing but the run itself. Add a [webhook](https://docs.apify.com/platform/integrations/webhooks) to get the new rows sent to your app.

```bash
curl -X POST "https://api.apify.com/v2/acts/TopApi~xianyu-goofish-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"sellerUrls":["https://www.goofish.com/personal?userId=876017674"],"maxListingsPerSeller":40,"monitorMode":true,"monitorStoreName":"my-shops"}'
```

### Limits & empty runs

- **Full item rows per run**: Goofish answers its item page a limited number of times per network address. On 2026-10-28 one run read 60 full item rows before every route was refused; the rest of the list is reported as "not read" in the status line and is not charged. Run again later for the rest (with monitor mode on, nothing is delivered twice). Shop listing cards, seller profiles, reviews and comments are not limited this way: a 305-listing shop, its profile and reviews came back in one run of 77 seconds.
- **Deleted or wrong item ids** are reported in the status line and not charged.
- **A whole shop** is what the seller's page lists (`itemCount` on the profile row); the larger "items" count on an item page counts the seller's past listings too.
- **Masked nicks**: Goofish masks part of the seller nick on item pages (`齐***手`); `sellerName` carries the full display name from the seller page.
- If Goofish refuses every request of a run, the run ends FAILED with nothing charged.

### FAQ

#### How many items can Goofish Xianyu Scraper collect in one run?

About 60 full item rows per run on 2026-10-28, and whole shops of listing cards (305 in 77 seconds). Use listing cards for large shops and full item rows for the listings you care about.

#### Can I search Goofish by keyword?

No. Goofish answers keyword searches for signed-in accounts only, and this actor never signs in. Use item links or seller links.

#### Can I run it on a schedule to get new listings automatically?

Yes: turn on monitor mode and schedule the run. See "Run it on a schedule".

#### Can I use it with the Apify API or an MCP server?

Yes. Every input above works in the API body, and the actor is available to AI agents through the Apify MCP server.

#### Do I need a Goofish account, cookies or an API key?

No. No Goofish, Taobao or Alipay account is used.

#### Why did my run return no results?

The status line says why: the items are deleted, the user id is wrong, every row was filtered out, nothing is new since the last monitor run, or Goofish refused the run (then nothing is charged).

#### How is it different from other Goofish scrapers?

Five row types in one actor, each priced on its own: full items with the seller inside, shop listings, seller profiles, reviews and comments. Monitor mode for shops, reviews and comments. Nothing charged for rows it could not read.

#### Your feedback

Found a bug or need a field? Open an issue on the actor's Issues tab.

# Actor input Schema

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

Goofish item links (https://www.goofish.com/item?id=..., the mobile h5.m.goofish.com/item?id=... link) or bare item ids, one per line. Each one comes back as an item row with full details and the seller.

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

Goofish seller links (https://www.goofish.com/personal?userId=...) or bare user ids, one per line. Each seller gives a profile row and the listings of the shop. The seller id is in every item row as sellerId.

## `maxListingsPerSeller` (type: `integer`):

How many listings of each seller's shop to return (20 per page, in the shop's own order). 0 = the profile only. In monitor mode this is the window checked each run: the shop's first N listings.

## `listingStatus` (type: `string`):

Which listings of a shop to read (the shop's own 在售 / 已售出 tabs), and which item rows to keep.

## `listingDetails` (type: `boolean`):

Open every listing of the shop and return it as a full item row (description, condition, location, posting time, views, saves, variants) instead of a listing card. Charged as an item.

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

Stop after this many item and listing rows in total (seller profiles, reviews and comments are capped by their own settings).

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

Keep only items and listings at or above this asking price, in yuan.

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

Keep only items and listings at or below this asking price, in yuan.

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

Keep only items posted in the last N days. Applies to rows that carry a posting time (item rows, similar items, home feed); shop listing cards carry none unless "Full details" is on.

## `minConditionLevel` (type: `integer`):

Keep only item rows at or above this Goofish condition level (10 = 全新 brand new, 9, 8, 7...). Item rows only.

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

Keep only items and listings that show free shipping (包邮).

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

One profile row per seller link: display name, avatar, introduction, IP location, followers, listings on sale and sold, review count, praise ratio, shop level and score, credit label, real-name / Zhima verification.

## `includeItemSellerProfiles` (type: `boolean`):

Also return the profile row of each distinct seller of your item links (the item row already carries the main seller fields).

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

Reviews the seller received (信用及评价): rating, text, tags, reviewer nick and role, IP location, date, photos.

## `maxReviewsPerSeller` (type: `integer`):

Newest first, 20 per page. In monitor mode this is the window checked each run: the newest N reviews.

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

The seller page's own review tabs.

## `includeComments` (type: `boolean`):

Public comments (留言) under each of your item links, with the replies inline and whether the seller wrote it.

## `maxCommentsPerItem` (type: `integer`):

Newest first.

## `includeSimilar` (type: `boolean`):

The listings Goofish recommends under each of your item links ("为你推荐"), as listing rows: title, price, city, wants, posting time, seller nick, photo.

## `maxSimilarPerItem` (type: `integer`):

Up to 30.

## `homeFeedPages` (type: `integer`):

Also read N pages of Goofish's public home feed (猜你喜欢, about 30 listing cards a page) - fresh listings across all categories, no input needed.

## `monitorMode` (type: `boolean`):

Remember what earlier runs delivered (in a named key-value store) and return only new listings, items, reviews and comments. Seller shops are read until a page holds nothing new, so a scheduled check of a shop is cheap.

## `monitorStoreName` (type: `string`):

Key-value store that holds what was delivered. Use one name per watch list.

## `resetMonitor` (type: `boolean`):

Forget what earlier runs delivered (this run delivers everything again).

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

Optional. By default the run goes direct, then through one Apify datacenter and one residential exit only when Goofish refuses a route. Give your own proxy to use it instead.

## `maxConcurrency` (type: `integer`):

Items read at once. Default 4.

## Actor input object example

```json
{
  "sellerUrls": [
    "https://www.goofish.com/personal?userId=876017674",
    "https://www.goofish.com/personal?userId=452246201"
  ],
  "maxListingsPerSeller": 10,
  "listingStatus": "all",
  "listingDetails": false,
  "maxItems": 200,
  "freeShippingOnly": false,
  "includeSellerProfile": true,
  "includeItemSellerProfiles": false,
  "includeReviews": false,
  "maxReviewsPerSeller": 20,
  "reviewFilter": "all",
  "includeComments": false,
  "maxCommentsPerItem": 20,
  "includeSimilar": false,
  "maxSimilarPerItem": 10,
  "homeFeedPages": 0,
  "monitorMode": false,
  "monitorStoreName": "goofish-monitor",
  "resetMonitor": false,
  "maxConcurrency": 4
}
```

# Actor output Schema

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

One item per Goofish record; the field type says which (item, listing, seller, review, comment).

# 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 = {
    "sellerUrls": [
        "https://www.goofish.com/personal?userId=876017674",
        "https://www.goofish.com/personal?userId=452246201"
    ],
    "maxListingsPerSeller": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("topapi/xianyu-goofish-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 = {
    "sellerUrls": [
        "https://www.goofish.com/personal?userId=876017674",
        "https://www.goofish.com/personal?userId=452246201",
    ],
    "maxListingsPerSeller": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("topapi/xianyu-goofish-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 '{
  "sellerUrls": [
    "https://www.goofish.com/personal?userId=876017674",
    "https://www.goofish.com/personal?userId=452246201"
  ],
  "maxListingsPerSeller": 10
}' |
apify call topapi/xianyu-goofish-scraper --silent --output-dataset

```

## MCP server setup

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