Goofish Xianyu Search Scraper

Export public Goofish (闲鱼 / Xianyu) marketplace search results to JSON, CSV, Excel, or your preferred integration. Search in Chinese or English and collect listing titles, prices, public seller summaries, locations, images, labels, and interest counts when available.

This Goofish Xianyu search scraper returns search-card data, not full item descriptions or seller profiles. Availability depends on the source. A result limit is a maximum, not a promise of that many listings.

Quick start

Start with the small input below, run the Actor and inspect its results.

{
  "keywords": [
    "iPhone 15",
    "自行车"
  ],
  "maxItems": 20
}

Prefer a video guide? This short Apify walkthrough shows you how to set up and run an Actor. It uses a different Actor, but the setup steps are the same.

Ready-to-run examples

Choose a public example to see its settings before starting a run:

• Collect Goofish Camera Listings
• Compare Chinese Goofish Marketplace Keywords
• Search iPhone Listings on Goofish Xianyu

What you get

• Public listing cards with prices, seller summaries, locations and visible condition/specification labels. No extra item-detail requests.
• Optional keyword translation using a curated English/pinyin dictionary, with the original keyword kept in each row.
• Flexible exports with price/age filters, per-keyword limits and bounded local popularity ranking.
• Only-new monitoring for a named private watchlist. See Monitor new listings.

Field	Description
itemId	Public listing identifier
url	Public listing URL
keyword	Original user search term that produced the row
searchedAs	Actual source query when opt-in translation is enabled
conditionLabel, condition	Source condition label and conservative readable translation when recognized
specs, sellerBadges	Visible brand/specification/repair labels and seller badges, without extra detail requests
priceDropCny	Exact displayed CNY price drop, or difference between exact source original/current prices
priceDropPercent	Displayed percentage drop. Never converted into a guessed CNY amount
page	Search result page number
position	Listing position within the result page
title	Listing title
price	Numeric asking price in CNY, with Chinese number units expanded. 0 is used when the price cannot be read
priceAvailable	Whether the price was successfully read. A genuine zero price has this set to true
priceText	Original displayed price text when available
currency	Price currency, normally CNY
area	Public location shown on the result
imageUrl	Primary listing image URL
sellerName	Public seller display name
sellerAvatarUrl	Public seller avatar URL
sellerId	Public seller identifier when available
wantCount	Displayed interest count with Chinese number units expanded
wantCountText	Original interest-count text when available
wantCountIsLowerBound	Whether the source shows a lower bound, such as 999+
publishedAt	Posting time when available
categoryId	Public category identifier
categoryName	First public listing label. Not a verified category taxonomy
labels	Listing and category labels
freeShipping	Whether free shipping is advertised
isAuction	Whether the result is an auction
isVideo	Whether the result includes video
detailPageType	Public listing-page type
scrapedAt	ISO collection timestamp

Optional values are omitted when they are not present on a public search result. Boolean flags describe signals found on the search card, not independently verified item attributes.

Who is it for?

• Resale analysts comparing asking prices and availability.
• Marketplace sellers researching competing listings and regions.
• Collectors and buyers monitoring niche products or brands.
• Data teams feeding structured marketplace rows into dashboards.
• Automation builders scheduling recurring exports and alerts.
• AI developers giving agents access to current public search results.

How you can use the data

Price monitoring

Build a price history for the products you follow. Run the same keyword search on a schedule and save each export. Match listings by itemId, then compare price and scrapedAt to see how asking prices change. Your spreadsheet or workflow handles the comparison between runs. Check priceAvailable before comparing prices. A price of 0 with priceAvailable: false means the price could not be read.

Product availability research

Find listings for specific models, parts or collectibles. Try product names, brands and Chinese search terms such as 自行车 for bicycles. Review the returned titles and listing links to find relevant items. A listing disappearing from a later search does not, by itself, confirm that it has sold.

Regional marketplace analysis

Compare the listings shown in different locations. Export results for the same product and group them by area in a spreadsheet or dashboard. You can compare the number of collected listings and their asking prices. Location is included only when Goofish shows it on the search card.

