Search supplier listings
search_listingsSearch Chinese suppliers' product listings and profiles. Returns totals and the best-matching suppliers with their matching listings. Use product words only (e.g. 'bamboo cutting board'). Optional filters apply to the suppliers returned; record keeps only suppliers with a government record (FDA, import declarations naming them as maker, or a US recall), and each result's on_record lists what is on file. With hs6, makers_on_customs_record lists the companies named as the maker on customs import declarations under that code, most importers first, including makers with no supplier profile. Spends one search.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_listings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hs6 | No | The six-digit HS code you'd classify the product under, e.g. 853952 for LED bulbs. Give it whenever you can: it adds makers_on_customs_record, the companies named as the maker on customs import declarations for that code, including makers with no supplier profile (refs C…). | |
| type | No | ||
| limit | No | ||
| place | No | Only suppliers in this province or city, e.g. 'Foshan' or 'Zhejiang'. Pass it whenever the buyer names where the factory must be, and keep the place out of query. With beyond_fair it also limits the FDA-only companies. | |
| query | Yes | Product words only | |
| record | No | Only suppliers with a government record of this kind: fda (FDA registration or 510(k) clearance), exports (named as the maker on import declarations), recall (a US recall), any. Use it when the question asks for proof, e.g. 'FDA-registered', 'already exports', 'verified'. | |
| beyond_fair | No | Also list companies known only from FDA records (refs F…, no supplier profile, listings or prices) whose FDA registration names this product. place narrows them to that province or city. | |
| certificate | No | A certificate the supplier must list, e.g. BSCI, FDA, LFGB, UL/ETL, OEKO-TEX, FSC |