Search HTS by Keyword

POST/v1/hs/search$0.05 per call

Keyword search of the HTS schedule loaded from the USITC. Each tariff line is searched together with its parent lines, plurals and a few everyday words are understood, and lines that contain all the words rank first. Chapters 98 and 99 (temporary and special provisions) are not searched, and a line without a rate of its own shows its parent line's rate. This is a keyword search, not a classifier: use POST /v1/hs/classify for an AI-assisted suggestion.

Send an Idempotency-Key header to retry safely.

Request body

Field	Type	Description
queryrequired	string	Keyword search term
limitoptional	integer	min 1 · max 100 · default 25

Response fields

Field	Type	Description
success	boolean	e.g. `true`
data	object
data.query	string	e.g. `laptop computer`
data.totalResults	number	e.g. `3`
data.results	array
data.results[].htsNumber	string	e.g. `9017.20.80.40`
data.results[].description	string	e.g. `Hand operated input devices which transmit position data to c…`
data.results[].indent	number	e.g. `3`
data.results[].generalDutyRate	string	e.g. `4.6%`
data.results[].specialDutyRate	null
data.results[].otherDutyRate	null
data.results[].units	array
data.results[].chapter	string	e.g. `90`
data.results[].heading	string	e.g. `9017`
data.results[].subheading	string	e.g. `901720`
meta	object
meta.dataSource	object
meta.dataSource.name	string	e.g. `ComplianceGrid`
meta.dataSource.provenance	string	e.g. `computed`

Fields are read from a real response captured 2026-11-04, shortened. Optional fields may be absent in other responses.

Errors

400 invalid request
401 missing or bad key
403 not in your plan
429 rate limited, see Retry-After
402 payment required
5xx retry with backoff

Error bodies and codes are described in Error codes and troubleshooting.

curl -X POST "https://api.compliancegrid.ai/v1/hs/search" \
  -H "Authorization: Bearer $CG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "laptop computer",
    "limit": 3
  }'

Try it in the sandbox

Runs against sandbox.api.compliancegrid.ai with your own sandbox key, which stays in this browser. Sandbox responses are mock data. Get a free key.

Sandbox key

Remember for this tab

Request body (JSON)

Example response · captured from production 2026-11-04 · shortened

{
  "success": true,
  "data": {
    "query": "laptop computer",
    "totalResults": 3,
    "results": [
      {
        "htsNumber": "9017.20.80.40",
        "description": "Hand operated input devices which transmit position data to computer processors or displays (digitizers)",
        "indent": 3,
        "generalDutyRate": "4.6%",
        "specialDutyRate": null,
        "otherDutyRate": null,
        "units": [
          "No."
        ],
        "chapter": "90",
        "heading": "9017",
        "subheading": "901720"
      },
      {
        "htsNumber": "8471.30.01.00",
        "description": "Portable automatic data processing machines, weighing not more than 10 kg, consisting of at least a central processing unit, a keyboard and a display",
        "indent": 1,
        "generalDutyRate": "Free",
        "specialDutyRate": null,
        "otherDutyRate": "35%",
        "units": [
          "No."
        ],
        "chapter": "84",
        "heading": "8471",
        "subheading": "847130"
      }
    ]
  },
  "meta": {
    "dataSource": {
      "name": "ComplianceGrid",
      "provenance": "computed"
    }
  }
}