Seller and category research

See how sellers describe and label similar products. Compare public seller summaries, listing titles and labels to understand how relevant items are presented. These are search-card details, not complete seller profiles. The categoryName field reflects a displayed label rather than a verified category system.

Alerts and workflows

Turn recurring searches into a useful watchlist. Send each export to a spreadsheet or your automation workflow. Your workflow can compare listing IDs with a saved export and notify you about new matches or price changes. See Automation and integrations for the setup options.

Input settings

{
  "keywords": ["iPhone 15", "自行车"],
  "maxItems": 20
}

Key	Description	Default
keywords	Search keywords: 1–50 unique non-empty Chinese or English terms. Alternatively use searchUrls	not set
searchUrls	HTTPS goofish.com/search?q= links parsed locally, no arbitrary URL fetching	not set
translateKeywords	Use 102 curated brand/category concepts via 225 English/pinyin aliases. Not general translation	false
excludeAuctions	Skip cards with a true auction flag	false
monitorMode	Only-new listings for the initiating account and named stream	false
monitorStateName	Isolated monitoring stream name, up to 100 characters	default
resetMonitoringState	Reset this account's named stream once for this run	false
emitBaseline	Return initial monitoring matches. With false, remember them without listing fees. The completed-check start fee still applies	true
maxItems	Maximum listings: 1–1,500 unique rows across all keywords	20
maxItemsPerKeyword	Optional cap of 1–1,500 saved listings for each term	not set
sort	relevance, newest, priceAsc, priceDesc, or local mostWanted (up to 3 pages / 30–90 eligible candidates per term, fewer with smaller limits or residential fallback). Not source-wide ranking	relevance
minPrice, maxPrice	Optional asking-price range in CNY	not set
publishedWithinDays	Exact posting-age limit from "1" through "14" days. "0" means any time	"0"
freeShippingOnly	Only listings with a visible free-shipping label	false
province, city, district	Optional Chinese region names. District without city is ignored with a warning	not set
resultsPerPage	Results per page: 1–30 requested listings	30
maxPagesPerKeyword	Maximum pages per keyword: 1–50 pages	20

The form and API use the same defaults. maxItems is shared across keywords. Use maxItemsPerKeyword to leave room for later terms. Duplicate terms are combined without regard to case.

With translateKeywords: true, huananzhi x99 motherboard searches as 华南金牌 x99 主板. Matching ignores case and accepts spaces or hyphens between phrase words. Chinese, unknown words, embedded substrings and models such as iPhone, RTX4060, PS5 and X99 stay unchanged.

Supported keyword mappings

The complete opt-in dictionary has 102 concepts (22 brands, 80 categories), 225 literal English/pinyin aliases. Case, whitespace and hyphen variations are not extra aliases. Translation defaults to false and is curated, not general translation. For example, daier laptop searches as 戴尔 笔记本电脑, and luo ji mechanical keyboard as 罗技 机械键盘. Every row keeps the original keyword.

The complete list is shown below as a plain Markdown table. Apify Store removes collapsible HTML together with its contents, so this list is intentionally expanded.

