# US HTS Tariff Monitor: Official Line Changes (`getascraper/us-hts-tariff-monitor`) Actor

Monitor official USITC Harmonized Tariff Schedule lines by HTS prefix or keyword. Get source-linked NEW and CHANGED tariff records for customs, trade compliance, and import operations in Apify, n8n, or Google Sheets.

- **URL**: https://apify.com/getascraper/us-hts-tariff-monitor.md
- **Developed by:** [GetAScraper](https://apify.com/getascraper) (community)
- **Categories:** Automation, Developer tools, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.31 / 1,000 tariff lines

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## 🧾 US HTS Tariff Monitor: Official Line Changes

<table width="100%" style="display:table;width:100%;border-collapse:collapse"><tr><td style="padding:24px 28px;background:#F0FDFA;border:1px solid #99F6E4;border-top:4px solid #0F766E;border-radius:12px"><span style="font-size:23px;font-weight:800;color:#134E4A;line-height:1.3">Keep the tariff lines that matter to your import operation in view.</span><br><span style="font-size:15px;color:#334155;line-height:1.6">Track current public USITC tariff lines by code prefix or description. Keep each matching line tied to its official source.</span></td></tr></table>

<table width="100%" style="display:table;width:100%;border-collapse:collapse;table-layout:fixed"><tr><td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #99F6E4;border-radius:10px 0 0 10px;vertical-align:top"><span style="font-size:15px;font-weight:800;color:#134E4A">🔢 Code watchlists</span><br><span style="font-size:12px;color:#334155">Follow specific tariff code prefixes.</span></td><td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #99F6E4;border-left:none;vertical-align:top"><span style="font-size:15px;font-weight:800;color:#134E4A">🔍 Description match</span><br><span style="font-size:12px;color:#334155">Narrow results with published tariff text.</span></td><td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #99F6E4;border-left:none;vertical-align:top"><span style="font-size:15px;font-weight:800;color:#134E4A">🔔 Change feed</span><br><span style="font-size:12px;color:#334155">Separate new and changed tariff lines.</span></td><td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #99F6E4;border-left:none;border-radius:0 10px 10px 0;vertical-align:top"><span style="font-size:15px;font-weight:800;color:#134E4A">🔗 Source-linked</span><br><span style="font-size:12px;color:#334155">Review the official line beside each record.</span></td></tr></table>

Track official USITC Harmonized Tariff Schedule lines by HTS prefix or description keyword. Build a source-linked watchlist for customs, trade compliance, or import operations.

### 🎯 What it does

The Actor reads the currently published USITC schedule and returns tariff lines that match your scope. It can return a current snapshot or only new and changed lines after a complete earlier run.

### 👥 Who it is for

- Customs and trade-compliance teams monitoring specific tariff families.
- Import operations teams maintaining internal HTS watchlists.
- Researchers who need a reproducible, source-linked tariff export.

### ⚙️ How it works

<table width="100%" style="display:table;width:100%;border-collapse:collapse;table-layout:fixed"><tr><td style="padding:16px 14px;width:33%;background:#F0FDFA;border:1px solid #99F6E4;border-radius:10px 0 0 10px;vertical-align:top"><span style="font-size:12px;font-weight:800;color:#0F766E;letter-spacing:1px">STEP 1</span><br><span style="font-size:14px;font-weight:700;color:#134E4A">Add code prefixes</span><br><span style="font-size:12px;color:#334155">Enter the tariff families you want to follow.</span></td><td style="padding:16px 14px;width:33%;background:#F0FDFA;border:1px solid #99F6E4;border-left:none;vertical-align:top"><span style="font-size:12px;font-weight:800;color:#0F766E;letter-spacing:1px">STEP 2</span><br><span style="font-size:14px;font-weight:700;color:#134E4A">Refine the match</span><br><span style="font-size:12px;color:#334155">Optionally add a description keyword.</span></td><td style="padding:16px 14px;width:33%;background:#F0FDFA;border:1px solid #99F6E4;border-left:none;border-radius:0 10px 10px 0;vertical-align:top"><span style="font-size:12px;font-weight:800;color:#0F766E;letter-spacing:1px">STEP 3</span><br><span style="font-size:14px;font-weight:700;color:#134E4A">Monitor the release</span><br><span style="font-size:12px;color:#334155">Schedule changes-only checks for the same scope.</span></td></tr></table>

### 🧾 Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| HTS code prefixes | Array | No | Two to ten digit HTS prefixes. Punctuation is accepted for readability. |
| Tariff description keyword | Text | No | Narrows matching lines by published description. |
| Published HTS release | Choice | No | Uses the current public USITC schedule. |
| Return new and changed tariff lines only | Boolean | No | Omits unchanged lines after a complete baseline run. |
| Maximum records | Number | No | Caps returned lines. A capped scope does not update saved state. |

### 📊 Output

| Field | Type | Description |
| --- | --- | --- |
| changeType | String | `CURRENT`, `NEW`, or `CHANGED`. |
| htsCode | String | Published HTS code. |
| description | String | Published tariff-line description. |
| generalRate | String | Published general duty rate. |
| additionalDuties | String | Published additional-duty text when available. |
| releaseName | String | Current source release name. |
| officialLineUrl | URL | Official USITC tariff-line link. |

### 💡 Good to know

- This Actor reads the currently published schedule. It does not calculate country-specific duty treatment or trade remedies.
- Use the same scope for scheduled change-only runs.
- A partial run does not replace the saved baseline.

### 💰 Pricing

This Actor uses pay per result. Empty runs do not create result charges. Start with a focused prefix to confirm the output fits your process.

### ⭐ Enjoying US HTS Tariff Monitor?

<table width="100%" style="display:table;width:100%;border-collapse:collapse"><tr><td style="padding:20px 24px 14px;background:#F0FDFA;border:1px solid #99F6E4;border-left:5px solid #0F766E;border-radius:10px 10px 0 0"><span style="font-size:20px;letter-spacing:4px;color:#B45309">⭐ ⭐ ⭐ ⭐ ⭐</span><br><span style="font-size:17px;font-weight:800;color:#134E4A">A focused tariff watchlist can save hours of release checking.</span><br><span style="font-size:14px;color:#334155">A 5-star rating helps other customs and trade-compliance teams find this Actor. Your feedback guides future improvements.</span></td></tr><tr><td style="padding:0;background:#0F766E;border:1px solid #99F6E4;border-top:none;border-radius:0 0 10px 10px;text-align:center"><a href="https://apify.com/getascraper/us-hts-tariff-monitor/reviews" style="display:block;padding:13px 16px;color:#FFFFFF;text-decoration:none;font-weight:800;font-size:15px;letter-spacing:0.3px">★&nbsp;&nbsp;Rate this Actor on Apify</a></td></tr></table>

### ❓ FAQ

**Can I search a full code?** Yes. Prefixes can contain two to ten digits.

**Does it provide legal advice?** No. Verify tariff treatment with your own qualified trade adviser.

**Why are unchanged lines missing?** Change-only mode omits them after a complete baseline run.

**Can I schedule a watchlist?** Yes. Schedule the same saved input in Apify.

### 🔗 Other actors

- [SAM.gov Contract Monitor](https://github.com/Devansh-365/actorstack/tree/main/actors/sam-gov-contract-monitor)
- [EU TED Tender Monitor](https://github.com/Devansh-365/actorstack/tree/main/actors/eu-ted-tender-monitor)
- [SEC EDGAR RAG Extractor](https://github.com/Devansh-365/actorstack/tree/main/actors/sec-edgar-rag-extractor)
- [SEC Form D Funding Monitor](https://github.com/Devansh-365/actorstack/tree/main/actors/sec-form-d-funding-monitor)

# Actor input Schema

## `codePrefixes` (type: `array`):

US HTS prefixes to monitor. Use 2 to 10 digits per entry, with punctuation allowed for readability.

## `keyword` (type: `string`):

Optional description word to narrow matching tariff lines. Leave blank when code prefixes are enough.

## `release` (type: `string`):

Use the current USITC release. The public line-data surface is intentionally limited to the currently published schedule.

## `changesOnly` (type: `boolean`):

Emit a NEW baseline on the first complete run, then omit unchanged tariff lines on later complete runs.

## `maxRecords` (type: `integer`):

Cap the returned tariff lines. A cap that cuts off matching lines is reported and does not update monitor state.

## Actor input object example

```json
{
  "codePrefixes": [
    "0901"
  ],
  "keyword": "",
  "release": "current",
  "changesOnly": false,
  "maxRecords": 10
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

## `runSummary` (type: `string`):

No description

## `monitorState` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "codePrefixes": [
        "0901"
    ],
    "keyword": "",
    "release": "current",
    "changesOnly": false,
    "maxRecords": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("getascraper/us-hts-tariff-monitor").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "codePrefixes": ["0901"],
    "keyword": "",
    "release": "current",
    "changesOnly": False,
    "maxRecords": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("getascraper/us-hts-tariff-monitor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "codePrefixes": [
    "0901"
  ],
  "keyword": "",
  "release": "current",
  "changesOnly": false,
  "maxRecords": 10
}' |
apify call getascraper/us-hts-tariff-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,getascraper/us-hts-tariff-monitor"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/JUwk8UzBk14zQ80zN/builds/YaLDzXTzeNh2P67du/openapi.json