---
type: "firecrawl-provider"
description: "The Harmonized Tariff Schedule of the United States from the USITC HTS REST API (hts.usitc.gov/reststop): the current revision's identity and dates, every HTS line (4-, 6-, 8- and 10-digit numbers, group headings, descriptions, units, General/Special/Column 2 duty rates, footnotes) one chapter per page, one line by HTS number, and keyword search. Current revision only: the API serves no archived revisions as data."
use_when: "The Harmonized Tariff Schedule of the United States from the USITC HTS REST API (hts.usitc.gov/reststop): the current revision's identity and dates, every HTS line (4-, 6-, 8- and 10-digit numbers, group headings, descriptions, units, General/Special/Column 2 duty rates, footnotes) one chapter per page, one line by HTS number, and keyword search. Current revision only: the API serves no archived revisions as data."
categories: "Public records"
capabilities: 4
credits_per_call: 5
---
# USITC Harmonized Tariff Schedule (HTSUS) on Firecrawl Alexandria

The Harmonized Tariff Schedule of the United States from the USITC HTS REST API (hts.usitc.gov/reststop): the current revision's identity and dates, every HTS line (4-, 6-, 8- and 10-digit numbers, group headings, descriptions, units, General/Special/Column 2 duty rates, footnotes) one chapter per page, one line by HTS number, and keyword search. Current revision only: the API serves no archived revisions as data.

- Categories: Public records
- Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records)
- Provider key: `hts-usitc-gov`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/hts-usitc-gov)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/hts-usitc-gov/openapi.json)

## Capabilities

