US Tariff Schedule Scraper

US Tariff Schedule Scraper: HTS codes, duty rates and units, with the edition on every row

Give it chapters, HTS codes or search terms, and it reads those lines of the US Harmonized Tariff Schedule from the USITC's own published data. Each row is one line: the HTS code, its description and full description path, the unit of quantity, the general, special and column 2 rates exactly as printed, the rate that applies when a line inherits it, and the edition it came from. The awkward part: an empty rate on a line does not mean duty-free, and only the live edition is published, so a rate you pulled in March may not be the one in force in September.

🔍 What US Tariff Schedule Scraper does

The edition is read before a single line, and every row carries it, so a dataset dates itself. It is read again at the end, and if a revision landed mid-run you get a free row saying so. On a schedule, requireEdition makes the run return nothing rather than a different edition.

Then the rates. The schedule states a rate once and lets the lines beneath it inherit, so a 10-digit line often prints nothing in its rate columns. In edition 2026HTSRev19, 11,836 of the 29,860 numbered lines carried no rate of their own. Read those blanks as zero and you price about two lines in five at no duty when they are dutiable. So each row keeps both readings apart:

A rate is only inherited from a line whose code starts the row's own code. Rates are never parsed into numbers. You get 15.9%, Free, 1¢/kg, 3.7¢/kg on drained weight, and in chapter 99 whole sentences such as The duty provided in the applicable subheading + 25%. Turning those into a number is a judgement about your goods.

Each chapter is checked before it is used. One that comes back empty, or carrying lines from another chapter, becomes a free row instead of a charge.

📥 What you give it

One thing about combining them. Give chapters together with hsCodes or searchTerms and you get the whole chapters, with the codes only filling in matchedQuery. To get just the lines you named, leave chapters empty.

{
  "hsCodes": ["8471.30", "6101.20"],
  "searchTerms": ["olive oil"],
  "includeLines": "statisticalOnly",
  "maxItems": 200
}

An input with nothing in it, such as {} sent through the API, returns one free sample row so you can see the shape first.

📤 What you get back

A real row from a real run. Look at the rates: this line printed none, and the 15.9% it carries was read off 6101.20.00 above it.

{
  "ok": true,
  "charged": true,
  "recordType": "tariffLine",
  "htsEdition": "2026HTSRev20",
  "htsEditionTitle": "Revision 20 (2026)",
  "htsno": "6101.20.00.10",
  "lineLevel": "statistical",
  "chapter": "61",
  "heading": "6101",
  "subheading": "6101.20",
  "headingDescription": "Men's or boys' overcoats, carcoats, capes, cloaks, anoraks (including ski-jackets), windbreakers and similar articles, knitted or crocheted, other than those of heading 6103:",
  "indent": 2,
  "description": "Men's (334)",
  "descriptionPath": "Men's or boys' overcoats, carcoats, capes, cloaks, anoraks (including ski-jackets), windbreakers and similar articles, knitted or crocheted, other than those of heading 6103: > Of cotton > Men's (334)",
  "unitOfQuantity": "doz., kg",
  "units": ["doz.", "kg"],
  "generalRate": null,
  "specialRate": null,
  "column2Rate": null,
  "generalRateEffective": "15.9%",
  "specialRateEffective": "Free (AU,BH, CL,CO,IL,JO,KR, MA,OM, P,PA,PE,S,SG)",
  "column2RateEffective": "50%",
  "ratesAreInherited": true,
  "rateSource": "6101.20.00",
  "dutyRateResolved": true,
  "rateNote": null,
  "additionalDuties": null,
  "footnotes": [],
  "matchedQuery": null,
  "htsUrl": "https://hts.usitc.gov/search?query=6101.20.00.10",
  "scrapedAt": "2026-09-30T02:28:10.927Z"
}

🧾 Reading the output

Three kinds of row can share a dataset, and charged is the field that separates them.

The sample row also says recordType: "tariffLine", so filter on charged == true, not on recordType.

▶️ How to run it

1. Open US Tariff Schedule Scraper and click Try for free. 2. Type chapter numbers into Chapters, or clear it and use HTS codes or Search terms. The form arrives with chapter 61. 3. Choose Which lines to return. "Statistical lines only" gives you the codes that go on an entry. 4. Set Maximum rows, or tick Read the whole schedule and raise it to match. 5. Click Start, then download the dataset as CSV, JSON or Excel.

💰 How much does it cost?

$2.00 per 1,000 tariff lines, which is $0.002 a line, flat on every Apify plan. An average chapter holds around 300 lines, which comes to roughly 60 cents, and the whole schedule of about 29,900 lines to roughly $60.

You pay for tariff-line rows and nothing else per row. The sample row and every diagnostic row are free, including chapter 77, an empty chapter, a search term that finds nothing and a requireEdition refusal. Lines in chapters 98 and 99 that resolve to no rate are still charged, because they are still the lines you asked for. If you set a maximum charge on the run, it stops at that figure instead of going past it.

💡 What people use it for

• Checking the duty on a product before pricing an import, with the rate and the line it came from on one row.
• Keeping your own history. Only the live edition is published, so a pull after each revision is the only archive you will have.
• Seeing what a revision moved, by comparing two pulls on htsno plus generalRateEffective.
• Loading the schedule into a spreadsheet, where descriptionPath makes a deep line readable on its own.

🚧 What it does not do

• No classification. Which line your goods fall under is your call, or your broker's.
• No advice, customs, legal or otherwise.
• Only the live edition. There is no way to ask for last year's rates.
• No notes. General, section and chapter notes are prose documents, not data. Chapter titles are not returned either.
• Only the US schedule. No other country's tariff.
• No duty calculation. No landed cost, freight, trade-remedy stacking or rules of origin.
• Chapters 98 and 99 carry lines with no rate. In edition 2026HTSRev19, 1,169 of their lines resolved to no general rate, because the treatment comes from a note rather than a rate column. They arrive with dutyRateResolved: false and a rateNote.

🧭 Which trade data scraper do you need?

❓ Questions people ask

What is the HTS? The Harmonized Tariff Schedule of the United States: the codes every imported good is classified under and the duty attached to each. The US International Trade Commission publishes it.

How many lines are there? In edition 2026HTSRev19 there were 29,860 numbered lines: 961 headings, 2,093 subheadings, 6,857 eight-digit lines and 19,949 statistical lines. Revision 20 is live now and has not been recounted.

Can I get the Section 232 and 301 duties? Chapter 99 holds the temporary modifications and it is included: {"chapters": ["99"]}. Those lines often state the treatment as a sentence rather than a percentage, and you get that sentence.

Can I run it on a schedule? Yes. Compare runs on htsno plus generalRateEffective to see what moved, and watch htsEdition for when a revision landed.

🆘 If something breaks

Open the Issues tab on the actor page and send the run ID with the input you used. The errorCode and details on a diagnostic row usually name the reason already.