Search published HTS classifications
usitc_search_htsSearch published USITC descriptions or complete HTS code prefixes in source order. codePrefix keeps only matches under a chapter or code before counting and paging. Matches are flat published rows with unresolved rates; call usitc_get_heading for legal ancestry and usitc_lookup_duty_rate for exact base rate columns. Follow nextCursor with identical arguments for all remaining matches.
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": "usitc_search_hts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Default 25; a larger value returns at most 100 items and says so. Keep the same limit when continuing with a cursor. | |
| query | Yes | Nonblank commodity text or an HTS code prefix; preserve leading zeros. | |
| cursor | No | Opaque nextCursor from the same tool with identical arguments. | |
| codePrefix | No | Keep only matches whose published number starts with this two-digit chapter or four-, six- or eight-digit code, bare or dotted; blank means omitted. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Complete matching collection and continuation. | |
| rows | No | Complete source rows selected for this page. | |
| error | No | Present when the call failed. Absent on success. | |
| query | No | Normalized query actually sent to USITC. | |
| notice | No | Actionable next call for this particular empty result, followed by a disclosure when a requested limit above 100 was clamped. | |
| source | No | Source provenance. | |
| context | No | Flat matches without reconstructed ancestry. | |
| notices | No | Persistent source and coverage limitations. | |
| release | No | Edition checked for this result. | |
| codePrefix | No | Canonical code prefix applied before counting; absent when none was supplied. | |
| totalCount | No | Complete locally filtered item count. |