Census Imports
census_importsSearch US import data by HS commodity code and/or country. Returns import values, quantities, and commodity details. Pass country as a plain English name (e.g. "China"). Omit hs_code for total imports from a country; omit country for all countries combined.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"year": "2024",
"country": "European Union",
"hs_code": "30"
},
"name": "census_imports"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | Trade year (e.g., "2024") | |
| limit | No | Maximum number of records to return (default 20) | |
| month | No | Trade month 01-12 (e.g., "06" for June). Optional, omit for annual data. | |
| country | No | Country name in plain English (e.g., "Mexico", "South Korea", "European Union"). Preferred over country_code, this is resolved for you. Optional, omit for all countries combined. | |
| hs_code | No | HS commodity code at 2, 4, or 6 digit level (e.g., "8471" for computers, "87" for vehicles). Optional, omit for total imports across all commodities. | |
| country_code | No | Census Schedule C country code if you already have one (e.g., "5700" China, "2010" Mexico). NOT an ISO code, "MX" and "CN" will not work. Prefer `country` and pass a name instead. Optional. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | Trade direction indicator | |
| count | Yes | Number of records returned | |
| period | Yes | Trade period (year or year-month) | |
| hs_code | Yes | HS commodity code queried | |
| records | Yes |