Settings Trade Exporters takes
You describe the task in plain words and your AI assistant fills these in. In code you pass them yourself.
| Setting | What it controls | Tip |
|---|---|---|
| Page no | Page number, starting at 1. | Required |
| Catalog | Data-source side: customs import records or export records. | Required · one of imports, exports |
| End date | Query window end, YYYY-MM-DD. | Required |
| Page size | Rows per page (1-100). Paginated rows are what you pay for, this is your cost budget per call. | Required · 1 to 100 |
| Start date | Query window start, YYYY-MM-DD. The window may span at most three years. | Required |
| Hs code | Customs HS code, 4+ digits (e.g. '630492'). A 2-digit chapter code works only combined with productDesc or a company name. | Optional |
| Weight | Weight range in kilograms, as [min, max]. | Optional |
| Exporter | Exporter company name (min 2 chars). Drop company suffixes and special characters for better matching. | Optional |
| Importer | Importer company name (min 2 chars). Drop company suffixes and special characters for better matching. | Optional |
| Quantity | Quantity range, as [min, max]. | Optional |
| Sum of usd | Total USD value range, as [min, max]. | Optional |
| Sort field | Sort field | Optional · one of weight, sumOfUSD, tradeCount |
| Sort order | Ranking direction. | Optional · one of ASC, DESC |
| Search mode | Set to FUZZY_SINGLE for single-keyword fuzzy matching; omit for the default smart search. | Optional |
| Product desc | Product description keywords; separate multiple keywords with semicolons (e.g. 'electronics; home appliance'). | Optional |
| Quantity unit | Quantity unit filter (e.g. 'PCS', 'PKG'). | Optional |
| Port of arrival | Arrival port name. | Optional |
| Transport type | Transport mode (e.g. sea, air, road). | Optional |
| Contain producer | Include producer companies (available on Russia/Kazakhstan sources). | Optional |
| Port of departure | Departure port name. | Optional |
| Filter blank fields | Drop records whose named party is blank (e.g. ["importer"]). | Optional |
| Optimization model | Optimization model | Optional |
| Weight unit price usd | USD unit price per kilogram range, as [min, max]. | Optional |
| Country of origin code | Origin country ISO3 code(s), semicolon-separated (e.g. 'CHN;USA'). | Optional |
| Filter logistic fields | Drop records whose named party is a logistics company (e.g. ["exporter"]). | Optional |
| Quantity unit price usd | USD unit price per quantity range, as [min, max]. | Optional |
| Country of destination code | Destination country ISO3 code(s), semicolon-separated (e.g. 'USA;CHN'). | Optional |
How to use Trade Exporters with your AI assistant
Connect AI/ML API
Click Try it now, pick your client and add the MCP server. You sign in with your AI/ML API account once.
Describe the task
Say what you need in one sentence, including the page no.
Get the result
Your assistant runs Trade Exporters and shows what came back.
Keep going in the chat
Ask it to filter, compare or summarize the result, or to save it as a table.
Ways to use it
- For a trade-research brief: rank exporters for your trade query using shipment volume, dollar value and deal counts to research potential suppliers.
Trade Exporters in your code
In your code
REST · your AI/ML API key, JSON records back
The same tool runs over REST with your AI/ML API key, so a backend, a script or a scheduled job can call Trade Exporters directly. Start with the Toolbox REST quickstart.
Pricing
Pay as you goBilled per run from your AI/ML API balance
- No subscription
- No seat fee
- One balance for every tool
Each run is billed from your AI/ML API balance, with no subscription or seat fee. Check the current price in your dashboard before large runs.
FAQ
Do I need a separate account for Trade Exporters?
No. It runs on your AI/ML API account and balance, from your AI assistant over MCP or from your code over REST.
Which AI assistants can use it?
Claude, ChatGPT, Cursor, Hermes, OpenClaw and other MCP clients. Add the AI/ML API MCP server once with the MCP quickstart.
Run Trade Exporters from your assistant
Connect once, then ask for it in plain words.