Goofish Scraper (闲鱼 / Xianyu / Idlefish) | Search Listings + Sellers

150+ output fields per listing · up to 1,500 per keyword — full item detail, seller profiles with Zhima credit, image galleries, specs, shipping, category labels, service guarantees, and C2C posting metadata.

Zen Studio China Scrapers   •  Goofish, real estate, and wholesale data
Goofish Search ➤ You are here	Goofish Detail URL/ID enrichment	Sellers & Reviews Profiles + reviews	Anjuke Property listings	1688 Wholesale products

Copy to your AI assistant

zen-studio/goofish-xianyu-search-scraper on Apify. Scrapes Goofish (闲鱼 / Xianyu / Idlefish) listings with full item detail, image metadata, specs, category labels, service guarantees, C2C posting metadata, and seller profiles (Zhima credit, reviews, reply rate). Call ApifyClient("TOKEN").actor("zen-studio/goofish-xianyu-search-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items. Provide either keyword (CN or EN) OR searchUrls (Goofish search URLs sharing one keyword); Goofish caps at 1,500 per keyword. Full spec: GET https://api.apify.com/v2/acts/zen-studio~goofish-xianyu-search-scraper/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Token: https://console.apify.com/account/integrations

Key Features

• 150+ output fields per listing — item detail, seller profile, image gallery, specs, category labels, service guarantees, and C2C posting metadata
• Chinese or English keywords — searches 闲鱼 directly (手机, iPhone 15, 乐高 all work)
• 1,500 results per keyword — Goofish's own hard cap
• Rich seller intelligence — Zhima credit tier, reply rate, reviews, registered days, other listings
• Free tier — 5 lifetime runs, 20 listings per run

How to Scrape Goofish (闲鱼) Data

Basic — search by keyword

{
  "keyword": "iPhone 15",
  "maxItems": 20
}

Chinese keyword with filters

{
  "keyword": "手机",
  "maxItems": 50,
  "sortBy": "newest",
  "priceMin": 1000,
  "priceMax": 5000,
  "publishedWithinDays": "7",
  "quickFilters": [
    "filterPersonal",
    "filterFreePostage"
  ]
}

Region-targeted search (Guangzhou 广州)

{
  "keyword": "乐高",
  "maxItems": 100,
  "regionIds": [
    "440100"
  ],
  "sortBy": "priceDrop"
}

Paste a Goofish search URL instead

{
  "searchUrls": [
    "https://www.goofish.com/search?q=nintendo%20switch"
  ],
  "maxItems": 30
}

Input Parameters

Parameter	Type	Default	Description
keyword	string	required unless URLs given	Search term (CN or EN). Ignored when searchUrls is set.
searchUrls	string[]	—	Goofish search URLs, all sharing one keyword. Takes precedence over keyword when non-empty.
maxItems	integer	100	1–1,500
sortBy	string	newest	relevance / newest / priceAsc / priceDesc / priceDrop / modified / credit
priceMin	integer	—	Min price in CNY ¥
priceMax	integer	—	Max price in CNY ¥
publishedWithinDays	string	—	1 / 3 / 7 / 14
quickFilters	string[]	—	filterPersonal / filterAppraise / filterFreePostage / filterNew / inspectedPhone / filterOneKeyResell / filterHighLevelYxpSeller / gameAccountInsurance
regionIds	string[]	—	CN admin-division IDs (e.g. 440100 Guangzhou)
exposeGps	boolean	false	Surface approximate seller GPS (rounded to ~10 km grid)

What Data Can You Extract from Goofish (闲鱼)?

Every listing includes:

• Item — id, url, title, price, priceOriginal, soldPrice, currency, description, status, statusLabel, listingType, itemType, templateId, postedAt, postedAtEpochMs, quantity, shippingFee, images, specs, categoryPath, categoryLabels, categoryIds, tags, topics, badges, serviceGuarantees, tradeAccessType, isAuction, hasVideo
• Seller — id, name, handle, type, avatarUrl, city, publishCity, signature, summary, registeredAt, registeredDays, zhimaVerified, zhimaLevelCode, zhimaLevelName, creditBadgeUrl, creditLevel, level, identityTags, identityTagDetails, levelTagDetails, lastActiveLabel, aoiTypeRaw, yxpPro
• Seller stats — totalItemsListed, totalSold, goodReviews, badReviews, neutralReviews, replyRate24h, replyRate24hRaw, avgReplyInterval, avgReplyMinutes30d, newItemRatio
• Seller other items — up to a dozen related listings from the same seller
• Item stats — views, favorites, favoritesInteract, wants, wantsUnit, sold
• Flags — simpleItem, bargained, charity, noPicture, worthBuySimilarFeeds, defaultPrice, defaultPicture, tbSupportTrade, pcSupportTrade, titleIsUserInput, reserved
• C2C posting (when applicable) — area/district, city, province, item/seller IDs, prices, condition, flags, images, cleaned attributes, edit timestamps, approximate GPS (opt-in)

Output Example

Composite example. Arrays are shortened, but every output field family is shown. The posting block appears only for C2C listings.

{
  "id": "1043651259843",
  "url": "https://www.goofish.com/item?id=1043651259843",
  "title": "iPhone 15 Pro Max 256GB 自用成色好 ID隐藏",
  "price": 3500,
  "priceOriginal": 4500,
  "soldPrice": 3500,
  "currency": "CNY",
  "priceUnit": "",
  "city": "广东",
  "pictureUrl": "http://img.alicdn.com/bao/uploaded/i4/O1CN013d41iY1O2pqrpm4nz_!!4611686018427383552-53-fleamarket.heic",
  "listingType": "detailCommonBuy",
  "itemType": "detailCommonBuy",
  "templateId": 0,
  "isAuction": false,
  "hasVideo": false,
  "isAd": false,
  "status": "online",
  "statusLabel": "在线",
  "quantity": 1,
  "shippingFee": "0.00",
  "tradeAccessType": 1,
  "postedAt": "2026-04-19T18:55:10+08:00",
  "postedAtEpochMs": 1776596110000,
  "serverTimeAt": "2026-04-19T19:05:42+08:00",
  "description": "15pm 功能都正常，id 隐藏。感兴趣的话点'我想要'和我私聊吧～",
  "categoryId": "50025386",
  "taobaoCategoryId": "126862528",
  "categoryPath": [
    "手机",
    "Apple/苹果",
    "iPhone 15 Pro Max",
    "256GB"
  ],
  "categoryLabels": [
    {
      "name": "品牌",
      "value": "Apple/苹果",
      "propertyId": 20000,
      "valueId": 30111,
      "channelCategoryId": 126862528,
      "source": "newPublishChoice",
      "properties": "20000##品牌:30111##Apple/苹果"
    }
  ],
  "categoryIds": {
    "channelCatId": 126862528,
    "level2ChannelCatId": 126868835,
    "level3ChannelCatId": 126876576,
    "rootChannelCatId": 126866987,
    "tbCatId": 1512,
    "catId": 50025386,
    "sugShow": false
  },
  "tags": [
    "包邮",
    "验货宝"
  ],
  "badges": [
    "6小时前发布",
    "¥4500",
    "4人想要",
    "验货宝"
  ],
  "topics": [
    "Apple/苹果"
  ],
  "specs": [
    {
      "name": "品牌",
      "value": "Apple/苹果",
      "propertyId": 20000,
      "valueId": 30111
    },
    {
      "name": "型号",
      "value": "iPhone 15 Pro Max",
      "propertyId": 205924957,
      "valueId": 22955740094
    },
    {
      "name": "存储容量",
      "value": "256GB",
      "propertyId": 12304035,
      "valueId": 11835346
    }
  ],
  "serviceGuarantees": [
    {
      "id": "16944",
      "namespace": "idle-item-detail"
    },
    {
      "id": "12799",
      "namespace": "idle-item-detail"
    }
  ],
  "stats": {
    "views": 71,
    "favorites": 1,
    "favoritesInteract": 0,
    "wants": 4,
    "wantsUnit": "人想要",
    "sold": 0
  },
  "flags": {
    "simpleItem": true,
    "bargained": false,
    "charity": false,
    "noPicture": false,
    "worthBuySimilarFeeds": false,
    "defaultPrice": false,
    "defaultPicture": false,
    "tbSupportTrade": true,
    "pcSupportTrade": true,
    "titleIsUserInput": true,
    "reserved": false
  },
  "charityBadgeUrl": "http://gw.alicdn.com/mt/TB1FjjLdkcx_u4jSZFlXXXnUFXa-204-60.png",
  "images": [
    {
      "url": "http://img.alicdn.com/bao/uploaded/i4/O1CN013d41iY1O2pqrpm4nz_!!-53-fleamarket.heic",
      "width": 1440,
      "height": 1920,
      "major": true,
      "type": 0,
      "photoSearchUrl": "https://h5.m.goofish.com/wow/moyu/moyu-project/idle-photo-search/pages/home?...",
      "whiteBackground": true,
      "labels": [
        "验货宝"
      ]
    },
    {
      "url": "http://img.alicdn.com/bao/uploaded/i3/O1CN01jUrelK1O2pqrpmXv4_!!-53-fleamarket.heic",
      "width": 1440,
      "height": 1920,
      "major": false,
      "type": 0
    }
  ],
  "seller": {
    "id": "2216672251648",
    "name": "勤劳的小蚂蚁",
    "handle": "勤劳的小蚂蚁",
    "type": "c2c",
    "avatarUrl": "https://gtms03.alicdn.com/tps/i3/TB1LFGeKVXXXXbCaXXX07tlTXXX.png",
    "identity": "",
    "identityTags": [
      "实人认证已通过"
    ],
    "identityTagDetails": [
      {
        "text": "实人认证已通过",
        "type": "real_name_verified",
        "typeRaw": "1",
        "link": "https://h5.m.taobao.com/2shou/pd/realVerifyUrl.html?userId=2216672251648&isVerify=1",
        "icon": "https://gw.alicdn.com/bao/uploaded/TB1E3aKPFXXXXcKXpXXXXXXXXXX-32-32.png"
      }
    ],
    "levelTagDetails": [
      {
        "icon": "https://gw.alicdn.com/imgextra/i1/O1CN01YTUhW41aSHETi0kIJ_!!6000000003328-2-tps-228-48.png",
        "sellerLevel": 5
      }
    ],
    "businessTags": [
      "严选"
    ],
    "infoTags": [
      "已验货"
    ],
    "statLabels": [
      "6239条评价",
      "好评率96%"
    ],
    "city": "广州",
    "publishCity": "广州",
    "signature": "简单开心就好",
    "summary": "卖出过15件宝贝。",
    "registeredAt": "2023-09-28T00:18:43+08:00",
    "registeredDays": 935,
    "zhimaVerified": true,
    "zhimaLevelCode": "B",
    "zhimaLevelName": "信用优秀",
    "creditBadgeUrl": "https://gw.alicdn.com/imgextra/i1/O1CN01YTUhW41aSHETi0kIJ_!!6000000003328-2-tps-228-48.png",
    "creditLevel": 5,
    "level": 5,
    "aoiTypeRaw": "0",
    "yxpPro": false,
    "reviewsLabel": "15条评价",
    "lastActiveLabel": "2小时前来过",
    "stats": {
      "totalItemsListed": 32,
      "totalSold": 15,
      "newItemRatio": "95%",
      "goodReviews": 14,
      "badReviews": 1,
      "neutralReviews": 0,
      "replyRate24h": "77%",
      "replyRate24hRaw": 0.7727,
      "avgReplyInterval": "3小时+",
      "avgReplyMinutes30d": 244
    },
    "otherItems": [
      {
        "id": 1043712345678,
        "title": "AirPods Pro 2 国行正品",
        "priceLabel": "¥1280",
        "imageUrl": "https://img.alicdn.com/bao/uploaded/i3/...airpods.jpg",
        "itemLink": "https://www.goofish.com/item?id=1043712345678",
        "type": "1",
        "attributes": {
          "stuffStatus": "99",
          "firstPrice": "1999.00",
          "bargain": "1"
        }
      }
    ]
  },
  "posting": {
    "itemId": 1043651259843,
    "sellerId": 2216672251648,
    "sellerNick": "xy315573248039",
    "title": "iPhone 15 Pro Max",
    "city": "广州",
    "province": "广东",
    "itemType": "BUYNOW",
    "tradeType": "ONLINE",
    "itemFrom": "5051",
    "stuffStatus": "level_9",
    "itemStatus": 0,
    "area": "天河区",
    "categoryId": 50025386,
    "templateId": 0,
    "spuId": 0,
    "grade": 0,
    "duration": 0,
    "inputProperties": "",
    "descPath": "desc/icoss!01043651259843!2216672251648",
    "majorPicture": "i4/O1CN013d41iY1O2pqrpm4nz_!!-53-fleamarket.heic",
    "chopPic": "i4/O1CN013d41iY1O2pqrpm4nz_!!-53-fleamarket.heic",
    "absoluteMajorPicture": "http://img.alicdn.com/bao/uploaded/i4/O1CN013d41iY1O2pqrpm4nz_!!-53-fleamarket.heic",
    "images": [
      {
        "url": "http://img.alicdn.com/bao/uploaded/i4/O1CN013d41iY1O2pqrpm4nz_!!-53-fleamarket.heic",
        "width": 1440,
        "height": 1920,
        "major": true,
        "type": 0
      }
    ],
    "reservePrice": 3500,
    "reservePriceMoney": {
      "amount": 3500,
      "cent": 350000,
      "centFactor": 100,
      "currency": "CNY",
      "displayUnit": "元"
    },
    "originalPrice": 4500,
    "transportFee": 0,
    "quantity": 1,
    "soldQuantity": 0,
    "divisionId": 440106,
    "stuffStatusNew": 9,
    "buyNow": true,
    "valid": true,
    "online": true,
    "canBuy": true,
    "sellerPayPostfee": true,
    "auction": false,
    "bidden": false,
    "resell": false,
    "draft": false,
    "deleted": false,
    "pulledOff": false,
    "pulledOffOrDeleted": false,
    "imageWithText": false,
    "appraiseItem": false,
    "crossCity": false,
    "serviceItem": false,
    "houseItem": false,
    "idleCoinBidItem": false,
    "idleCoinBuyNowItem": false,
    "idleCoinItem": false,
    "playboyItem": false,
    "topic": false,
    "firstModifiedAt": "2026-04-18T14:22:10+08:00",
    "userModifiedAt": "2026-04-19T18:54:55+08:00",
    "lastModifiedAt": "2026-04-19T18:55:10+08:00",
    "attributes": {
      "mItem": "1",
      "bargain": "1",
      "supportFreight": "0",
      "biz_line": "normalbuynow",
      "tbCatId": "1512",
      "cCatId": "126862528",
      "mItemId": "1043651259843"
    },
    "tags": [
      "idleSpaceMainItem"
    ],
    "gps": "23.1,113.3"
  },
  "detailError": null
}

Advanced Usage

Price-drop hunting

{
  "keyword": "iPhone 15 Pro",
  "sortBy": "priceDrop",
  "maxItems": 100
}

Surfaces listings whose sellers have recently cut the price — strongest resale signal on Goofish.

Personal sellers only, brand new

{
  "keyword": "Nintendo Switch OLED",
  "quickFilters": [
    "filterPersonal",
    "filterNew"
  ],
  "maxItems": 50
}

Excludes shops and shows only brand-new items from individual sellers.

Multi-city comparison

{
  "keyword": "MacBook Pro M3",
  "regionIds": [
    "110100",
    "310100",
    "440100"
  ],
  "maxItems": 200
}

Scopes to Beijing 北京 + Shanghai 上海 + Guangzhou 广州 in one run.

Xianyu-inspected phones

{
  "keyword": "iPhone 15",
  "quickFilters": [
    "inspectedPhone"
  ],
  "sortBy": "credit"
}

Only phones that went through Xianyu's 严选 inspection, sorted by seller credit score.

Pricing — Pay Per Event (PPE)

$8.99 per 1,000 listings, charged per item scraped.

Event	Per call	Per 1,000
listing	$0.00899	$8.99

Cost Examples

Listings	Cost
20	~$0.18
100	~$0.90
1,000	~$8.99

Free tier: 5 lifetime runs, 20 listings per run. No credit card required.

Cost Optimization

• Set maxItems to only what you need — each listing is billed
• Combine priceMin/priceMax + quickFilters to narrow before scraping
• Use publishedWithinDays to skip stale listings

FAQ

How many results per keyword? Goofish caps each keyword at 1,500 fresh results — we return up to that limit. For deeper extraction, split into multiple keywords (e.g. iPhone 15 Pro + iPhone 15 Pro Max + iPhone 15).

Can I search in Chinese? Yes. Keywords work in both Chinese (手机, 乐高, 二手iPhone) and English (iPhone 15, Nintendo Switch). Chinese keywords often match more listings since that's what sellers write.

What's the difference between Goofish, Xianyu, and 闲鱼? All the same site. 闲鱼 is the Chinese name, "Xianyu" the pinyin, "Goofish" the English brand. Owned by Alibaba.

How fresh is the data? Every run fetches live results at request time. No caching, no stale data.

Do I need a Goofish account? No. Scrapes work anonymously.

Can I filter by seller credit or verification? Yes. Use sortBy: "credit" to surface the highest-credit sellers first, or filter in post-processing by seller.zhimaVerified, seller.creditLevel, or seller.zhimaLevelName.

What's the free tier? 5 lifetime runs, 20 listings per run. Plenty to evaluate whether the output fits your workflow.

Are seller GPS coordinates included? Only if you set exposeGps: true. Even then, coordinates are rounded to 0.1° (≈10 km grid) — raw coordinates are never emitted. Default is off.

Does it scrape sold / offline listings? Yes. The status field returns online, offline, or sold. Offline/sold listings still include item details where available.

Can I use Goofish search URLs instead of keywords? Yes. Paste them into searchUrls. All URLs in a single run must share the same keyword (Goofish URLs only encode the search term, not filters).

How do I get a specific listing's detail? Use the Goofish Detail Scraper with the listing url or id from this actor.

Support

• Bugs: Issues tab
• Features: Issues tab

Legal Compliance

Extracts publicly available data from Goofish (闲鱼). Users must comply with Goofish's terms of service and relevant data protection regulations (GDPR, CCPA, PIPL).

---

Keyword search for Goofish (闲鱼 / Xianyu) — Alibaba's C2C marketplace — with full item detail and rich seller profiles.