Chinese concept	Supported English / pinyin aliases
小米	xiaomi, xiao mi
华为	huawei, hua wei
联想	lenovo, lianxiang, lian xiang
索尼	sony, suoni, suo ni
佳能	canon, jianeng, jia neng
尼康	nikon, nikang, ni kang
乐高	lego, legao, le gao
相机	camera, xiangji, xiang ji
自行车	bicycle, zixingche, zi xing che
笔记本电脑	laptop, laptop computer, bijiben diannao
耳机	headphones, erji, er ji
华南金牌	huananzhi, huanan jinpai, hua nan jin pai
戴尔	dell, daier, dai er
外星人	alienware, waixingren, wai xing ren
三星	samsung, sanxing, san xing
罗技	logitech, luoji, luo ji
飞利浦	philips, feilipu, fei li pu
华硕	asus, huashuo, hua shuo
微软	microsoft, weiruan, wei ruan
松下	panasonic, songxia, song xia
佳明	garmin, jiaming, jia ming
苹果	apple, pingguo, ping guo
大疆	dji, dajiang, da jiang
金士顿	kingston, jinshidun, jin shi dun
希捷	seagate, xijie, xi jie
西部数据	western digital, xibu shuju, xi bu shu ju
主板	motherboard, mainboard, zhuban, zhu ban
显卡	graphics card, video card, xianka, xian ka
内存	memory module, memory stick, neicun, nei cun
固态硬盘	solid state drive, gutai yingpan
机械硬盘	hard disk drive, mechanical hard drive
移动硬盘	external hard drive, portable hard drive
电脑电源	computer power supply, pc power supply
电脑机箱	computer case, pc case
散热器	cpu cooler, sanreqi
散热风扇	cooling fan, case fan
显示器	computer monitor, xianshiqi, xian shi qi
键盘	keyboard, jianpan, jian pan
机械键盘	mechanical keyboard
鼠标	computer mouse, shubiao, shu biao
鼠标垫	mouse pad, mouse mat
路由器	router, luyouqi, lu you qi
网卡	network card, ethernet card
打印机	printer, dayinji, da yin ji
扫描仪	document scanner
投影仪	projector, touyingyi
平板电脑	tablet computer, pingban diannao
台式电脑	desktop computer, desktop pc, taishi diannao
手机	mobile phone, smartphone, shouji, shou ji
手机壳	phone case, smartphone case
充电器	charger, chongdianqi
充电宝	power bank, chongdianbao
数据线	data cable, shujuxian
智能手表	smart watch, smartwatch
电子书阅读器	ebook reader, e book reader
数码相机	digital camera
胶片相机	film camera
单反相机	dslr camera
微单相机	mirrorless camera
运动相机	action camera
相机镜头	camera lens
三脚架	tripod, sanjiaojia
闪光灯	camera flash, shanguangdeng
相机包	camera bag
存储卡	memory card, cunchuka
读卡器	card reader, dukaqi
无人机	drone, wurenji, wu ren ji
云台	camera gimbal
蓝牙耳机	bluetooth headphones, bluetooth earbuds
音箱	loudspeaker, yinxiang, yin xiang
蓝牙音箱	bluetooth speaker
麦克风	microphone, maikefeng
功放	audio amplifier, gongfang
声卡	sound card, shengka
录音笔	voice recorder
唱片机	record player, vinyl turntable
游戏手柄	game controller, gamepad
游戏机	game console, gaming console, youxiji
山地自行车	mountain bike
公路自行车	road bike
折叠自行车	folding bike, folding bicycle
自行车车架	bicycle frame, bike frame
自行车轮组	bicycle wheelset, bike wheelset
骑行头盔	cycling helmet, bike helmet
骑行鞋	cycling shoes
帐篷	tent, zhangpeng, zhang peng
睡袋	sleeping bag, shuidai
登山包	hiking backpack
登山杖	trekking poles, hiking poles
露营桌	camping table
露营椅	camping chair
手电筒	flashlight, shoudiantong
钓鱼竿	fishing rod
登山鞋	hiking boots, hiking shoes
滑雪板	snowboard
滑板	skateboard, huaban
吉他	guitar, jita, ji ta
电吉他	electric guitar
电子琴	electronic keyboard
吸尘器	vacuum cleaner, xichenqi
咖啡机	coffee machine, coffee maker, kafeiji
空气净化器	air purifier

Ambiguous bare on, mi, go, air, pro, switch, yijia, ram, monitor, tablet and bike remain unchanged. Use listed contextual phrases or Chinese directly. Model names are not rewritten.

Monitor new listings

{"keywords":["iPhone 15"],"maxItems":20,"sort":"newest","monitorMode":true,"monitorStateName":"phones","emitBaseline":false}

