USITC HTS Tariff Lookup

Look up US Harmonized Tariff Schedule (HTS) codes, product descriptions and duty rates from the official USITC HTS reststop API. Search by HTS number and/or keyword; get structured JSON with general / special / other rates plus a link to the public schedule.

No API key. Public US government tariff data used by importers, customs brokers, logistics and trade-compliance teams.

Official UI: hts.usitc.gov
REST endpoint used: GET https://hts.usitc.gov/reststop/search?keyword=…
Releases: GET https://hts.usitc.gov/reststop/releaseList

---

What it does

1. Accepts a list of HTS codes (8471.30.01.00, 6109.10, …) and/or a free-text keyword (aluminum wire, coffee).
2. Calls the official USITC reststop search endpoint for each query (optional throttle + optional release pin).
3. Writes one Dataset row per HTS line: code, description, general / special / other duty fields, units, footnotes, and a deep link to the public UI.

Notes

• Partial codes work (prefix match) — e.g. 8471.30 returns portable ADP machines and related lines.
• Keyword search is description-based; results can include heading/subheading rows without a full 10-digit code.
• Duty fields mirror the API: general (Column 1), special (preferential), other (Column 2), plus additionalDuties / quotaQuantity when present.
• Schedule release defaults to the current entry from releaseList (e.g. 2026HTSRev19); override with release if you need a pinned revision.

Who it's for

• Importers and customs brokers classifying goods into the US HTS
• Logistics / landed-cost tools that need current duty rates as JSON
• Trade compliance and Section 301 / preferential-rate research pipelines
• Agents and ETL jobs that need official USITC HTS data (not scraped HTML)

Input summary

Field	Required	Description
htsCodes	no*	List of HTS numbers (full or partial), with or without dots
keyword	no*	Free-text description search
maxItems	no	Hard Dataset cap (default 50, max 5000)
requestDelayMs	no	Delay between reststop calls in ms (default 150)
release	no	Optional USITC release name (empty = current)

*Provide at least one of htsCodes or keyword.

Output fields

One Dataset row per HTS line:

code, description, general, special, other, additionalDuties, quotaQuantity, units, indent, statisticalSuffix, footnotes, link, release, matchType, query, sourceUrl, raw, scrapedAt.

Pricing

Pay-per-event suggested for the Store:

• Actor start (apify-actor-start): about $0.04 / run
• Dataset item (apify-default-dataset-item): about $0.002–0.004 / HTS row (suggest $0.003)

Use maxItems as the spend cap. See Store pricing panel once published.

Quick start (Apify Console)

1. Open the Actor → Start.
2. Paste HTS codes and/or a keyword.
3. Set maxItems / requestDelayMs if needed.
4. Run → export Dataset JSON/CSV.

{
  "htsCodes": ["8471.30.01.00", "6109.10.00"],
  "keyword": "aluminum wire",
  "maxItems": 50,
  "requestDelayMs": 150
}

Local smoke

npm run local
# or: APIFY_LOCAL=1 node src/main.js

Writes storage/datasets/default/000000001.json and storage/key_value_stores/default/OUTPUT.json.

Legal / data source

Data comes from the official United States International Trade Commission (USITC) Harmonized Tariff Schedule reststop API (hts.usitc.gov/reststop). Results reflect the published schedule at query time and are not legal advice, a binding customs ruling, or a substitute for CBP classification. Respect fair-use request rates. See hts.usitc.gov and USITC Open Data for terms and release notes.

---

Português (resumo)

Consulta códigos HTS dos EUA, descrições e alíquotas (general / special / other) pela API oficial USITC reststop. Aceita lista de códigos e/ou palavra-chave. Sem API key. Ideal para importadores, despachantes, landed cost e compliance. Pay-per-event sugerido: ~US$0,04 por execução + ~US$0,002–0,004 por item. Fonte legal = HTS oficial da USITC.