Goofish Xianyu Search Scraper
Pricing
from $0.08 / 1,000 item extracteds
Search Goofish (Xianyu) listings by keyword and export structured product, price, seller, location, image, category, and demand data.
Optional HTTPS goofish.com/search?q= links. Terms are read locally; no arbitrary URLs are fetched. Listing/item links are not supported. Supply keywords, search links, or both.
Opt in to 102 curated brand/category concepts via 225 English/pinyin aliases, not arbitrary translation. Example: huananzhi x99 motherboard → 华南金牌 x99 主板. Case-insensitive whole words; longest phrases first; spaces/hyphens supported. Unknown words, Chinese and models stay unchanged. keyword keeps your original term; searchedAs records the actual source query. No extra searches or external translator. Full list: README supported keyword mappings.
Skip cards with a verified auction flag. Unknown or false flags are not treated as auctions.
Remember delivered IDs privately for the initiating account and named stream. Repeat IDs are not emitted or charged. No schedule is created. Each check scans one page (up to 30 cards) of one keyword, rotating through the named stream's keyword list across successful runs, even when no new rows exist. Page settings do not expand monitoring work; mostWanted ranks this one-page pool. The summary shows checked/next keyword. History retains up to 10000 IDs/30 days within a 64 KiB compressed budget; oldest IDs can be evicted earlier. Monitor terms over 500 characters are ignored with a warning. Stateless search is unchanged. Each successfully completed monitoring check charges the existing start fee once, including no-new and baseline checks; only newly delivered listings incur item fees. No-keyword, busy and source-failed checks have no start fee. Infrastructure costs still apply.
Optional stream name (up to 100 characters; default: default). Different names and customer accounts keep separate histories. Reuse the same name and filters for a watchlist. Retains at most 10,000 IDs for 30 days; expired/evicted listings may be returned again.
When monitoring is on, forget this account's named-stream history once at the start of this run. Other streams/accounts are not changed. Leave off for subsequent runs.
With monitoring on, return and charge initial matches normally. When off, the first run remembers one bounded first-page selection for the first checked keyword only without output or listing fees; the completed check still charges the existing start fee once. Later runs return only new IDs. Ignored outside monitoring.
Enter 1–50 unique non-empty Chinese or English search terms. Whitespace is trimmed and duplicate terms are combined. Started runs drop unusable entries and stop normally without charges if no usable terms remain. Results use relevance order unless you choose another sort. Set a per-keyword limit when you want several terms represented in the export.
Save at most this many unique listings across all keywords (1–1,500; default 20 in the form and API). Earlier terms can use this shared limit. Set Maximum listings per keyword to reserve room for later terms. Previously saved rows remain if a later keyword fails.
Request 1–30 listings per search page (default 30). The source may return fewer. This does not change the shared maximum-listings limit.
Stop after at most this many pages per keyword (1–50; default 20 in the form and API). Search can finish earlier when results end or a result limit is reached.
Optional cap on unique saved listings from each term. For three keywords, use 10 here and 30 for Maximum listings to allow up to 10 per term. Omit to keep the shared limit only. Listings found for multiple terms are saved once and attributed to the first matching term.
Relevance, newest and price sorts request source ordering as before. mostWanted locally selects the most-wanted cards from a filtered relevance pool: at most three pages and 30–90 candidates per keyword, bounded by your page setting. Residential fallback stops collection after its first successful page; healthy direct access may collect up to three. Known interest counts rank first, stable ties and unknowns last. Not a source-wide ranking. Page and position remain source provenance.
Optional minimum asking price in Chinese yuan, applied to the Goofish search. If both valid bounds are reversed, the started run swaps them and reports a warning.
Optional maximum asking price in Chinese yuan, applied to the Goofish search. Omit for no upper price limit.
Choose Any time or an exact posting-age limit from 1 to 14 days. Only listings with an available posting timestamp within that window are saved. Older listings and cards without a usable posting time are skipped. Choose Newest first to find recent matches sooner.
Ask Goofish for free shipping and save only listings with a visible free-shipping label. Cards without that label are skipped, so fewer results may be saved. Eligibility can depend on buyer location; confirm on the listing before purchasing.
Optional Chinese province name, for example 广东 or 广东省. Common province suffixes are removed to match Goofish region names. Combined with city and district when provided.
Optional Chinese city name, for example 深圳 or 深圳市. A trailing 市 is removed to match Goofish region names.
