Xianyu API
Xianyu (Goofish) is Alibaba's second-hand marketplace. search returns listings that match a keyword, and item_detail reads a batch of listings by numeric item ID or goofish.com item link, one result 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.
Platform availability
- 24h health
- Normal
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,000 | 24-hour health |
|---|---|---|---|
Searchsearch | Browse second-hand listings on Xianyu for a search phrase, up to 50 per call, with price, city, want count, tags, auction flag and the seller's trust grade. | $5.56 per 1,000 requests | Normal |
Listing detailsitem_detail | Get full Xianyu listings for 1 to 20 item IDs or goofish.com links, with description, condition score, shipping fee, location and detailed seller stats. | $5.56 per 1,000 requests | Normal |
Open a capability for its parameters, response fields, code samples and trial.
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 they do not add official-site features to the EveryInfra API contract.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Browse second-hand listings on Xianyu for a search phrase, up to 50 per call, with 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 | — | Sync delivery | 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. | $5.56 per 1,000 requests | 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, with description, condition score, shipping fee, location and detailed seller stats. | urls | — | Sync delivery | — | $5.56 per 1,000 requests | 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, with 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, with 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, and 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
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result, or poll the returned job ID when the action runs asynchronously.
- 04Store the structured response fields needed by your application.
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 a 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.