Goofish Scraper 闲鱼 Xianyu (Idlefish) - Listings + Sellers
Pricing
from $5.99 / 1,000 listings
Goofish Scraper 闲鱼 Xianyu (Idlefish) - Listings + Sellers
Search Goofish 闲鱼 (Xianyu/Idlefish) listings by keyword or batches of keywords. Export prices, full descriptions, photos, condition, province and district, seller profiles and engagement stats. Automatic deeper search; up to 20,000 unique listings per run.
Pricing
from $5.99 / 1,000 listings
Rating
1.0
(1)
Developer
Zen Studio
Maintained by CommunityActor stats
6
Bookmarked
790
Total users
111
Monthly active users
5 days ago
Last modified
Categories
Share
Goofish Scraper (闲鱼 / Xianyu / Idlefish) | Search Listings + Sellers
From Zen Studio, creators of 1688 Wholesale, Taobao and RedNote Search.
Why choose this actor?
Go deeper than basic search-result exports.
Search by keyword and collect detailed listing and seller data together. Full mode adds descriptions, specs, media and seller metrics to the search results. The output covers 150+ available fields; the populated fields vary by listing and category.
Variant stock. Seller sales. Seller ratings.
See quantities and prices for individual variants where published, alongside the seller’s reported sales and positive-review rate. Compare available inventory and seller track records in the same dataset. These fields are conditional, not present on every listing.
Keep the details needed for sourcing.
Export image galleries, video links, condition, shipping and service guarantees where available. Narrow searches by region, price, seller credit or posting window.
Search deeper with one shared result limit.
Search several keywords together, remove duplicate listings automatically, and continue across price ranges when a search window is exhausted. Set maxItems up to 20,000; available results depend on the query and filters.
Quick start
Start with 20 iPhone listings in full mode. Replace the keyword with your product or model; Chinese and English search terms are supported.
Open actor input to try your keyword and choose filters.
Full mode is required for the richer detail shown here. Some listings have no variants or public seller metrics. If full details are unavailable, the actor can return the search information with a detailStatus field explaining the outcome.
| Zen Studio · Goofish & Dewu |
 Goofish SearchYou are here  Item DetailEnrich known item URLs  Sellers & ReviewsProfiles, listings & feedback  Image SearchFind listings from a photo  DewuChina resale prices |
