# Goofish Scraper 闲鱼 Xianyu (Idlefish) - Listings + Sellers (`zen-studio/goofish-xianyu-search-scraper`) Actor Extract Goofish 闲鱼 (Xianyu/Idlefish) listings by keyword. 150+ output fields per result: price, Zhima credit, specs, images, shipping, category labels, service guarantees, C2C posting metadata, and seller profile details. Up to 1,500 results per keyword. Chinese or English search terms. JSON output. - **URL**: https://apify.com/zen-studio/goofish-xianyu-search-scraper.md - **Developed by:** [Zen Studio](https://apify.com/zen-studio) (community) - **Categories:** E-commerce, Lead generation, Automation - **Stats:** 14 total users, 3 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $7.99 / 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Goofish Scraper (闲鱼 / Xianyu / Idlefish) | Search Listings + Sellers ![Goofish Scraper](https://iili.io/Bg8cR5b.png)
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 ```json { "keyword": "iPhone 15", "maxItems": 20 } ```` #### Chinese keyword with filters ```json { "keyword": "手机", "maxItems": 50, "sortBy": "newest", "priceMin": 1000, "priceMax": 5000, "publishedWithinDays": "7", "quickFilters": [ "filterPersonal", "filterFreePostage" ] } ``` #### Region-targeted search (Guangzhou 广州) ```json { "keyword": "乐高", "maxItems": 100, "regionIds": [ "440100" ], "sortBy": "priceDrop" } ``` #### Paste a Goofish search URL instead ```json { "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. ```json { "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 ```json { "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 ```json { "keyword": "Nintendo Switch OLED", "quickFilters": [ "filterPersonal", "filterNew" ], "maxItems": 50 } ``` Excludes shops and shows only brand-new items from individual sellers. #### Multi-city comparison ```json { "keyword": "MacBook Pro M3", "regionIds": [ "110100", "310100", "440100" ], "maxItems": 200 } ``` Scopes to Beijing 北京 + Shanghai 上海 + Guangzhou 广州 in one run. #### Xianyu-inspected phones ```json { "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](https://apify.com/zen-studio/goofish-xianyu-item-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.* # Actor input Schema ## `keyword` (type: `string`): Search term used by Goofish (闲鱼) search. Accepts Chinese or English.

Examples: iPhone 15 Pro, 手机 (phone), Nintendo Switch, 乐高 (Lego).

⚠️ Precedence: if Search URLs below is filled, this keyword field is ignored — the keyword is extracted from the URLs instead. ## `searchUrls` (type: `array`): Paste one or more Goofish (闲鱼) search URLs.

Supported: https://www.goofish.com/search?q=\

⚠️ Precedence: when this field is non-empty, it overrides the Keyword field above — the keyword is extracted from the URLs.

All URLs in a run must share the same keyword. Item URLs (/item?id=...) are not supported here — use the Goofish Detail Scraper for known item URLs or IDs. ## `maxItems` (type: `integer`): How many listings to return per run. Goofish 闲鱼 hard-caps each keyword at 1,500 fresh results.

Start with a small number (e.g. 20) to preview the output shape before committing budget. ## `regionIds` (type: `array`): Restrict results to specific Chinese administrative regions. Pick a province for broad coverage (e.g. Guangdong 广东) or a specific city for tighter scope (e.g. Shenzhen 深圳). Select multiple to stack as OR.

Leave empty to search nationwide. ## `sortBy` (type: `string`): How Goofish should order the returned listings before the Max items cap applies. ## `priceMin` (type: `integer`): Include only listings priced at or above this amount, in Chinese yuan (¥).

Leave blank for no lower bound. ## `priceMax` (type: `integer`): Include only listings priced at or below this amount, in Chinese yuan (¥).

Leave blank for no upper bound. ## `publishedWithinDays` (type: `string`): Restrict to listings posted within this rolling window. Uses Goofish 闲鱼's own posting timestamp. ## `quickFilters` (type: `array`): Goofish 闲鱼's one-click filters. Select multiple to stack them.

• 个人闲置 Personal sellers only — excludes shops/stores
• 验货宝 Inspection verified — items checked by Xianyu
• 包邮 Free shipping — no postage charge
• 全新 Brand new — never used
• 严选 Xianyu-inspected phone — phones verified by Xianyu ## Actor input object example ```json { "keyword": "iphone", "maxItems": 20, "sortBy": "newest", "publishedWithinDays": "" } ``` # Actor output Schema ## `listings` (type: `string`): All scraped Goofish listings with full item + seller detail. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keyword": "iphone", "maxItems": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("zen-studio/goofish-xianyu-search-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keyword": "iphone", "maxItems": 20, } # Run the Actor and wait for it to finish run = client.actor("zen-studio/goofish-xianyu-search-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keyword": "iphone", "maxItems": 20 }' | apify call zen-studio/goofish-xianyu-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=zen-studio/goofish-xianyu-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Goofish Scraper 闲鱼 Xianyu (Idlefish) - Listings + Sellers", "description": "Extract Goofish 闲鱼 (Xianyu/Idlefish) listings by keyword. 150+ output fields per result: price, Zhima credit, specs, images, shipping, category labels, service guarantees, C2C posting metadata, and seller profile details. Up to 1,500 results per keyword. Chinese or English search terms. JSON output.", "version": "0.0", "x-build-id": "DGnh2aSlR3xDgC83p" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zen-studio~goofish-xianyu-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zen-studio-goofish-xianyu-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/zen-studio~goofish-xianyu-search-scraper/runs": { "post": { "operationId": "runs-sync-zen-studio-goofish-xianyu-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/zen-studio~goofish-xianyu-search-scraper/run-sync": { "post": { "operationId": "run-sync-zen-studio-goofish-xianyu-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "keyword": { "title": "🔎 Keyword / 关键词 (ignored if Search URLs below are set)", "type": "string", "description": "Search term used by Goofish (闲鱼) search. Accepts Chinese or English.

Examples: iPhone 15 Pro, 手机 (phone), Nintendo Switch, 乐高 (Lego).

⚠️ Precedence: if Search URLs below is filled, this keyword field is ignored — the keyword is extracted from the URLs instead." }, "searchUrls": { "title": "Search URLs / 搜索链接 (overrides the Keyword field above)", "type": "array", "description": "Paste one or more Goofish (闲鱼) search URLs.

Supported: https://www.goofish.com/search?q=<keyword>

⚠️ Precedence: when this field is non-empty, it overrides the Keyword field above — the keyword is extracted from the URLs.

All URLs in a run must share the same keyword. Item URLs (/item?id=...) are not supported here — use the Goofish Detail Scraper for known item URLs or IDs.", "items": { "type": "string" } }, "maxItems": { "title": "Max items / 最大数量", "minimum": 1, "maximum": 1500, "type": "integer", "description": "How many listings to return per run. Goofish 闲鱼 hard-caps each keyword at 1,500 fresh results.

Start with a small number (e.g. 20) to preview the output shape before committing budget.", "default": 100 }, "regionIds": { "title": "Region / 地区", "type": "array", "description": "Restrict results to specific Chinese administrative regions. Pick a province for broad coverage (e.g. Guangdong 广东) or a specific city for tighter scope (e.g. Shenzhen 深圳). Select multiple to stack as OR.

Leave empty to search nationwide.", "items": { "type": "string", "enum": [ "110000", "110100", "120000", "120100", "130000", "130100", "130200", "130300", "130400", "130500", "130600", "130700", "130800", "130900", "131000", "131100", "140000", "140100", "140200", "140300", "140400", "140500", "140600", "140700", "140800", "140900", "141000", "141100", "150000", "150100", "150200", "150300", "150400", "150500", "150600", "150700", "150800", "150900", "152200", "152500", "152900", "210000", "210100", "210200", "210300", "210400", "210500", "210600", "210700", "210800", "210900", "211000", "211100", "211200", "211300", "211400", "220000", "220100", "220200", "220300", "220400", "220500", "220600", "220700", "220800", "222400", "230000", "230100", "230200", "230300", "230400", "230500", "230600", "230700", "230800", "230900", "231000", "231100", "231200", "232700", "310000", "310100", "320000", "320100", "320200", "320300", "320400", "320500", "320600", "320700", "320800", "320900", "321000", "321100", "321200", "321300", "330000", "330100", "330200", "330300", "330400", "330500", "330600", "330700", "330800", "330900", "331000", "331100", "340000", "340100", "340200", "340300", "340400", "340500", "340600", "340700", "340800", "341000", "341100", "341200", "341300", "341500", "341600", "341700", "341800", "350000", "350100", "350200", "350300", "350400", "350500", "350600", "350700", "350800", "350900", "360000", "360100", "360200", "360300", "360400", "360500", "360600", "360700", "360800", "360900", "361000", "361100", "370000", "370100", "370200", "370300", "370400", "370500", "370600", "370700", "370800", "370900", "371000", "371100", "371300", "371400", "371500", "371600", "371700", "410000", "410100", "410200", "410300", "410400", "410500", "410600", "410700", "410800", "410900", "411000", "411100", "411200", "411300", "411400", "411500", "411600", "411700", "419001", "420000", "420100", "420200", "420300", "420500", "420600", "420700", "420800", "420900", "421000", "421100", "421200", "421300", "422800", "429004", "429005", "429006", "429021", "430000", "430100", "430200", "430300", "430400", "430500", "430600", "430700", "430800", "430900", "431000", "431100", "431200", "431300", "433100", "440000", "440100", "440200", "440300", "440400", "440500", "440600", "440700", "440800", "440900", "441200", "441300", "441400", "441500", "441600", "441700", "441800", "441900", "442000", "445100", "445200", "445300", "450000", "450100", "450200", "450300", "450400", "450500", "450600", "450700", "450800", "450900", "451000", "451100", "451200", "451300", "451400", "460000", "460100", "460200", "460300", "460400", "469001", "469002", "469005", "469006", "469007", "469021", "469022", "469023", "469024", "469025", "469026", "469027", "469028", "469029", "469030", "500000", "500100", "510000", "510100", "510300", "510400", "510500", "510600", "510700", "510800", "510900", "511000", "511100", "511300", "511400", "511500", "511600", "511700", "511800", "511900", "512000", "513200", "513300", "513400", "520000", "520100", "520200", "520300", "520400", "520500", "520600", "522300", "522600", "522700", "530000", "530100", "530300", "530400", "530500", "530600", "530700", "530800", "530900", "532300", "532500", "532600", "532800", "532900", "533100", "533300", "533400", "540000", "540100", "540200", "540300", "540400", "540500", "540600", "542500", "610000", "610100", "610200", "610300", "610400", "610500", "610600", "610700", "610800", "610900", "611000", "620000", "620100", "620200", "620300", "620400", "620500", "620600", "620700", "620800", "620900", "621000", "621100", "621200", "622900", "623000", "630000", "630100", "630200", "632200", "632300", "632500", "632600", "632700", "632800", "640000", "640100", "640200", "640300", "640400", "640500", "650000", "650100", "650200", "650400", "650500", "652300", "652700", "652800", "652900", "653000", "653100", "653200", "654000", "654200", "654300", "659001", "659002", "659003", "659004", "659005", "659006", "659007", "659008", "659009", "659010", "659011", "710000", "710100", "710200", "710300", "710400", "710500", "710600", "710700", "710800", "710900", "711100", "711200", "711300", "711400", "711500", "711700", "711900", "712100", "712400", "712500", "712600", "712700", "712800", "810000", "810100", "820000", "820100" ], "enumTitles": [ "北京 Beijing (Province)", "北京 Beijing · City", "天津 Tianjin (Province)", "天津 Tianjin · City", "河北 Hebei (Province)", "石家庄 · 河北 Hebei", "唐山 · 河北 Hebei", "秦皇岛 · 河北 Hebei", "邯郸 · 河北 Hebei", "邢台 · 河北 Hebei", "保定 · 河北 Hebei", "张家口 · 河北 Hebei", "承德 · 河北 Hebei", "沧州 · 河北 Hebei", "廊坊 · 河北 Hebei", "衡水 · 河北 Hebei", "山西 Shanxi (Province)", "太原 · 山西 Shanxi", "大同 · 山西 Shanxi", "阳泉 · 山西 Shanxi", "长治 · 山西 Shanxi", "晋城 · 山西 Shanxi", "朔州 · 山西 Shanxi", "晋中 · 山西 Shanxi", "运城 · 山西 Shanxi", "忻州 · 山西 Shanxi", "临汾 · 山西 Shanxi", "吕梁 · 山西 Shanxi", "内蒙古 Inner Mongolia (Province)", "呼和浩特 · 内蒙古 Inner Mongolia", "包头 · 内蒙古 Inner Mongolia", "乌海 · 内蒙古 Inner Mongolia", "赤峰 · 内蒙古 Inner Mongolia", "通辽 · 内蒙古 Inner Mongolia", "鄂尔多斯 · 内蒙古 Inner Mongolia", "呼伦贝尔 · 内蒙古 Inner Mongolia", "巴彦淖尔 · 内蒙古 Inner Mongolia", "乌兰察布 · 内蒙古 Inner Mongolia", "兴安 · 内蒙古 Inner Mongolia", "锡林郭勒 · 内蒙古 Inner Mongolia", "阿拉善 · 内蒙古 Inner Mongolia", "辽宁 Liaoning (Province)", "沈阳 · 辽宁 Liaoning", "大连 · 辽宁 Liaoning", "鞍山 · 辽宁 Liaoning", "抚顺 · 辽宁 Liaoning", "本溪 · 辽宁 Liaoning", "丹东 · 辽宁 Liaoning", "锦州 · 辽宁 Liaoning", "营口 · 辽宁 Liaoning", "阜新 · 辽宁 Liaoning", "辽阳 · 辽宁 Liaoning", "盘锦 · 辽宁 Liaoning", "铁岭 · 辽宁 Liaoning", "朝阳 · 辽宁 Liaoning", "葫芦岛 · 辽宁 Liaoning", "吉林 Jilin (Province)", "长春 · 吉林 Jilin", "吉林 Jilin · City", "四平 · 吉林 Jilin", "辽源 · 吉林 Jilin", "通化 · 吉林 Jilin", "白山 · 吉林 Jilin", "松原 · 吉林 Jilin", "白城 · 吉林 Jilin", "延边朝鲜族 · 吉林 Jilin", "黑龙江 Heilongjiang (Province)", "哈尔滨 · 黑龙江 Heilongjiang", "齐齐哈尔 · 黑龙江 Heilongjiang", "鸡西 · 黑龙江 Heilongjiang", "鹤岗 · 黑龙江 Heilongjiang", "双鸭山 · 黑龙江 Heilongjiang", "大庆 · 黑龙江 Heilongjiang", "伊春 · 黑龙江 Heilongjiang", "佳木斯 · 黑龙江 Heilongjiang", "七台河 · 黑龙江 Heilongjiang", "牡丹江 · 黑龙江 Heilongjiang", "黑河 · 黑龙江 Heilongjiang", "绥化 · 黑龙江 Heilongjiang", "大兴安岭 · 黑龙江 Heilongjiang", "上海 Shanghai (Province)", "上海 Shanghai · City", "江苏 Jiangsu (Province)", "南京 · 江苏 Jiangsu", "无锡 · 江苏 Jiangsu", "徐州 · 江苏 Jiangsu", "常州 · 江苏 Jiangsu", "苏州 · 江苏 Jiangsu", "南通 · 江苏 Jiangsu", "连云港 · 江苏 Jiangsu", "淮安 · 江苏 Jiangsu", "盐城 · 江苏 Jiangsu", "扬州 · 江苏 Jiangsu", "镇江 · 江苏 Jiangsu", "泰州 · 江苏 Jiangsu", "宿迁 · 江苏 Jiangsu", "浙江 Zhejiang (Province)", "杭州 · 浙江 Zhejiang", "宁波 · 浙江 Zhejiang", "温州 · 浙江 Zhejiang", "嘉兴 · 浙江 Zhejiang", "湖州 · 浙江 Zhejiang", "绍兴 · 浙江 Zhejiang", "金华 · 浙江 Zhejiang", "衢州 · 浙江 Zhejiang", "舟山 · 浙江 Zhejiang", "台州 · 浙江 Zhejiang", "丽水 · 浙江 Zhejiang", "安徽 Anhui (Province)", "合肥 · 安徽 Anhui", "芜湖 · 安徽 Anhui", "蚌埠 · 安徽 Anhui", "淮南 · 安徽 Anhui", "马鞍山 · 安徽 Anhui", "淮北 · 安徽 Anhui", "铜陵 · 安徽 Anhui", "安庆 · 安徽 Anhui", "黄山 · 安徽 Anhui", "滁州 · 安徽 Anhui", "阜阳 · 安徽 Anhui", "宿州 · 安徽 Anhui", "六安 · 安徽 Anhui", "亳州 · 安徽 Anhui", "池州 · 安徽 Anhui", "宣城 · 安徽 Anhui", "福建 Fujian (Province)", "福州 · 福建 Fujian", "厦门 · 福建 Fujian", "莆田 · 福建 Fujian", "三明 · 福建 Fujian", "泉州 · 福建 Fujian", "漳州 · 福建 Fujian", "南平 · 福建 Fujian", "龙岩 · 福建 Fujian", "宁德 · 福建 Fujian", "江西 Jiangxi (Province)", "南昌 · 江西 Jiangxi", "景德镇 · 江西 Jiangxi", "萍乡 · 江西 Jiangxi", "九江 · 江西 Jiangxi", "新余 · 江西 Jiangxi", "鹰潭 · 江西 Jiangxi", "赣州 · 江西 Jiangxi", "吉安 · 江西 Jiangxi", "宜春 · 江西 Jiangxi", "抚州 · 江西 Jiangxi", "上饶 · 江西 Jiangxi", "山东 Shandong (Province)", "济南 · 山东 Shandong", "青岛 · 山东 Shandong", "淄博 · 山东 Shandong", "枣庄 · 山东 Shandong", "东营 · 山东 Shandong", "烟台 · 山东 Shandong", "潍坊 · 山东 Shandong", "济宁 · 山东 Shandong", "泰安 · 山东 Shandong", "威海 · 山东 Shandong", "日照 · 山东 Shandong", "临沂 · 山东 Shandong", "德州 · 山东 Shandong", "聊城 · 山东 Shandong", "滨州 · 山东 Shandong", "菏泽 · 山东 Shandong", "河南 Henan (Province)", "郑州 · 河南 Henan", "开封 · 河南 Henan", "洛阳 · 河南 Henan", "平顶山 · 河南 Henan", "安阳 · 河南 Henan", "鹤壁 · 河南 Henan", "新乡 · 河南 Henan", "焦作 · 河南 Henan", "濮阳 · 河南 Henan", "许昌 · 河南 Henan", "漯河 · 河南 Henan", "三门峡 · 河南 Henan", "南阳 · 河南 Henan", "商丘 · 河南 Henan", "信阳 · 河南 Henan", "周口 · 河南 Henan", "驻马店 · 河南 Henan", "济源 · 河南 Henan", "湖北 Hubei (Province)", "武汉 · 湖北 Hubei", "黄石 · 湖北 Hubei", "十堰 · 湖北 Hubei", "宜昌 · 湖北 Hubei", "襄阳 · 湖北 Hubei", "鄂州 · 湖北 Hubei", "荆门 · 湖北 Hubei", "孝感 · 湖北 Hubei", "荆州 · 湖北 Hubei", "黄冈 · 湖北 Hubei", "咸宁 · 湖北 Hubei", "随州 · 湖北 Hubei", "恩施 · 湖北 Hubei", "仙桃 · 湖北 Hubei", "潜江 · 湖北 Hubei", "天门 · 湖北 Hubei", "神农架 · 湖北 Hubei", "湖南 Hunan (Province)", "长沙 · 湖南 Hunan", "株洲 · 湖南 Hunan", "湘潭 · 湖南 Hunan", "衡阳 · 湖南 Hunan", "邵阳 · 湖南 Hunan", "岳阳 · 湖南 Hunan", "常德 · 湖南 Hunan", "张家界 · 湖南 Hunan", "益阳 · 湖南 Hunan", "郴州 · 湖南 Hunan", "永州 · 湖南 Hunan", "怀化 · 湖南 Hunan", "娄底 · 湖南 Hunan", "湘西 · 湖南 Hunan", "广东 Guangdong (Province)", "广州 · 广东 Guangdong", "韶关 · 广东 Guangdong", "深圳 · 广东 Guangdong", "珠海 · 广东 Guangdong", "汕头 · 广东 Guangdong", "佛山 · 广东 Guangdong", "江门 · 广东 Guangdong", "湛江 · 广东 Guangdong", "茂名 · 广东 Guangdong", "肇庆 · 广东 Guangdong", "惠州 · 广东 Guangdong", "梅州 · 广东 Guangdong", "汕尾 · 广东 Guangdong", "河源 · 广东 Guangdong", "阳江 · 广东 Guangdong", "清远 · 广东 Guangdong", "东莞 · 广东 Guangdong", "中山 · 广东 Guangdong", "潮州 · 广东 Guangdong", "揭阳 · 广东 Guangdong", "云浮 · 广东 Guangdong", "广西 Guangxi (Province)", "南宁 · 广西 Guangxi", "柳州 · 广西 Guangxi", "桂林 · 广西 Guangxi", "梧州 · 广西 Guangxi", "北海 · 广西 Guangxi", "防城港 · 广西 Guangxi", "钦州 · 广西 Guangxi", "贵港 · 广西 Guangxi", "玉林 · 广西 Guangxi", "百色 · 广西 Guangxi", "贺州 · 广西 Guangxi", "河池 · 广西 Guangxi", "来宾 · 广西 Guangxi", "崇左 · 广西 Guangxi", "海南 Hainan (Province)", "海口 · 海南 Hainan", "三亚 · 海南 Hainan", "三沙 · 海南 Hainan", "儋州 · 海南 Hainan", "五指山 · 海南 Hainan", "琼海 · 海南 Hainan", "文昌 · 海南 Hainan", "万宁 · 海南 Hainan", "东方 · 海南 Hainan", "定安 · 海南 Hainan", "屯昌 · 海南 Hainan", "澄迈 · 海南 Hainan", "临高 · 海南 Hainan", "白沙 · 海南 Hainan", "昌江 · 海南 Hainan", "乐东 · 海南 Hainan", "陵水 · 海南 Hainan", "保亭 · 海南 Hainan", "琼中 · 海南 Hainan", "重庆 Chongqing (Province)", "重庆 Chongqing · City", "四川 Sichuan (Province)", "成都 · 四川 Sichuan", "自贡 · 四川 Sichuan", "攀枝花 · 四川 Sichuan", "泸州 · 四川 Sichuan", "德阳 · 四川 Sichuan", "绵阳 · 四川 Sichuan", "广元 · 四川 Sichuan", "遂宁 · 四川 Sichuan", "内江 · 四川 Sichuan", "乐山 · 四川 Sichuan", "南充 · 四川 Sichuan", "眉山 · 四川 Sichuan", "宜宾 · 四川 Sichuan", "广安 · 四川 Sichuan", "达州 · 四川 Sichuan", "雅安 · 四川 Sichuan", "巴中 · 四川 Sichuan", "资阳 · 四川 Sichuan", "阿坝 · 四川 Sichuan", "甘孜 · 四川 Sichuan", "凉山 · 四川 Sichuan", "贵州 Guizhou (Province)", "贵阳 · 贵州 Guizhou", "六盘水 · 贵州 Guizhou", "遵义 · 贵州 Guizhou", "安顺 · 贵州 Guizhou", "毕节 · 贵州 Guizhou", "铜仁 · 贵州 Guizhou", "黔西南 · 贵州 Guizhou", "黔东南 · 贵州 Guizhou", "黔南 · 贵州 Guizhou", "云南 Yunnan (Province)", "昆明 · 云南 Yunnan", "曲靖 · 云南 Yunnan", "玉溪 · 云南 Yunnan", "保山 · 云南 Yunnan", "昭通 · 云南 Yunnan", "丽江 · 云南 Yunnan", "普洱 · 云南 Yunnan", "临沧 · 云南 Yunnan", "楚雄 · 云南 Yunnan", "红河 · 云南 Yunnan", "文山 · 云南 Yunnan", "西双版纳 · 云南 Yunnan", "大理 · 云南 Yunnan", "德宏 · 云南 Yunnan", "怒江 · 云南 Yunnan", "迪庆 · 云南 Yunnan", "西藏 Xizang (Tibet) (Province)", "拉萨 · 西藏 Xizang (Tibet)", "日喀则 · 西藏 Xizang (Tibet)", "昌都 · 西藏 Xizang (Tibet)", "林芝 · 西藏 Xizang (Tibet)", "山南 · 西藏 Xizang (Tibet)", "那曲 · 西藏 Xizang (Tibet)", "阿里 · 西藏 Xizang (Tibet)", "陕西 Shaanxi (Province)", "西安 · 陕西 Shaanxi", "铜川 · 陕西 Shaanxi", "宝鸡 · 陕西 Shaanxi", "咸阳 · 陕西 Shaanxi", "渭南 · 陕西 Shaanxi", "延安 · 陕西 Shaanxi", "汉中 · 陕西 Shaanxi", "榆林 · 陕西 Shaanxi", "安康 · 陕西 Shaanxi", "商洛 · 陕西 Shaanxi", "甘肃 Gansu (Province)", "兰州 · 甘肃 Gansu", "嘉峪关 · 甘肃 Gansu", "金昌 · 甘肃 Gansu", "白银 · 甘肃 Gansu", "天水 · 甘肃 Gansu", "武威 · 甘肃 Gansu", "张掖 · 甘肃 Gansu", "平凉 · 甘肃 Gansu", "酒泉 · 甘肃 Gansu", "庆阳 · 甘肃 Gansu", "定西 · 甘肃 Gansu", "陇南 · 甘肃 Gansu", "临夏 · 甘肃 Gansu", "甘南 · 甘肃 Gansu", "青海 Qinghai (Province)", "西宁 · 青海 Qinghai", "海东 · 青海 Qinghai", "海北 · 青海 Qinghai", "黄南 · 青海 Qinghai", "海南藏族 · 青海 Qinghai", "果洛 · 青海 Qinghai", "玉树 · 青海 Qinghai", "海西 · 青海 Qinghai", "宁夏 Ningxia (Province)", "银川 · 宁夏 Ningxia", "石嘴山 · 宁夏 Ningxia", "吴忠 · 宁夏 Ningxia", "固原 · 宁夏 Ningxia", "中卫 · 宁夏 Ningxia", "新疆 Xinjiang (Province)", "乌鲁木齐 · 新疆 Xinjiang", "克拉玛依 · 新疆 Xinjiang", "吐鲁番 · 新疆 Xinjiang", "哈密 · 新疆 Xinjiang", "昌吉 · 新疆 Xinjiang", "博尔塔拉 · 新疆 Xinjiang", "巴音郭楞 · 新疆 Xinjiang", "阿克苏 · 新疆 Xinjiang", "克孜勒苏柯尔克孜 · 新疆 Xinjiang", "喀什 · 新疆 Xinjiang", "和田 · 新疆 Xinjiang", "伊犁 · 新疆 Xinjiang", "塔城 · 新疆 Xinjiang", "阿勒泰 · 新疆 Xinjiang", "石河子 · 新疆 Xinjiang", "阿拉尔 · 新疆 Xinjiang", "图木舒克 · 新疆 Xinjiang", "五家渠 · 新疆 Xinjiang", "北屯 · 新疆 Xinjiang", "铁门关 · 新疆 Xinjiang", "双河 · 新疆 Xinjiang", "可克达拉 · 新疆 Xinjiang", "昆玉 · 新疆 Xinjiang", "胡杨河 · 新疆 Xinjiang", "新星 · 新疆 Xinjiang", "台湾 Taiwan (Province)", "台北 · 台湾 Taiwan", "高雄 · 台湾 Taiwan", "台南 · 台湾 Taiwan", "台中 · 台湾 Taiwan", "金门 · 台湾 Taiwan", "南投 · 台湾 Taiwan", "基隆 · 台湾 Taiwan", "新竹 · 台湾 Taiwan", "嘉义 · 台湾 Taiwan", "新北 · 台湾 Taiwan", "宜兰 · 台湾 Taiwan", "新竹 · 台湾 Taiwan", "桃园 · 台湾 Taiwan", "苗栗 · 台湾 Taiwan", "彰化 · 台湾 Taiwan", "嘉义 · 台湾 Taiwan", "云林 · 台湾 Taiwan", "屏东 · 台湾 Taiwan", "台东 · 台湾 Taiwan", "花莲 · 台湾 Taiwan", "澎湖 · 台湾 Taiwan", "连江 · 台湾 Taiwan", "香港 Hong Kong (Province)", "香港 Hong Kong · City", "澳门 Macau (Province)", "澳门 Macau · City" ] } }, "sortBy": { "title": "Sort by / 排序方式", "enum": [ "relevance", "newest", "priceAsc", "priceDesc", "priceDrop", "modified", "credit" ], "type": "string", "description": "How Goofish should order the returned listings before the Max items cap applies.", "default": "newest" }, "priceMin": { "title": "Min price / 最低价格 (CNY ¥)", "minimum": 0, "type": "integer", "description": "Include only listings priced at or above this amount, in Chinese yuan (¥).

Leave blank for no lower bound." }, "priceMax": { "title": "Max price / 最高价格 (CNY ¥)", "minimum": 0, "type": "integer", "description": "Include only listings priced at or below this amount, in Chinese yuan (¥).

Leave blank for no upper bound." }, "publishedWithinDays": { "title": "Published within / 发布时间", "enum": [ "", "1", "3", "7", "14" ], "type": "string", "description": "Restrict to listings posted within this rolling window. Uses Goofish 闲鱼's own posting timestamp.", "default": "" }, "quickFilters": { "title": "Quick filters / 快速筛选", "type": "array", "description": "Goofish 闲鱼's one-click filters. Select multiple to stack them.

• 个人闲置 Personal sellers only — excludes shops/stores
• 验货宝 Inspection verified — items checked by Xianyu
• 包邮 Free shipping — no postage charge
• 全新 Brand new — never used
• 严选 Xianyu-inspected phone — phones verified by Xianyu", "items": { "type": "string", "enum": [ "filterPersonal", "filterAppraise", "gameAccountInsurance", "filterFreePostage", "filterHighLevelYxpSeller", "filterNew", "inspectedPhone", "filterOneKeyResell" ], "enumTitles": [ "个人闲置 (Personal sellers only)", "验货宝 (Inspection verified)", "验号担保 (Game account guarantee)", "包邮 (Free shipping)", "超赞鱼小铺 (Top shop)", "全新 (Brand new)", "严选 (Xianyu-inspected phone)", "转卖 (One-click resell)" ] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```