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.
- Endpoint
- POST /api/v1/social
- Capabilities
- 2
- Per 1,000
- $5.56 per 1,000 requests
Available capabilities
Compare the Xianyu actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Search second-hand listings on Xianyu by keyword. Accepts these parameters: | 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 · platform |
item_detailListing details Read condition, demand counts, photos, and seller ratings for a batch of Xianyu listings. Accepts these parameters: | 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 · platform |
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.
What do the Xianyu search parameters mean?
Search second-hand listings on Xianyu by keyword. Accepts these parameters: keyword. Returns these fields: item_id, title, price, and original_price.
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?
Read condition, demand counts, photos, and seller ratings for a batch of Xianyu listings. Accepts these parameters: urls. Returns these fields: item_id, title, text, and price.
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 yet.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 source 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 every target in the batch 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.