Xianyu API
Xianyu (Goofish) is Alibaba's second-hand marketplace. search returns listings that match a keyword. item_detail reads a batch of listings by numeric item ID or goofish.com item link, with one row per listing.
Second-hand listings sell or come down quickly, so every row is a snapshot taken at request time. On search results, want_count comes from the listing card and is null when the card does not show it. item_detail adds condition on a ten-point scale, view and save counts, every photo, the description, and the seller's positive review rate. Listings that cannot be read are returned in missed and are not billed.
Send POST https://api.everyinfra.com/api/v1/social with platform set to xianyu and action set to a capability name from the list below, for example search.
- 2 capabilities
- $5.56 per 1,000 requests
- No charge for failed calls or empty results
- 24h health 100%
Platform availability
- 24h health
- 100%
Last 30 days
Available capabilities
Each Xianyu action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.
| Capability | What it does | Per 1,000Blank rows: $5.56 | 24-hour health · All normal |
|---|---|---|---|
Searchsearch | Browse second-hand listings on Xianyu for a search phrase, up to 50 per call. | Healthy · health 100% | |
Listing detailsitem_detail | Get full Xianyu listings for 1 to 20 item IDs or goofish.com links. | Healthy · health 100% |
What does each Xianyu action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and features of the official site are not part of the EveryInfra API unless this page lists them.
Sync delivery for every action.
| Action | Required | Optional | Limit | Per 1,000Blank rows: $5.56 | Response fields |
|---|---|---|---|---|---|
searchSearch Browse second-hand listings on Xianyu for a search phrase, up to 50 per call. Get price, city, want count, tags, auction flag and the seller's trust grade. Chinese terms and model numbers match seller titles best. A null | keyword | — | Catalog values: defaultLimit=20, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | item_id · url · title · price · original_price · currency · city · image_url · want_count · tags · category_id · free_shipping · is_auction · has_video · posted_at · seller_id · seller_name · seller_avatar_url · seller_credit_label · platform | |
item_detailListing details Get full Xianyu listings for 1 to 20 item IDs or goofish.com links. Get description, condition score, shipping fee, location and detailed seller stats. | urls | — | — | item_id · url · title · text · price · original_price · currency · shipping_fee · condition_level · status · quantity · want_count · view_count · collect_count · sold_count · province · city · category_id · image_url · images · posted_at · seller_id · seller_name · seller_url · seller_item_count · seller_sold_count · seller_good_review_rate · seller_reply_rate_24h · district · division_id · lat · lng · poi_name · poi_id · seller_avatar_url · seller_city · seller_bio · seller_joined_at · seller_last_seen · seller_zhima_verified · seller_zhima_level · seller_zhima_level_code · seller_credit_level · seller_identity_tags · seller_other_items · platform |
What do the Xianyu search parameters mean?
Browse second-hand listings on Xianyu for a search phrase, up to 50 per call. Get price, city, want count, tags, auction flag and the seller's trust grade. Chinese terms and model numbers match seller titles best. A null want_count means the card did not show it, not zero.
keywordRequired- The Xianyu search phrase for
search, 1–100 characters. Chinese terms and model numbers match seller titles more often than English translations. It is not an item ID or a seller name.
What do the Xianyu item_detail parameters mean?
Get full Xianyu listings for 1 to 20 item IDs or goofish.com links. Get description, condition score, shipping fee, location and detailed seller stats. condition_level uses a 10-point scale. sold_count is null when Xianyu hides it. Listings that cannot be read are refunded.
urlsRequired- For
item_detail, an array of 1–20 Xianyu listings: each entry is a numeric item ID (theitem_idreturned bysearch) or ahttps://www.goofish.com/item?id=<digits>link, and each listing may appear once. Billing is per listing, and listings that cannot be read are refunded. App share short links are not accepted.Alibaba Open Platform: Xianyu Item IDs and Condition Grades — Alibaba's item query API for authorized Xianyu ISV partners identifies one listing by its numeric Xianyu item ID and grades condition with stuff_status: 100 is brand new, 95 is 95% new, and -1 is nearly new. Calls require authorization inside Alibaba's partner environment; the source confirms the identifier and condition terminology only and does not mean EveryInfra uses this API or can read every field of any listing. · Checked
How to use the Xianyu API
- 01Choose a platform action from the public catalog.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Read the result from the response. For an asynchronous action, poll the returned job ID.
- 04Store the response fields that your application needs.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"xianyu","action":"search","params":{"keyword":"<keyword>"}}'
Xianyu API questions
What can I retrieve with the Xianyu API?
Set platform to xianyu. The current catalog lists search and listing details. These action names identify different Xianyu objects or views; they are not interchangeable search modes.
Which input starts the Xianyu search request?
The Xianyu search phrase for search, 1–100 characters. Chinese terms and model numbers match seller titles more often than English translations. It is not an item ID or a seller name. Send it as keyword inside params.
Which fields can Xianyu search return?
Its declared schema includes item_id, title, price, and original_price. A declared field can still be absent from an individual record, and every other action has its own field list.
Does every Xianyu action return immediately?
Actions labeled asynchronous return a job ID you poll. item_detail runs synchronously only: it reads everything it returns (every target of a batch, or every SKU of a product) within the same call, and a request with "mode": "async" gets a 422 before anything is charged. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.