- [Records get](https://firecrawl.dev/alexandria/agents/providers/hts-usitc-gov/tariff-schedule/records_get): One HTS line by its number: exports the 4-digit heading's range (`exportList?from=HHHH&to=HHHH.99.99.99`) and returns the matching row in the same shape as `records_list`, with `parent_htsno` computed within the heading. Accepts the dotted form (`8541.43.00.10`) or bare digits (`8541430010`) with 4, 6, 8 or 10 digits, and the `<chapter>:<ordinal>` id that `records_list` gives unnumbered headings (one chapter export). A number the current revision does not carry is `not_found`. Collection contract name: `records/get`.
- [Records list](https://firecrawl.dev/alexandria/agents/providers/hts-usitc-gov/tariff-schedule/records_list): Every HTS line of the current revision, segmented by chapter: `exportList?from=CC00&to=CC99&format=JSON&styles=false` for one two-digit chapter per segment, paged by `limit` rows. Before each page the current revision name is re-read (`reststop/currentRelease`) and compared with the one pinned in the cursor; if it moved the call fails with `invalid_input` and issue code `publication_changed` on `/continuation` instead of mixing revisions (the server always serves the current revision; it ignores `release=`). Chapter 77 is reserved and empty; empty chapters are skipped. Rows are mapped per the collection contract: `htsno` as `source_record_id` (unnumbered headings get `<chapter>:<ordinal>` and a `parent_htsno`), derived `hts_level`, `hs6`, `statistical_suffix`, `chapter`. Collection contract name: `records/list`.
- [Search](https://firecrawl.dev/alexandria/agents/providers/hts-usitc-gov/tariff-schedule/search): Keyword search of the current revision through `reststop/search?keyword=`: substring match on article descriptions and HTS numbers, the server returns every hit (152 for `copper`) and this function keeps the first `limit`. Hits carry the search endpoint's own fields (`statisticalSuffix`, `effectivePeriod`) plus the derived `hts_level`, `hs6` and `chapter`. No hits is a legitimate empty result.
- [Source status](https://firecrawl.dev/alexandria/agents/providers/hts-usitc-gov/tariff-schedule/source_status): Cheap version check of the Harmonized Tariff Schedule: the current revision from `reststop/releaseList` (exactly one entry has `status: current`) with its name as `publication_id`, title, publication and effective dates, the previous revision and the publisher's PDF/JSON file URLs. The publisher posts no hash and the API sends no ETag, so `content_hash` and `record_count` are null: `publication_id` is the change key (a new revision every ~2 weeks). Collection contract name: `source/status`.

## 1. Choose this provider when

The Harmonized Tariff Schedule of the United States from the USITC HTS REST API (hts.usitc.gov/reststop): the current revision's identity and dates, every HTS line (4-, 6-, 8- and 10-digit numbers, group headings, descriptions, units, General/Special/Column 2 duty rates, footnotes) one chapter per page, one line by HTS number, and keyword search. Current revision only: the API serves no archived revisions as data.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "hts-usitc-gov",
  "capability": "tariff-schedule/records_get",
  "options": {
    "htsno": "8541.43.00.10"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `htsno` (string, required): HTS number, dotted or bare digits (4, 6, 8 or 10 digits), or a `<chapter>:<ordinal>` heading id from `records_list`. Example: `<chapter>:<ordinal>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "hts-usitc-gov",
    capability: "tariff-schedule/records_get",
    options: {
      htsno: "8541.43.00.10",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "hts-usitc-gov",
  "capability": "tariff-schedule/records_get",
  "options": {
    "htsno": "8541.43.00.10"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "hts-usitc-gov",
    "capability": "tariff-schedule/records_get",
    "options": {
      "htsno": "8541.43.00.10"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'hts-usitc-gov/tariff-schedule/records_get' \
  --options '{"htsno":"8541.43.00.10"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "hts-usitc-gov",
  "capability": "tariff-schedule/records_get",
  "options": {
    "htsno": "8541.43.00.10"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "hts-usitc-gov",
  "capability": "tariff-schedule/records_get",
  "options": {
    "htsno": "8541.43.00.10"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "additional_duties": null,
  "chapter": "85",
  "description": "Crystalline silicon photovoltaic cells of a kind described in statistical note 12 to this chapter",
  "footnotes": [],
  "general": "",
  "hs6": "854143",
  "hts_level": 10,
  "htsno": "8541.43.00.10",
  "indent": 3,
  "other": "",
  "parent_htsno": "8541.43.00",
  "publication_id": "2026HTSRev21",
  "quota_quantity": null,
  "retrieved_at": "2026-10-18T05:54:10Z",
  "source_record_id": "8541.43.00.10",
  "source_url": "https://hts.usitc.gov/reststop/exportList?from=8541&to=8541.99.99.99&format=JSON&styles=false",
  "special": "",
  "statistical_suffix": "10",
  "superior": false,
  "units": [
    "No.",
    "W"
  ]
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Records get

- Capability: `tariff-schedule/records_get`
- Description: One HTS line by its number: exports the 4-digit heading's range (`exportList?from=HHHH&to=HHHH.99.99.99`) and returns the matching row in the same shape as `records_list`, with `parent_htsno` computed within the heading. Accepts the dotted form (`8541.43.00.10`) or bare digits (`8541430010`) with 4, 6, 8 or 10 digits, and the `<chapter>:<ordinal>` id that `records_list` gives unnumbered headings (one chapter export). A number the current revision does not carry is `not_found`. Collection contract name: `records/get`.
- Instructions: Look up the description, units and duty rates of one HTS number.
- Cost: 5 credits per call
- Capability file: [Records get](https://firecrawl.dev/alexandria/agents/providers/hts-usitc-gov/tariff-schedule/records_get)

Accepted options:
- `htsno` (string, required): HTS number, dotted or bare digits (4, 6, 8 or 10 digits), or a `<chapter>:<ordinal>` heading id from `records_list`. Example: `<chapter>:<ordinal>`

Response schema example:
```json
{
  "additional_duties": null,
  "chapter": "85",
  "description": "Crystalline silicon photovoltaic cells of a kind described in statistical note 12 to this chapter",
  "footnotes": [],
  "general": "",
  "hs6": "854143",
  "hts_level": 10,
  "htsno": "8541.43.00.10",
  "indent": 3,
  "other": "",
  "parent_htsno": "8541.43.00",
  "publication_id": "2026HTSRev21",
  "quota_quantity": null,
  "retrieved_at": "2026-10-18T05:54:10Z",
  "source_record_id": "8541.43.00.10",
  "source_url": "https://hts.usitc.gov/reststop/exportList?from=8541&to=8541.99.99.99&format=JSON&styles=false",
  "special": "",
  "statistical_suffix": "10",
  "superior": false,
  "units": [
    "No.",
    "W"
  ]
}
```

### Records list

- Capability: `tariff-schedule/records_list`
- Description: Every HTS line of the current revision, segmented by chapter: `exportList?from=CC00&to=CC99&format=JSON&styles=false` for one two-digit chapter per segment, paged by `limit` rows. Before each page the current revision name is re-read (`reststop/currentRelease`) and compared with the one pinned in the cursor; if it moved the call fails with `invalid_input` and issue code `publication_changed` on `/continuation` instead of mixing revisions (the server always serves the current revision; it ignores `release=`). Chapter 77 is reserved and empty; empty chapters are skipped. Rows are mapped per the collection contract: `htsno` as `source_record_id` (unnumbered headings get `<chapter>:<ordinal>` and a `parent_htsno`), derived `hts_level`, `hs6`, `statistical_suffix`, `chapter`. Collection contract name: `records/list`.
- Instructions: Full collection of the schedule: start with no cursor (chapter 01) or at a chapter, follow `next_cursor` until it is null.
- Cost: 5 credits per call
- Capability file: [Records list](https://firecrawl.dev/alexandria/agents/providers/hts-usitc-gov/tariff-schedule/records_list)

Accepted options:
- `chapter` (string): Chapter to start at, `01`..`99` (two digits). Default `01`. Not with `continuation`. Pattern: ^[0-9]{2}$. Example: `01`
- `continuation` (string): `next_cursor` from the previous page; pins the revision, chapter and row offset. Example: `next_cursor`
- `limit` (number): Rows per page. Default 500; 5000 returns any chapter in one page (chapter 99, the largest, has about 3,350 rows). Example: `500`

Response schema example:
```json
{
  "chapter": "01",
  "next_cursor": "2026HTSRev21:01:12",
  "offset": 0,
  "publication_id": "2026HTSRev21",
  "records": [
    {
      "additional_duties": null,
      "chapter": "01",
      "description": "Live horses, asses, mules and hinnies:",
      "footnotes": [],
      "general": "",
      "hs6": null,
      "hts_level": 4,
      "htsno": "0101",
      "indent": 0,
      "other": "",
      "parent_htsno": null,
      "publication_id": "2026HTSRev21",
      "quota_quantity": null,
      "retrieved_at": "2026-10-18T05:54:07Z",
      "source_record_id": "0101",
      "source_url": "https://hts.usitc.gov/reststop/exportList?from=0100&to=0199&format=JSON&styles=false",
      "special": "",
      "statistical_suffix": null,
      "superior": false,
      "units": []
    },
    {
      "additional_duties": null,
      "chapter": "01",
      "description": "Horses:",
      "footnotes": [],
      "general": "",
      "hs6": null,
      "hts_level": null,
      "htsno": null,
      "indent": 1,
      "other": "",
      "parent_htsno": "0101",
      "publication_id": "2026HTSRev21",
      "quota_quantity": null,
      "retrieved_at": "2026-10-18T05:54:07Z",
      "source_record_id": "01:1",
      "source_url": "https://hts.usitc.gov/reststop/exportList?from=0100&to=0199&format=JSON&styles=false",
      "special": "",
      "statistical_suffix": null,
      "superior": true,
      "units": []
    },
    {
      "additional_duties": null,
      "chapter": "01",
      "description": "Purebred breeding animals",
      "footnotes": [],
      "general": "Free",
      "hs6": "010121",
      "hts_level": 8,
      "htsno": "0101.21.00",
      "indent": 2,
      "other": "Free",
      "parent_htsno": "0101",
      "publication_id": "2026HTSRev21",
      "quota_quantity": null,
      "retrieved_at": "2026-10-18T05:54:07Z",
      "source_record_id": "0101.21.00",
      "source_url": "https://hts.usitc.gov/reststop/exportList?from=0100&to=0199&format=JSON&styles=false",
      "special": "",
      "statistical_suffix": null,
      "superior": false,
      "units": []
    },
    {
      "additional_duties": null,
      "chapter": "01",
      "description": "Males",
      "footnotes": [],
      "general": "",
      "hs6": "010121",
      "hts_level": 10,
      "htsno": "0101.21.00.10",
      "indent": 3,
      "other": "",
      "parent_htsno": "0101.21.00",
      "publication_id": "2026HTSRev21",
      "quota_quantity": null,
      "retrieved_at": "2026-10-18T05:54:07Z",
      "source_record_id": "0101.21.00.10",
      "source_url": "https://hts.usitc.gov/reststop/exportList?from=0100&to=0199&format=JSON&styles=false",
      "special": "",
      "statistical_suffix": "10",
      "superior": false,
      "units": [
        "No."
      ]
    },
    {
      "additional_duties": null,
      "chapter": "01",
      "description": "Females",
      "footnotes": [],
      "general": "",
      "hs6": "010121",
      "hts_level": 10,
      "htsno": "0101.21.00.20",
      "indent": 3,
      "other": "",
      "parent_htsno": "0101.21.00",
      "publication_id": "2026HTSRev21",
      "quota_quantity": null,
      "retrieved_at": "2026-10-18T05:54:07Z",
      "source_record_id": "0101.21.00.20",
      "source_url": "https://hts.usitc.gov/reststop/exportList?from=0100&to=0199&format=JSON&styles=false",
      "special": "",
      "statistical_suffix": "20",
      "superior": false,
      "units": [
        "No."
      ]
    },
    {
      "additional_duties": null,
      "chapter": "01",
      "description": "Other",
      "footnotes": [],
      "general": "Free",
      "hs6": "010129",
      "hts_level": 8,
      "htsno": "0101.29.00",
      "indent": 2,
      "other": "20%",
      "parent_htsno": "0101",
      "publication_id": "2026HTSRev21",
      "quota_quantity": null,
      "retrieved_at": "2026-10-18T05:54:07Z",
      "source_record_id": "0101.29.00",
      "source_url": "https://hts.usitc.gov/reststop/exportList?from=0100&to=0199&format=JSON&styles=false",
      "special": "",
      "statistical_suffix": null,
      "superior": false,
      "units": []
    },
    {
      "additional_duties": null,
      "chapter": "01",
      "description": "Imported for immediate slaughter",
      "footnotes": [],
      "general": "",
      "hs6": "010129",
      "hts_level": 10,
      "htsno": "0101.29.00.10",
      "indent": 3,
      "other": "",
      "parent_htsno": "0101.29.00",
      "publication_id": "2026HTSRev21",
      "quota_quantity": null,
      "retrieved_at": "2026-10-18T05:54:07Z",
      "source_record_id": "0101.29.00.10",
      "source_url": "https://hts.usitc.gov/reststop/exportList?from=0100&to=0199&format=JSON&styles=false",
      "special": "",
      "statistical_suffix": "10",
      "superior": false,
      "units": [
        "No."
      ]
    },
    {
      "additional_duties": null,
      "chapter": "01",
      "description": "Other",
      "footnotes": [],
      "general": "",
      "hs6": "010129",
      "hts_level": 10,
      "htsno": "0101.29.00.90",
      "indent": 3,
      "other": "",
      "parent_htsno": "0101.29.00",
      "publication_id": "2026HTSRev21",
      "quota_quantity": null,
      "retrieved_at": "2026-10-18T05:54:07Z",
      "source_record_id": "0101.29.00.90",
      "source_url": "https://hts.usitc.gov/reststop/exportList?from=0100&to=0199&format=JSON&styles=false",
      "special": "",
      "statistical_suffix": "90",
      "superior": false,
      "units": [
        "No."
      ]
    },
    {
      "additional_duties": null,
      "chapter": "01",
      "description": "Asses",
      "footnotes": [],
      "general": "6.8%",
      "hs6": "010130",
      "hts_level": 10,
      "htsno": "0101.30.00.00",
      "indent": 1,
      "other": "15%",
      "parent_htsno": "0101",
      "publication_id": "2026HTSRev21",
      "quota_quantity": null,
      "retrieved_at": "2026-10-18T05:54:07Z",
      "source_record_id": "0101.30.00.00",
      "source_url": "https://hts.usitc.gov/reststop/exportList?from=0100&to=0199&format=JSON&styles=false",
      "special": "Free (A+,AU,BH,CL,CO,D,E,IL,JO,KR,MA,OM,P,PA,PE,S,SG)",
      "statistical_suffix": "00",
      "superior": false,
      "units": [
        "No."
      ]
    },
    {
      "additional_duties": null,
      "chapter": "01",
      "description": "Other:",
      "footnotes": [],
      "general": "",
      "hs6": "010190",
      "hts_level": 6,
      "htsno": "0101.90",
      "indent": 1,
      "other": "",
      "parent_htsno": "0101",
      "publication_id": "2026HTSRev21",
      "quota_quantity": null,
      "retrieved_at": "2026-10-18T05:54:07Z",
      "source_record_id": "0101.90",
      "source_url": "https://hts.usitc.gov/reststop/exportList?from=0100&to=0199&format=JSON&styles=false",
      "special": "",
      "statistical_suffix": null,
      "superior": false,
      "units": []
    },
    {
      "additional_duties": null,
      "chapter": "01",
      "description": "Imported for immediate slaughter",
      "footnotes": [],
      "general": "Free",
      "hs6": "010190",
      "hts_level": 10,
      "htsno": "0101.90.30.00",
      "indent": 2,
      "other": "Free",
      "parent_htsno": "0101.90",
      "publication_id": "2026HTSRev21",
      "quota_quantity": null,
      "retrieved_at": "2026-10-18T05:54:07Z",
      "source_record_id": "0101.90.30.00",
      "source_url": "https://hts.usitc.gov/reststop/exportList?from=0100&to=0199&format=JSON&styles=false",
      "special": "",
      "statistical_suffix": "00",
      "superior": false,
      "units": [
        "No."
      ]
    },
    {
      "additional_duties": null,
      "chapter": "01",
      "description": "Other",
      "footnotes": [],
      "general": "4.5%",
      "hs6": "010190",
      "hts_level": 10,
      "htsno": "0101.90.40.00",
      "indent": 2,
      "other": "20%",
      "parent_htsno": "0101.90",
      "publication_id": "2026HTSRev21",
      "quota_quantity": null,
      "retrieved_at": "2026-10-18T05:54:07Z",
      "source_record_id": "0101.90.40.00",
      "source_url": "https://hts.usitc.gov/reststop/exportList?from=0100&to=0199&format=JSON&styles=false",
      "special": "Free (A+,AU,BH,CL,CO,D,E, IL,JO,KR,MA,OM,P,PA,PE,S, SG)",
      "statistical_suffix": "00",
      "superior": false,
      "units": [
        "No."
      ]
    }
  ],
  "retrieved_at": "2026-10-18T05:54:07Z",
  "segment_record_count": 126,
  "segment_url": "https://hts.usitc.gov/reststop/exportList?from=0100&to=0199&format=JSON&styles=false"
}
```

### Search

- Capability: `tariff-schedule/search`
- Description: Keyword search of the current revision through `reststop/search?keyword=`: substring match on article descriptions and HTS numbers, the server returns every hit (152 for `copper`) and this function keeps the first `limit`. Hits carry the search endpoint's own fields (`statisticalSuffix`, `effectivePeriod`) plus the derived `hts_level`, `hs6` and `chapter`. No hits is a legitimate empty result.
- Instructions: Find candidate HTS numbers for an article by keyword, then `records_get` for the row in its heading context.
- Cost: 5 credits per call
- Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/hts-usitc-gov/tariff-schedule/search)

Accepted options:
- `keyword` (string, required): Word, phrase or HTS number fragment; must contain a non-whitespace character. Example: `<keyword>`
- `limit` (number): Maximum hits to return, in the server's order. Default 100. Example: `100`

Response schema example:
```json
{
  "hits": [
    {
      "additional_duties": null,
      "chapter": "26",
      "description": "Copper ores and concentrates",
      "effective_period": null,
      "footnotes": [],
      "general": "1.7¢/kg on lead content",
      "hs6": "260300",
      "hts_level": 8,
      "htsno": "2603.00.00",
      "indent": 0,
      "other": "8.8¢/kg on copper content + 3.3¢/kg on lead content + 3.7¢/kg on zinc content",
      "publication_id": "2026HTSRev21",
      "quota_quantity": null,
      "retrieved_at": "2026-10-18T05:54:14Z",
      "source_record_id": "2603.00.00",
      "source_url": "https://hts.usitc.gov/reststop/search?keyword=copper",
      "special": "Free (A,AU,BH,CL,CO,D,E,IL,JO,KR,MA,OM,P,PA,PE,S,SG)",
      "statistical_suffix": null,
      "units": []
    },
    {
      "additional_duties": null,
      "chapter": "26",
      "description": "Copper content",
      "effective_period": null,
      "footnotes": [
        {
          "columns": [
            "units"
          ],
          "marker": "1",
          "type": "endnote",
          "value": "Report value only of stated metal content."
        }
      ],
      "general": "",
      "hs6": "260300",
      "hts_level": 10,
      "htsno": "2603.00.00.10",
      "indent": 1,
      "other": "",
      "publication_id": "2026HTSRev21",
      "quota_quantity": null,
      "retrieved_at": "2026-10-18T05:54:14Z",
      "source_record_id": "2603.00.00.10",
      "source_url": "https://hts.usitc.gov/reststop/search?keyword=copper",
      "special": "",
      "statistical_suffix": "10",
      "units": [
        "Cu kg"
      ]
    },
    {
      "additional_duties": null,
      "chapter": "26",
      "description": "Lead ores and concentrates",
      "effective_period": null,
      "footnotes": [],
      "general": "1.1¢/kg on lead content",
      "hs6": "260700",
      "hts_level": 8,
      "htsno": "2607.00.00",
      "indent": 0,
      "other": "8.8¢/kg on copper content + 3.3¢/kg on lead content + 3.7¢/kg on zinc content",
      "publication_id": "2026HTSRev21",
      "quota_quantity": null,
      "retrieved_at": "2026-10-18T05:54:14Z",
      "source_record_id": "2607.00.00",
      "source_url": "https://hts.usitc.gov/reststop/search?keyword=copper",
      "special": "Free (A,AU,BH,CL,CO,D,E,IL,JO,KR,MA,OM,P,PA,PE,S,SG)",
      "statistical_suffix": null,
      "units": []
    },
    {
      "additional_duties": null,
      "chapter": "26",
      "description": "Copper content",
      "effective_period": null,
      "footnotes": [
        {
          "columns": [
            "units"
          ],
          "marker": "1",
          "type": "endnote",
          "value": "Report value only of stated metal content."
        }
      ],
      "general": "",
      "hs6": "260700",
      "hts_level": 10,
      "htsno": "2607.00.00.10",
      "indent": 1,
      "other": "",
      "publication_id": "2026HTSRev21",
      "quota_quantity": null,
      "retrieved_at": "2026-10-18T05:54:14Z",
      "source_record_id": "2607.00.00.10",
      "source_url": "https://hts.usitc.gov/reststop/search?keyword=copper",
      "special": "",
      "statistical_suffix": "10",
      "units": [
        "Cu kg"
      ]
    },
    {
      "additional_duties": null,
      "chapter": "26",
      "description": "Zinc ores and concentrates",
      "effective_period": null,
      "footnotes": [],
      "general": "Free",
      "hs6": "260800",
      "hts_level": 8,
      "htsno": "2608.00.00",
      "indent": 0,
      "other": "8.8¢/kg on copper content + 3.3¢/kg on lead content + 3.7¢/kg on zinc content",
      "publication_id": "2026HTSRev21",
      "quota_quantity": null,
      "retrieved_at": "2026-10-18T05:54:14Z",
      "source_record_id": "2608.00.00",
      "source_url": "https://hts.usitc.gov/reststop/search?keyword=copper",
      "special": "",
      "statistical_suffix": null,
      "units": []
    }
  ],
  "keyword": "copper",
  "publication_id": "2026HTSRev21",
  "retrieved_at": "2026-10-18T05:54:14Z",
  "source_url": "https://hts.usitc.gov/reststop/search?keyword=copper",
  "total_hits": 152,
  "truncated": true
}
```

### Source status

- Capability: `tariff-schedule/source_status`
- Description: Cheap version check of the Harmonized Tariff Schedule: the current revision from `reststop/releaseList` (exactly one entry has `status: current`) with its name as `publication_id`, title, publication and effective dates, the previous revision and the publisher's PDF/JSON file URLs. The publisher posts no hash and the API sends no ETag, so `content_hash` and `record_count` are null: `publication_id` is the change key (a new revision every ~2 weeks). Collection contract name: `source/status`.
- Instructions: Before or between `records_list` pages to learn the current revision, or to detect that the schedule moved to a new revision.
- Cost: 5 credits per call
- Capability file: [Source status](https://firecrawl.dev/alexandria/agents/providers/hts-usitc-gov/tariff-schedule/source_status)

Accepted options:

Response schema example:
```json
{
  "content_hash": null,
  "description": "2026 HTS Revision 21",
  "effective_from": "2026-10-09",
  "files": [
    {
      "format": "pdf",
      "name": "finalCopy",
      "note": "Complete HTS as published (PDF). Archived revisions and change records exist only as PDFs.",
      "url": "https://hts.usitc.gov/reststop/file?release=2026HTSRev21&filename=finalCopy"
    },
    {
      "format": "json",
      "name": "htsdata.json",
      "note": "Full-schedule JSON export, about 12.6 MB and 2 to 34 s; always the current revision (release= is ignored). records_list reads it one chapter at a time.",
      "url": "https://hts.usitc.gov/reststop/exportList?from=0100&to=9999&format=JSON&styles=false"
    },
    {
      "format": "csv",
      "name": "htsdata.csv",
      "note": "Full-schedule CSV export; same rows as the JSON export.",
      "url": "https://hts.usitc.gov/reststop/exportList?from=0100&to=9999&format=CSV&styles=false"
    }
  ],
  "previous_effective_to": "2026-10-09",
  "previous_publication_id": "2026HTSRev20",
  "publication_id": "2026HTSRev21",
  "published_date": "2026-10-07",
  "record_count": null,
  "retrieved_at": "2026-10-18T05:54:03Z",
  "revision_count": 184,
  "segment_key": "chapter",
  "source_url": "https://hts.usitc.gov/reststop/releaseList",
  "status": "current",
  "target_date": "2026-10-09",
  "title": "Revision 21 (2026)"
}
```