• Selection: Each check visits one page of one keyword, up to 30 cards. Keywords rotate in order after successful checks only. Failed or busy checks do not advance. RUN_SUMMARY identifies the checked and next keyword.
• Baseline: With emitBaseline: false, the first check remembers its selection without returning listings. This covers one keyword/page, not the whole watchlist. Later checks return unseen IDs. With true, initial matches are returned too.
• Charges: Every successfully completed check incurs the start fee, even with zero new listings. Only newly saved listings incur item fees. Busy, no-keyword and source-failed checks do not incur the check start fee. Infrastructure costs still apply.
• Changes: A price change on the same ID is not a new listing. Use ordinary exports for price history.
• Private streams: State belongs to the initiating account and named stream. Use separate names for different watchlists. Reset only the intended stream, then turn reset off.
• Retention: Up to 10,000 IDs for 30 days. A byte limit may evict older IDs sooner. Forgotten IDs can appear as new again.
• Scheduling: No schedule is created or activated. Configure recurring runs separately if needed.

Example inputs

Quick sample

{"keywords":["iPhone 15"],"maxItems":10}

Multiple Chinese keywords

{"keywords":["露营帐篷","公路自行车"],"maxItems":100}

Compare several terms with a cap for each

{"keywords":["相机","自行车","露营帐篷"],"maxItems":30,"maxItemsPerKeyword":10}

Price-filtered search

{"keywords":["相机"],"maxItems":20,"minPrice":100,"maxPrice":1000,"sort":"priceAsc"}

Bounded pagination

{
  "keywords": ["相机"],
  "maxItems": 60,
  "resultsPerPage": 30,
  "maxPagesPerKeyword": 3
}

Output data

Illustrative shape only, not an observed listing:

{
  "itemId": "123456789",
  "url": "https://www.goofish.com/item?id=123456789",
  "keyword": "iPhone 15",
  "page": 1,
  "position": 1,
  "title": "iPhone 15 256G",
  "price": 3999,
  "priceAvailable": true,
  "priceText": "3999",
  "currency": "CNY",
  "area": "上海",
  "sellerName": "example seller",
  "wantCount": 12,
  "labels": ["Apple/苹果"],
  "freeShipping": true,
  "isAuction": false,
  "isVideo": false,
  "scrapedAt": "2026-08-07T12:00:00.000Z"
}

Download your results

Open your run's dataset, choose Export and select JSON, CSV or Excel. JSON keeps nested fields together. CSV and Excel are useful when you want to review the records in a spreadsheet.

See Apify's download and export guide for the available formats and field options.

Pricing

This Actor uses pay-per-event pricing. The start event is charged once, before saving the first valid listing. The item event is charged per saved listing.

A completed empty stateless search has no listing events or start event. Opt-in monitoring instead charges the existing start event once per successfully completed check, including empty checks and suppressed baselines. Only newly delivered rows incur listing events. Failed runs may already have saved and charged useful listings.

See the live Pricing tab for current rates and discounts.

Tips for best results

• Try specific Chinese search terms. Local product names and model names can help you find more relevant listings. English search terms are also accepted.
• Start with 10–20 listings. Keep maxItems small while trying a keyword, then inspect the results before increasing it.
• Use focused product terms. A model name or category phrase can produce more useful results than a broad keyword.
• Check collection coverage. Open Run summary and keyword coverage in the run output. The summary shows saved counts for each keyword, unvisited terms, failures and why collection stopped.

Limits and caveats

• Search-card scope: No full item descriptions, seller profiles or reviews. Optional fields appear only when shown publicly.
• Bounded coverage: Listings can change or disappear. Results are not exhaustive inventory or guaranteed lowest prices. mostWanted ranks only a bounded local pool. Empty results do not prove that Goofish has no matches.
• Unknown values: Check priceAvailable before comparing prices. Unreadable prices use 0 with false. Posting time can be missing. An age filter excludes cards without a usable timestamp. Interest counts marked with wantCountIsLowerBound are minimums.
• Partial results: Blocking or temporary failures may leave useful rows but incomplete coverage. Check RUN_SUMMARY for failures, unvisited keywords and stop reasons. A charge-cap stop reports BUDGET_LIMIT. Real source, storage and billing failures are not successful budget stops.
• Input warnings: Recoverable input mistakes are reported in logs and RUN_SUMMARY.warnings. No usable keywords ends empty without source requests or event charges. Platform schema validation may reject invalid input before a run starts.
• Duplicates: Each listing ID is saved once across keywords/pages and attributed to its first matching original keyword.

