35,571 HTS codes. Real-time duty rates. Section 301, 232, AD/CVD overlays. One API call to know what you'll pay at the border.
Quick answer for developers
The API supports HTS search, exact tariff-rate lookup, landed-cost calculation, bulk classification, source freshness checks, and trade-remedy screening for US import workflows. Use it to enrich product catalogs, power broker tools, quote landed cost, and monitor tariff exposure by HTS code.
Two API surfaces share a single API key. The first (ustariffrates.com) covers the broader endpoint set used by the dashboard and most integrations. The second (api.ustariffrates.com) is focused on provenance-rich duty math, entry audits, and the path the @ustariffrates/mcp agent package targets.
ustariffrates.com/api/v1/searchSearch HTS codes by product description or partial codeq (required), country, limit (1-50)/api/v1/lookupLook up a specific HTS code with full duty breakdowncode (required), country/api/v1/bulkBatch lookup — descriptions and/or HTS codesitems[] with description/hts_code/country/api/v1/pricesTrade statistics — import values by country for an HTS codehts (required), year (optional)/api/v1/convertHS code concordance — convert between US HTS, EU CN, and UK commodity codescode (required)/api/v1/trade-remediesAD/CVD orders and HTS-prefix screening matcheshts, type (ad|cvd), country, product, limit/api/v1/freshnessSource freshness and monitor health for public tariff datanone/api/v1/keysGet a free API key (no auth required)email (required)/api/v1/docsMachine-readable API documentation (JSON)noneapi.ustariffrates.comProvenance + MCP/v1/lookupHTS → current rate stack with FR-cited provenance and as_of retroactive lookupshts (required), country, as_of/v1/calculateLanded-duty calculator with itemized line items (MFN, 301, 232, 122, MPF, HMF) + FR provenancehts, country, value, mode (json body)/v1/audit/entryAudit a 7501 entry against current rates; per-line discrepancy report. $0.05/entry, Team or Enterprise onlyentry_number, as_of, lines[] (json body)Dedicated pages for common integration paths: tariff search, duty-rate checks, landed-cost modeling, and trade-remedy screening.
Search and look up Harmonized Tariff Schedule codes by product description or known code.
Retrieve duty stacks, surcharge context, and tariff-rate evidence for import workflows.
Estimate duty, fees, freight inputs, and total landed cost before shipment decisions.
Screen products and origins for AD/CVD and special-duty risk before entry.
curl "https://ustariffrates.com/api/v1/search?q=steel+rebar&country=china&limit=5" \
-H "X-Api-Key: YOUR_API_KEY"| Field | Description |
|---|---|
| api_version | Public API major version; stays v1 for backward-compatible additive changes |
| schema_version | Additive response schema generation |
| hts_code | 10-digit Harmonized Tariff Schedule code |
| description | Official USITC description |
| base_duty | Base ad valorem or specific duty rate |
| section_122 | Section 122 reciprocal import surcharge — authority originates in EO 14257; current 10% rate implemented via Proclamation 11012 |
| section_232 | Section 232 rate — 50% steel, 50% aluminum, 50% copper, 25% autos |
| section_301_china | Section 301 China tariff rate (%) |
| total_estimated | Total estimated deterministic duty rate; risk layers are surfaced separately |
Pass your API key via any of these methods:
X-Api-Key: YOUR_KEYAuthorization: Bearer YOUR_KEY?api_key=YOUR_KEYUnauthenticated requests are IP-rate-limited to 100/month.
Free tier includes 100 API calls/month. Paid plans start at $49/mo for higher limits, bulk access, and production workflows.
View pricing plans →