Copy to your AI assistant
Key Features
- 150+ output fields per listing — item detail, seller profile, image gallery, video, specs, SKU variants, category labels, service guarantees, GPS location, and condition
- Chinese or English keywords — searches 闲鱼 directly (
手机,iPhone 15,乐高all work) - Past the 1,500-result wall — raise
maxItemsand the Actor digs deeper automatically - Rich seller intelligence — Zhima credit tier, reply rate, reviews, registered days, other listings
- Free tier — 20 lifetime runs, 30 listings per run
Listing coverage
Rich search results without full enrichment. Every search result now carries the signals Goofish shows on each results card, so detailLevel: summary runs (and any listing whose detail page can't be opened) still come back rich:
- Item —
freeShipping,priceDropPercent,stats.wants(want count), and the fullcategoryIdstriple - Seller —
refId(a stable per-seller key for grouping a seller's listings),stats.totalReviews+stats.positiveRatePercent,creditLabel, and a now-populatedreviewsLabel - Cleaner
badges— internal icon names are filtered out
Category-specific detail blocks. Full runs now surface vertical fields wherever Goofish has them:
- Rentals — a
rentalHouseblock: rent, layout, area, amenities, lease terms, and house-verification status - Recruitment — a
jobInfoemployer profile (business name, scope, registered address, logo) - B2C —
seckillflash-sale state, coupon / warm-up promotions, andtrendyPromotion
These all appear automatically; no input change is needed. Already have the item IDs? The new Goofish Item Detail Scraper returns all of this per listing without a search.
How to Scrape Goofish (闲鱼) Data
Basic — search by keyword
Chinese keyword with filters
Region-targeted search (Guangzhou 广州)
Paste a Goofish search URL instead
Batch searches take turns under one global result limit. Each term gets an initial allocation before earlier searches go deeper; unused capacity is shared with terms that still have results. Listings matching multiple terms appear once, attributed to the first query that collected them. A small cap can still leave some queries unsearched. Open Run coverage in the Output tab (the OUTPUT record) for each query's status, admitted count and failures.
Input Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
keyword | string | — | Single search term (CN or EN). Required unless keywords or searchUrls is provided. |
keywords | string[] | — | Up to 1,000 nonempty text entries, processed concurrently; duplicate terms are combined. Takes precedence over keyword. |
searchUrls | string[] | — | Goofish search URLs covering up to 1,000 distinct terms. Takes precedence over keywords and keyword when non-empty. |
maxItems | integer | 100 | 1–20,000 unique listings across the entire run, including all keywords; Console prefill is 20. |
detailLevel | string | full | full (enrich every listing) / summary (listing essentials only — much faster) |
includeItemRecord | boolean | false | Full mode only: add exact province/district, condition grade, posting attributes and edit timestamps where available. No extra listing event. |
verifiedRecentOnly | boolean | false | Combine with publishedWithinDays to reject listings whose known publication time is older than the selected window. |
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[] | — | Province/city filter. In the UI it's a searchable dropdown (e.g. 广州 · 广东 Guangdong); API callers pass the numeric code, e.g. 440100 = Guangzhou. Leave empty for nationwide. |
Prices must be whole, nonnegative yuan amounts; the minimum cannot exceed the maximum. Invalid filter values produce a validation error instead of silently broadening the search. API callers may also send supported day windows as integers. Blank or object-shaped search URL entries are ignored, preserving existing API behavior; keyword batch entries must be nonempty text.
Detail level: speed vs depth
detailLevel trades depth for speed:
-
full(default) — every listing is enriched with its complete detail page: description, full image gallery, condition, seller profile, and stats (all the fields below). -
summary— returns each listing straight from the results page without opening it, so it runs much faster. Each record includes:- Core listing —
id,url,title,price,priceOriginal,currency,city,postedAt,postedAtEpochMs,listingType,pictureUrl,badges,isAd/isAuction/hasVideo - Card-side signals —
freeShipping,priceDropPercent,stats.wants(want count),categoryId+taobaoCategoryId+categoryIds(full id triple) - Seller —
name,avatarUrl,refId(stable per-seller key for grouping a seller's listings),reviewsLabel+stats.totalReviews,stats.positiveRatePercent,creditLabel
Switch to
fullwhen you need the description, the full image gallery, specs, or the seller's complete profile and stats. - Core listing —
summary output (one complete real iphone search result):
The same card-side fields (want count, free-shipping, price-drop %, category ids, and the seller's review count / positive rate / credit label) are also kept on any
full-mode listing that can't be fully opened, so a partial result is still rich.
Search several keywords
Use keywords: ["iphone", "手机"] or search URLs with different terms. Up to three queries run concurrently, sharing maxItems and a single billing boundary. A listing matching several queries appears once; keyword identifies the first query that found it. Search URLs take precedence over keywords, which takes precedence over keyword. Existing single-keyword inputs keep their behavior.
For extended listing data, set includeItemRecord: true in Full mode: exact province and district, source condition grade, posting attributes and edit timestamps. Omitted API and saved-task inputs keep this option off to preserve their existing request workload. New Console input suggests enabling it. This extra work increases run time; leave it off when the existing detail fields are sufficient. sourceItemRecord and sourceDetailPage indicate which enrichment supplied data. Missing source values stay absent. Existing populated fields keep their source precedence; exact posting values remain available in itemRecord, including itemRecord.city and itemRecord.regionAttributes. No additional listing event is charged for this enrichment.
What Data Can You Extract from Goofish (闲鱼)?
The default full mode can return the following fields. Availability depends on the listing, category and source response; missing details are reported by detailStatus.
- Item — id, url, title, price, priceOriginal, soldPrice, currency, description, status, statusLabel, listingType, itemType, templateId, postedAt, postedAtEpochMs, quantity, shippingFee, freeShipping, priceDropPercent, images, specs, categoryName, categoryPath, categoryLabels, categoryIds, tags, topics, badges, serviceGuarantees (named), tradeAccessType, isAuction, hasVideo, isAd, priceRange, video, variants, descriptionRich, promotion, appraisalService, consumerNotice, qualityBadgeUrl, relatedItems, circle, affiliate, isB2C, b2cBizType, benefitTags
- Seller — id, url, refId (stable grouping key, present even on search-only records), name, handle, avatarUrl, pendantUrl, city, publishCity, signature, summary, identity, registeredAt, registeredDays, zhimaVerified, zhimaLevelCode, zhimaLevelName, creditBadgeUrl, creditLevel, creditLabel, reviewsLabel, identityTags, identityTagDetails, levelTagDetails, infoTags, honorTag, shop (verified-merchant profile), resume (service sellers), lastActiveLabel, aoiTypeRaw, yxpPro, sellerIdentityMasked
- Seller stats — totalItemsListed, totalSold, goodReviews, badReviews, autoConfirmedReviews (auto-confirmed positive reviews, 默认好评 — not neutral), goodReviewRate (好评率), replyRate24h, replyRate24hRaw, avgReplyInterval, avgReplyMinutes30d (on
summary/ not-fully-opened listings, the card supplies totalReviews + positiveRatePercent instead) - 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
- Condition, region & location —
condition(label + code),regionAttributes(division, POI name, free-shipping / bargain flags), and exactgpscoordinates (lat/lng, plus agpsRawstring) when the listing carries them - Media & variants —
imagesgallery,video(play URLs + cover + dimensions), andvariants(SKU options with per-option price, stock, properties, and swatch images) - Verified merchant (B2C) & services — verified-merchant results add an
inspectionReport(per-item checks, defect list, masked identifier, conclusion),b2cPromotion(coupons, promotion tags, warm-up / presale prices, activity name),b2cBizTypeText,logistics,detailImages, aseckillflash-sale block (active flag, status, start/end), andtrendyPromotion; service listings addskillService(incl.careerName) - Rentals — rental listings add a
rentalHouseblock: rentattributes(rent / layout / area, plus decoration, orientation, and lease terms), roommatetags,amenities(furnishings with icons), house-verification status, and a renter safety notice - Recruitment — job listings add a
jobInfoblock with the hiringemployerprofile (business name, registered address, business scope, logo) detailStatus— per-record outcome:enriched(full detail present),summary(search-only by design, fromdetailLevel: "summary"),offline(listing no longer available), ordetails_unavailable(a live listing whose full detail couldn't be retrieved; the search-side fields are still present).detailErroris a deprecated alias (nullforenriched/summary, otherwise the same value) kept for backward compatibility, usedetailStatus.
Search provenance
Each listing includes keyword, page, position, and scrapedAt (UTC). Page and position refer to the original search response, before duplicate removal. searchContext.window distinguishes the primary search from additional price-band searches; sortBy, priceMin, and priceMax describe that window. A null price bound is open-ended. Positions from different windows are not a single global ranking. The timestamp records search-page retrieval, not the listing's publication time.
Existing regionAttributes.regionApprox: true marks seller-based fallback data; its sourceItemId identifies the other listing. Likewise, condition.stuffStatusApprox and condition.stuffStatusSourceItemId identify a legacy fallback condition code. These values remain for compatibility and should not be treated as verified attributes of the current item. Use itemRecord for the current item’s published posting attributes.
Extended posting data
With detailLevel: "full" (default) and includeItemRecord: true (opt-in for API and saved tasks), province, district, conditionText, conditionLevel, imageCount and posting retain available posting details. posting gains missing details without replacing its existing populated values. itemRecord contains the additional source’s title/description, city, creation and modification times, named properties, category labels, variants, quantity and readable flags. sourceItemRecord and sourceDetailPage identify successful enrichment sources. The gallery combines available images while preserving its existing order. Existing city, quantity, freeShipping, condition and posting values retain precedence; the complete additional record is available separately as itemRecord, so differing source values are retained without replacing established columns. China-local posting times retain their +08:00 offset. Posting type, trade type, status and grade codes have readable companion labels. conditionText uses the source’s descriptive condition (also retained in condition.label). A source grade such as 9 is kept as conditionLevel: 9; “Source condition grade 9” is a fallback only when descriptive text is unavailable, not a normalized quality score. Category and division IDs accompany their names. posting.attributes retains source-defined posting attributes: documented shipping/bargain flags also have readable boolean fields; unknown attribute keys and values remain source-defined rather than being guessed.
Output Example
One complete listing from a full-mode iphone run, captured on 14 October 2026 with includeItemRecord: true. This is one real record; conditional field families described above appear on other listing types.
Advanced Usage
Price-drop hunting
Surfaces listings whose sellers have recently cut the price — strongest resale signal on Goofish.
Personal sellers only, brand new
Excludes shops and shows only brand-new items from individual sellers.
Multi-city comparison
Scopes to Beijing 北京 + Shanghai 上海 + Guangzhou 广州 in one run.
Xianyu-inspected phones
Only phones that went through Xianyu's 严选 inspection, sorted by seller credit score.
Compare with authenticated resale prices
Goofish shows what individual sellers ask. For branded sneakers and streetwear, Dewu POIZON Scraper returns the price on Dewu (得物), China's marketplace for authenticated sneakers and streetwear: live lowest and highest ask in CNY, every size and buyer reviews.
Pricing — Pay Per Event (PPE)
$7.99 per 1,000 listings on Apify Free, plus the automatic dataset charge of $0.01 per 1,000 rows and an actor-start charge of $0.005 per GB of run memory (minimum one GB billed). Full and summary modes use the same listing event; extended item data adds no separate listing event. Apify plan discounts apply automatically:
| Plan | Per 1,000 listings |
|---|---|
| Free | $7.99 |
| Starter | $6.99 |
| Scale | $6.49 |
| Business and above | $5.99 |
Free-plan access is limited to 20 lifetime runs and 30 listings per run. These are usage caps, not free listings; normal event charges apply. At 1 GB of memory, 20 listings cost about $0.165, and 1,000 cost $8.005, before plan discounts.
Cost Optimization
- Set
maxItemsto only what you need — each listing is billed - Combine
priceMin/priceMax+quickFiltersto narrow before scraping - Use
publishedWithinDaysfor the site’s posting-window filter; addverifiedRecentOnly: trueto reject records with an older known publication time
FAQ
How many results per keyword?
Goofish shows about 1,500 results for a single search. Ask for more with maxItems and the Actor searches the keyword across separate price ranges to reach listings that first set leaves out — on a broad keyword, several times more. How much more depends on the keyword: a narrow one (a specific part number) may only have a few hundred listings in total, and then you simply get all of them.
Will I get newer listings this way?
Yes, and this is the part most people miss. The first 1,500 results are not strictly newest-first — they mix fresh and old. Measured on a busy keyword, going deeper returned more listings under 24 hours old than the first set contained. If you monitor a keyword for new listings, a higher maxItems finds more of them.
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 requests current search results. Listings can change or disappear during a run; scrapedAt records when their search page was fetched.
How do I make large runs faster?
Set detailLevel: "summary". It returns the core listing fields (id, title, price, link, post time, location, seller, thumbnail) without opening each listing's detail page and reduces enrichment work. Keep the default full when you need descriptions, every image, or seller profiles and stats.
This matters most at high maxItems. Finding several thousand listings is quick; opening every one of them in full mode is what takes the time. For large sweeps, many people run summary first and then enrich only the listings they care about with the Detail actor.
My scheduled run sometimes returns fewer results than usual.
Goofish occasionally limits automated access for short windows. The actor retries transient failures automatically within bounded limits. If recovery is exhausted, it preserves collected rows and reports incomplete work. Run coverage distinguishes failed searches from valid empty searches and shows posting details that failed or were skipped. A run where every attempted search fails is marked failed. A run approaching its time limit stops collecting and preserves completed output. Individual enrichment errors retain available fields and set enrichmentIncomplete when appropriate. If counts still look low for a recency-filtered keyword, widen publishedWithinDays to 3 or 7, or check whether that keyword simply has fewer fresh listings right now.
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? 20 lifetime runs, 30 listings per run. Plenty to evaluate whether the output fits your workflow.
Are seller GPS coordinates included?
Yes. When the listing carries location data, the gps field includes exact lat / lng coordinates (plus a gpsRaw string), passed through at full precision.
Does it scrape sold / offline listings?
Search returns the listings currently exposed by Goofish. A listing can become sold or offline during enrichment; status / statusLabel and detailStatus report available source information. This is not an archive of all sold items.
Can I use Goofish search URLs instead of keywords?
Yes. Paste them into searchUrls. URLs may contain different terms; the run shares Max items and returns each listing once. Goofish URLs 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.
More Zen Studio scrapers for Chinese platforms
🛒 E-commerce
TikTok Shop
Lazada
Naver Search 네이버 검색
AliExpress 全球速卖通
Shopee
- Goofish 闲鱼
- Dewu 得物
Taobao 淘宝
JD.com 京东
1688 阿里巴巴
Weidian 微店
Coupang 쿠팡
Naver Shopping 네이버쇼핑
🎬 Short-video & social
Douban 豆瓣
Zhihu 知乎
Weibo 微博
Kwai (Brazil)
Kuaishou 快手
Douyin 抖音
RedNote 小红书
Xigua 西瓜视频
Bilibili 哔哩哔哩
Naver Blog & Cafe 네이버 블로그·카페
🏠 Real estate & autos
Naver 부동산
Anjuke 安居客
58.com 58同城
Autohome 汽车之家
✈️ Travel & stays
Ctrip 携程
🧭 Travel & maps
Mafengwo 马蜂窝
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.