Automation and integrations

Save your settings for next time

Once you have an input that works for you, save it as an Apify task. This keeps your settings together so you can use them again without filling in the form from scratch.

Run on a schedule

Need fresh results regularly? You can schedule the Actor or a saved task to run at a time that suits you.

Each scheduled run collects the data again. If you want to compare results or highlight changes, add that step in your own workflow.

Send results to your other tools

Use n8n, Make or Zapier to connect this scraper to the rest of your workflow. For example, you could pass its results to an AI assistant or add records to a spreadsheet. Follow the Apify integration guides for your chosen tool.

For a custom connection, an Apify webhook can notify your app when a run finishes or fails. Your app can then fetch the results or handle the failure.

API usage

Want to collect this data from your own app or automation? The examples below send input to the scraper and show how to collect its results.

The Node.js and Python examples wait for the run to finish before reading its results. The cURL example starts the run and returns its details. Wait for that run to finish, then use its defaultDatasetId to fetch the results.

For setup instructions, see Apify's JavaScript client guide, Python client guide and Actor runs API reference.

cURL

curl -X POST 'https://api.apify.com/v2/acts/fetch_cat~goofish-xianyu-search-scraper/runs' \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  --data @- <<'JSON'
{
  "keywords": [
    "iPhone 15",
    "自行车"
  ],
  "maxItems": 20
}
JSON

Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('fetch_cat/goofish-xianyu-search-scraper').call({
  "keywords": [
    "iPhone 15",
    "自行车"
  ],
  "maxItems": 20
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('fetch_cat/goofish-xianyu-search-scraper').call(run_input={'keywords': ['iPhone 15', '自行车'], 'maxItems': 20})
print(client.dataset(run['defaultDatasetId']).list_items().items)

MCP and AI agents

You can ask your AI assistant to collect data with Goofish Xianyu Search Scraper and help you work with the results. The scraper returns the data, and your assistant can then summarize it, compare records or prepare notes.

Connect your assistant through the Apify MCP server. MCP gives your assistant a way to find this scraper, run it and read the results. Follow the official setup and sign-in guide for your app.

Easier setup with an Apify plugin

If you use a supported coding assistant, the official Apify plugin can set up the connection for you. It connects your assistant to Apify and includes instructions for common tasks. Follow the guide for your particular app.

Use Apify AI in Console

Prefer to keep everything in Apify? Open Apify AI in Console and ask it to find Fetch Cat's Goofish Xianyu Search Scraper. You can describe the data you want and ask questions about the results.

Apify AI is currently in beta. It asks for confirmation before starting an Actor, and normal run charges apply.

Choose your assistant

• Claude and Claude Code (Anthropic): Apify setup guide.
• ChatGPT and Codex (OpenAI): Apify setup guides.
• Grok Bot (xAI): Apify plugin guide.
• Gemini CLI (Google): MCP server setup guide. Use the server URL below with the HTTP configuration supported by Gemini CLI.

Connect just this scraper

To keep your setup focused on this scraper, add this server configuration to a compatible MCP client:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=fetch_cat/goofish-xianyu-search-scraper"
    }
  }
}

Sign in to Apify when your client asks. If your client uses a Bearer token instead, follow its setup guide and keep the token in its secure configuration. Configuration formats vary by app, so use the linked guide if your client needs a different format.

Use Apify's general server

Already connected to the general Apify MCP server at https://mcp.apify.com? You can use it to find this scraper without adding another server. Ask your assistant to use Goofish Xianyu Search Scraper by Fetch Cat, or give it the identifier fetch_cat/goofish-xianyu-search-scraper.

Your assistant can check the available settings and retrieve the results from the returned run. If the run is still working, it should follow that run rather than start it again. Both connection options use Apify's hosted service.

