Xianyu (Goofish) API
Search Xianyu 闲鱼 (Goofish) second-hand listings by keyword. Get price, original price, want count, publish time, location, tags, photos and link as clean JSON. Chinese keywords work. No login or cookies. Seller identity is not included. Export to JSON, CSV or Excel.
Xianyu API in one table
| Official public API for people outside China | No. This tool collects the publicly visible data instead. |
|---|---|
| What you send | A keyword, a link or an ID, depending on the request type |
| What you get back | JSON rows with English field names; 1 request types |
| Login, cookies, Chinese phone number | None needed |
| Output formats | JSON, CSV, Excel, or the Apify API |
| Price | $0.007 per result on the Bronze tier, no subscription |
| Last verified with a real run | 2026-11-09 |
One kinds of Xianyu request
Xianyu (闲鱼, also called Goofish) is the second-hand marketplace of Alibaba. Individuals and small shops list used phones, cameras, clothes, books, collectibles and almost everything else, and buyers tap "want" (想要) to start a chat. Because prices are set by the seller and change often, Xianyu is a good place to see what used goods really sell for in China.
Call the Xianyu API
Every run is one HTTP call: send the input as JSON, get the rows back. The same works from Make, Zapier or n8n.
Pay per result
Bronze tier prices from the tool's listing; higher Apify tiers pay less. Free Apify users get two trial runs with their own input.
Full price table and worked examples
The Actor uses pay-per-event pricing. These are the charge events and their prices:
| Event | Bronze | Silver | Gold and above | When it is charged |
|---|---|---|---|---|
run-start |
$0.01 | $0.01 | $0.01 | Once per run, charged when the first page of results has been fetched, even if it holds no listings. It is not charged when the run fails from the start, or when your spending limit cannot cover it. |
result |
$0.007 | $0.00631 | $0.00571 | For each listing returned |
Prices are in USD and depend on your Apify plan tier.
Worked examples (Bronze prices):
- 20 listings (the default run): $0.01 + 20 x $0.007 = $0.15.
- 100 listings: $0.01 + 100 x $0.007 = $0.71.
- 1000 listings: $0.01 + 1000 x $0.007 = $7.01.
You never pay for more than maxResults items, you are never charged for items that were not delivered, and the run stops by itself if your spending limit is reached.
On the free Apify plan you get 2 free trial runs of this Actor with your own input, up to 10 results each, and nothing is charged; after that, runs return a stored sample dataset (a real result of the prefilled input). Use any paid Apify plan for full runs.
Xianyu API questions
Do I need a Xianyu account, cookies or API keys?
No. You only need an Apify account to run the Actor.
Is it legal to scrape Xianyu?
The Actor returns only public listing data: what anyone sees on a Xianyu search results page. It returns no seller identity, no buyer data and no private data such as phone numbers or messages. You are responsible for how you use the data and for following the laws and terms that apply to you.
How fresh is the data?
Each run reads Xianyu at the time of the run.
Does it return the seller's name or ID?
No. Seller identity is not included. See the output fields above for what is returned.
How many results can I get?
Up to 1000 listings per run, set with `maxResults`. Narrow searches can return fewer.
Does it return listing details, chat or sold history?
No. This Actor returns the search result cards only: title, price, want count, publish time, location, tags, photos and link.