Catalog / Retail, marketplaces & classifieds
RETAIL, MARKETPLACES & CLASSIFIEDS
Taobao & 1688 Product Search | Prices & Agent Links
Search Taobao and 1688 in English or Chinese.
About this data
Search Taobao and 1688 in English or Chinese. Compare CNY asking prices, images and monthly sales, and open shopping-agent product links. Bilingual titles, price and keyword filters; missing data stays null. Export JSON, CSV or Excel.
From the actor’s Apify Store listing. The per-call endpoint may return a bounded subset; its own description is below.
Buy per call over x402
One endpoint at api.ssh.autos. Each call is one JSON POST, paid in USDC with no account or API key, and answered in the same HTTP response.
POST /v1/taobao/products
Taobao or 1688 product search for one keyword: Chinese and English titles, CNY asking prices, images and shopping links.
Input
Send a JSON body to POST https://api.ssh.autos/v1/taobao/products.
| Field | Type | Required | Notes |
|---|---|---|---|
keywords | array of strings | required | exactly 1 item |
platform | string | optional | one of taobao, 1688; default "taobao" |
maxItems | integer | optional | 1–10; default 5 |
Returned fields
The answer is JSON: records, a list of up to 10, and summary, the run status and counts. Each record has these 21 fields; a field the source does not publish comes back null.
21 fields per record
| Field | Type | Notes |
|---|---|---|
recordKey | string | Marketplace plus provider identity; suitable for deduplication within this source. |
platform | string | one of taobao, 1688 |
provider | string | always oopbuy |
providerProductId | string | — |
marketplaceProductId | string | Numeric 1688 offer id when available; Taobao identities remain opaque and this field stays null. |
productUrl | string | 1688 offer URL when the native numeric offer id is available; otherwise null. |
agentUrl | string | — |
agentLinks | object | — |
titleEn | string | — |
titleCn | string | — |
titleTranslation | string | one of agent_supplied, unavailable |
priceCny | number | — |
currency | string | one of CNY |
imageUrl | string | — |
monthlySales | integer | — |
monthlySalesText | string | — |
minimumOrderQuantity | null | Not provided in the validated search responses. |
searchKeywords | array of strings | — |
keywordMatch | boolean | All literal words of at least one originating query appear in the available titles; not a semantic relevance guarantee. |
observedAt | string | — |
provenance | object | — |
Example call
npx agentcash@latest fetch https://api.ssh.autos/v1/taobao/products -m POST -b '{"keywords": ["wireless mouse"], "platform": "taobao", "maxItems": 3}'The example values come from the API spec or the actor’s own sample input. Running it is a paid call.
What is and isn’t charged
You pay the call price for
- An answer, including a definitive “not found” or an empty result.
- Confirmed no matches returns records: [] (charged: it is an answer).
Free
- Invalid input (422), busy (503), source failure (502), timeout (504) and calls whose client hung up are never charged.
- Invalid input and source failures are not charged.
Prefer a subscription? Run it on Apify
This data source is a public actor on the Apify Store: Taobao & 1688 Product Search | Prices & Agent Links. Run it with your Apify account and plan for larger, scheduled or exported runs; it may offer more input options than the per-call endpoint.
How x402 payment works
- Your client sends the request. The API answers
402 Payment Requiredwith the price and where to pay. - The client pays from its own wallet: USDC on Base or Solana over x402, or over MPP on Tempo. No account, sign-up or API key.
- The client retries with the payment attached and gets the JSON answer in the same call. You are only charged for answers.
The AgentCash CLI in the example does all three steps for you and pays from your AgentCash wallet. Any x402 or MPP client works the same way.
Machine-readable: openapi.json · llms.txt