Example requests

Try asking your assistant for the marketplace data you need:

• “Search Goofish for up to 20 iPhone 15 listings. Put their titles, asking prices, locations and listing links in a table, and flag prices that could not be read.”
• “Find up to 10 camera listings on Goofish using the Chinese search term 相机. Show the available public seller summaries and locations alongside the listing links.”
• “Collect up to 10 bicycle listings from Goofish using 自行车, then compare them with the export I provide. Match the listings by their identifiers and flag missing or unreadable prices.”

Normal Apify charges apply. Check the live Pricing tab before asking your assistant to run a larger batch.

Pay with x402

If your AI agent has a funded wallet, it can pay for Apify usage through x402. This experimental option lets an agent use Apify without a conventional account.

Apify AGI provides a prepaid API token with a spending cap after payment. Your agent can use that token to run this scraper through the Apify API or an authenticated MCP connection.

Some MCP setups also support paying for each request directly. That is a different payment option, so check the official guide for its availability.

Follow the official guide for wallet setup, supported payment options and current terms. Apify handles the payments. Keep wallet keys and payment tokens in your agent's secure configuration.

Other ways for agents to pay

Apify also supports MPP for prepaid access through AGI and Skyfire for eligible Actors. If your agent already uses one of these, see the agentic payment guide to choose the right setup.

FAQ

What data can I export with Goofish Xianyu Search Scraper?

You can export listing identifiers, URLs, titles, prices, locations, images, public seller summaries, interest counts, categories, labels, flags, and search provenance.

Can I run Goofish Xianyu Search Scraper through an API, schedule, or MCP client?

Yes. Use the API examples and MCP URL above, or create an Apify schedule for recurring searches.

Does it require my Goofish account?

No. It collects public search-result data without user credentials.

Can I search in English?

Yes. Chinese terms generally match more local listings, but both Chinese and English keyword strings are accepted.

Can I export CSV or Excel?

Yes. Open the run dataset and select JSON, CSV, Excel, XML, RSS, or another supported format.

Why is an optional field missing?

Goofish does not expose every attribute on every public search card. Missing optional values are omitted rather than guessed.

How do I control cost?

Begin with a small maxItems, inspect relevance, and then scale the input. See the live Pricing tab for current plan-specific rates.

Can I schedule monitoring?

Yes. Create an Apify schedule and use a webhook or integration to process each completed dataset.

Can an AI agent use it?

Yes. Use Apify MCP, or call the Actor through an agent tool that supports the Apify API.

Is this an official Goofish product?

No. This independent Actor exports publicly available marketplace search data. Follow applicable laws, platform terms, and data-protection requirements for your use case.

Related Actors

• Amazon Products Search Scraper — Collect Amazon search results or look up known ASINs and product URLs, returning available listing fields for assortment comparisons.
• Etsy Scraper — Collect public Etsy listings from searches or listing URLs, including titles, displayed prices and available seller details, for product research.
• eBay Marketplace Scraper — Collect public active eBay listings with available prices, shipping and seller signals for resale research. Sold-price history is not included.
• AliExpress Products Scraper — Collect AliExpress listing cards from a query or public listing URLs, with available prices, ratings and sales text, for supplier and product comparisons.
• Walmart Products Scraper — Collect Walmart product search listings with available prices, ratings and seller details for retail assortment comparisons.

Support and feedback

For custom additions or integrations, email hello@fetchcat.dev.

Found an error or have a feature request? Open an issue with the run URL, a non-sensitive input example and what you expected.

Need help sharing it? See Apify’s guide to sharing a run when reporting an issue. Sharing a run can give the developer access to its input, logs and results, so use a run that contains no sensitive data. Please leave out API tokens, passwords, cookies, private documents and personal data. Use a public sample URL or a redacted example instead.

Tried this scraper? We'd love to hear how it worked for you. Leave a review to help others choose the right tool and help us improve it. Your feedback means a lot to us.

Made with care for curious people, AI agents and the possibilities in data. ♥