# US Tariff Exposure & Landed-Cost Analyzer (`maxwiles/us-tariff-exposure-analyzer`) Actor Stacks every current US duty layer (base/MFN + Section 301 + 232 + 122) into a true effective rate and landed cost for each HTS code + country of origin, and flags the cheapest alternative sourcing country. Bulk-screen a catalog or schedule it as an exposure monitor. - **URL**: https://apify.com/maxwiles/us-tariff-exposure-analyzer.md - **Developed by:** [Max Wiles](https://apify.com/maxwiles) (community) - **Categories:** E-commerce, AI, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $50.00 / 1,000 product analyzeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 Tariff Exposure & Sourcing Comparison Engine **Get the true stacked US import duty — not just a lookup.** This Actor stacks every current US duty layer (base/MFN + Section 301 + Section 232 + Section 122) into a single effective rate, computes the landed cost, and compares alternative sourcing countries so you can see exactly what you save by moving from China to Vietnam, Mexico, India, or anywhere else. Most tariff tools return one rate. This one returns the *real* number — and tells you which country is cheapest to source from. --- ### What it does - **Full duty stack** — base/MFN + Section 301 (China) + Section 232 (steel/aluminum/copper) + Section 122 global surcharge, correctly combined on the customs value. Not a single-layer lookup. - **Sourcing comparison** — compares any alternative origin countries you supply and returns the cheapest, with the % saving. The core use case: "I'm sourcing from China at 88% effective duty — what do I pay from Vietnam?" - **Landed cost** — adds Merchandise Processing Fee, Harbor Maintenance Fee (ocean), and optional freight/insurance on top of the duty stack. Real landed cost, not just the tariff. - **Bulk catalog screening** — pass an array of products and get one clean output row per line. Screen a whole catalog in one run. - **Monitoring mode** — schedule it on your key HTS codes. Rerun weekly to catch rate changes, new exclusions, or surcharge status changes. - **Confidence classification** — every result is classified VERIFIED, PARTIAL, or LOW_CONFIDENCE. LOW_CONFIDENCE results are suppressed rather than shown — the tool warns you rather than returns a confident wrong number. --- ### Who this is for - **Importers and sourcing teams** pricing a shipment or evaluating a supply-chain move - **Customs brokers** doing rapid exposure checks across a client's catalog - **E-commerce sellers** exposed to China tariffs (Section 301) who need to know if moving origin makes financial sense - **Procurement analysts** monitoring tariff exposure across a product portfolio - **Developers and AI agents** needing a programmatic tariff-exposure API — fully compatible with pay-per-event agentic workflows --- ### Why this is different from other tariff tools on the Store Existing tools return a single rate from a single source. This one: 1. **Stacks all four layers** — the rate you actually pay at the border is base + 301 + 232 + 122. Each has different applicability rules. This engine applies all of them and handles the anti-stacking rules (Section 122 does not stack on Section 232). 2. **Uses dual-source 301 verification** — Section 301 applicability is cross-checked between the USITC footnote and the USTR 2024-review Annex A list, catching codes the USITC footnote misses (e.g. the 100% syringe/needle tariff). 3. **Tracks the current legal reality, not just the HTS** — the IEEPA tariffs were struck down in February 2026 and are no longer collected; this engine applies the replacement Section 122 surcharge with its expiry date and litigation status, not the defunct IEEPA provision still listed in the HTS. 4. **Compares sourcing countries** — not just "what's the rate" but "what's the cheapest country to source from and how much do I save." 5. **Degrades honestly** — when the engine can't fully confirm a rate, it says so rather than returning a plausible-looking wrong number. --- ### Input ```json { "products": [ { "htsCode": "8507.60.0020", "originCountry": "CN", "customsValueUsd": 120000, "shipMode": "ocean" }, { "htsCode": "7213.10.0000", "originCountry": "CN", "customsValueUsd": 50000, "shipMode": "ocean" } ], "alternativeOrigins": ["VN", "MX", "IN", "TH"], "includeFees": true, "freightInsurancePctOfValue": 8 } ```` | Field | Required | Description | |---|---|---| | `htsCode` | Yes | 8 or 10 digit HTS code (dots optional) | | `originCountry` | Yes | ISO-2 country code (e.g. CN, VN, MX) | | `customsValueUsd` | No | Customs value in USD — required for landed cost | | `shipMode` | No | `ocean` (default) or `air` — affects HMF fee | | `alternativeOrigins` | No | Array of ISO-2 codes to compare against | | `includeFees` | No | Include MPF + HMF in landed cost (default: true) | | `freightInsurancePctOfValue` | No | Freight + insurance as % of customs value (default: 0) | *** ### Output One row per product line. Key fields: | Field | Description | |---|---| | `htsCode` | Resolved 8-digit HTS code | | `originCountry` | Origin as supplied | | `productDescription` | Description from USITC HTS | | `baseRatePct` | MFN/general duty rate | | `section301Pct` | Section 301 additional duty | | `section232Pct` | Section 232 additional duty | | `section122Pct` | Section 122 global surcharge | | `effectiveDutyPct` | Total stacked effective duty rate | | `landedCost` | Full landed cost in USD (if value supplied) | | `landedCostMultiple` | Landed cost as multiple of customs value | | `cheapestAlternativeOrigin` | ISO-2 code of cheapest alternative | | `cheapestAlternativeEffectivePct` | Effective rate at that origin | | `savingsVsCurrentPct` | Duty saving vs current origin | | `confidence` | VERIFIED / PARTIAL / LOW\_CONFIDENCE | | `section301Source` | Provenance of 301 rate | | `layers` | Array of individual duty layers that fired | | `disclaimer` | Decision-support disclaimer (always present) | *** ### Verified examples | Product | Origin | Effective rate | Confidence | |---|---|---|---| | Steel wire rod (7213.10) | China | 75% (Free + 25% S301 + 50% S232) | VERIFIED | | Li-ion battery (8507.60) | China | 38.4% (3.4% base + 25% S301 enhanced + 10% S122) | VERIFIED | | Aluminum sheet (7606.12) | China | 78% (3% + 25% S301 + 50% S232) | VERIFIED | | Aluminum sheet (7606.12) | UK | 28% (3% + 25% S232 UK rate) | VERIFIED | | Hypodermic syringes (9018.31) | China | 110% (Free + 100% S301 enhanced + 10% S122) | PARTIAL\* | | Laptops (8471.30) | China | base only — S301 List 4B suspended | VERIFIED | | Li-ion battery (8507.60) | Vietnam | 13.4% (base + S122 only, no S301) | VERIFIED | \*PARTIAL: rate is correct but sourced from USTR Annex A list without USITC footnote confirmation. *** ### Coverage and known limitations **Fully covered:** - Section 301: all four Lists including 2024-review enhanced rates (EVs 100%, solar 50%, semiconductors 50%, batteries 25%), dual-source verified - Section 232: primary steel (ch. 72/73), aluminum (ch. 76), copper (ch. 74), and their chapter-level derivatives - Section 122 global surcharge: modeled with expiry date (July 24, 2026) and litigation status - Alternative-origin comparison: any ISO-2 country, with correct country-specific 232 rates (e.g. UK at 25% vs 50%) - Anti-stacking: Section 122 correctly suppressed where Section 232 applies **Known gap — out-of-chapter S232 derivatives:** Section 232 derivatives classified outside chapters 72–76 (e.g. certain goods in chapters 84, 85, 87) return a PARTIAL result with a "possible additional S232 derivative duty — requires manual verification" flag rather than a rate. The HTS code→tier mapping for these (50% Annex I-A vs 25% Annex I-B under Proclamation 11021) exists only in image-format proclamation annexes with no machine-readable equivalent. Primary metals and their chapter-73/76-classified derivatives are unaffected. If your product is outside chapters 72–76 and you believe it may be a steel or aluminum derivative, verify the applicable rate with a licensed customs broker. *** ### Data sources All sources are public and require no API key: - **USITC HTS** (`hts.usitc.gov`) — base/MFN rates and Chapter 99 cross-references - **USTR Section 301 lists** — FR 2024-21217 Annex A (2024-review enhanced rates) - **Section 232 proclamations** — Proclamations 10895/10896 (Feb 2025), 11021 (Apr 2026) - **Section 122** — Proclamation 11012 (Feb 2026) - **Federal Register API** — change detection feed for rate/exclusion updates - **CBP** — MPF/HMF fee rates *** ### Pricing Pay-per-event: charged per product line analyzed. Rates visible in the monetization panel. A LOW\_CONFIDENCE suppressed result is not charged. *** ### Scheduling / monitoring Schedule this Actor daily or weekly on your key product codes to catch rate changes. The built-in Federal Register feed surfaces new USTR/232/122 notices so you know when a manual review is warranted. This is the core recurring-value use case: tariff rules change constantly, and your exposure changes with them. *** ### Accuracy and compliance disclaimer This Actor is **decision-support tooling, not customs or legal advice.** Tariff classification carries real liability — rates depend on correct HTS classification, country-of-origin rules, and entry-specific facts that cannot be determined programmatically. Verify high-stakes classifications with a licensed customs broker or trade attorney before relying on these figures for entry or pricing decisions. The duty stack reflects the rules as understood at the time of the last data update. Tariff rules change by proclamation and court ruling with no fixed schedule. The VERIFIED/PARTIAL/LOW\_CONFIDENCE confidence classification indicates the engine's certainty about a given result, not a legal determination. *** *Keywords: US tariff calculator, Section 301 tariff lookup, China tariff 2026, Section 232 steel aluminum tariff, Section 122 surcharge, HTS code duty rate, landed cost calculator, import duty stacking, alternative sourcing comparison, tariff exposure analysis, China vs Vietnam tariff, supply chain tariff risk, HTS code API, customs duty calculator, HTSUS Chapter 99, tariff monitoring, importer duty exposure, sourcing optimization* # Actor input Schema ## `products` (type: `array`): Each item is one product line. Provide an htsCode (8 or 10 digits) and an originCountry (ISO-2, e.g. CN, VN, MX). Optionally add customsValueUsd (for landed-cost), and shipMode ('ocean' or 'air') for the harbor fee. Don't know your HTS code? Look it up free at hts.usitc.gov — search by product name or description. ## `alternativeOrigins` (type: `array`): ISO-2 country codes to test as alternative sourcing for every product. The actor reports which of these yields the lowest stacked effective rate. ## `includeFees` (type: `boolean`): Merchandise Processing Fee and (ocean only) Harbor Maintenance Fee. Rates are configured in src/tariffEngine.js and must be kept current. ## `freightInsurancePctOfValue` (type: `integer`): Optional flat estimate added to landed cost (e.g. 8 = 8%). Set 0 to exclude. ## Actor input object example ```json { "products": [ { "htsCode": "7213.10.00", "originCountry": "CN", "customsValueUsd": 50000, "shipMode": "ocean" }, { "htsCode": "8507.60.00", "originCountry": "CN", "customsValueUsd": 120000, "shipMode": "ocean" } ], "alternativeOrigins": [ "VN", "MX", "IN", "TH" ], "includeFees": true, "freightInsurancePctOfValue": 0 } ``` # Actor output Schema ## `results` (type: `string`): Stacked duty rates, landed costs, and sourcing comparisons per product line. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "products": [ { "htsCode": "7213.10.00", "originCountry": "CN", "customsValueUsd": 50000, "shipMode": "ocean" }, { "htsCode": "8507.60.00", "originCountry": "CN", "customsValueUsd": 120000, "shipMode": "ocean" } ], "alternativeOrigins": [ "VN", "MX", "IN", "TH" ] }; // Run the Actor and wait for it to finish const run = await client.actor("maxwiles/us-tariff-exposure-analyzer").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "products": [ { "htsCode": "7213.10.00", "originCountry": "CN", "customsValueUsd": 50000, "shipMode": "ocean", }, { "htsCode": "8507.60.00", "originCountry": "CN", "customsValueUsd": 120000, "shipMode": "ocean", }, ], "alternativeOrigins": [ "VN", "MX", "IN", "TH", ], } # Run the Actor and wait for it to finish run = client.actor("maxwiles/us-tariff-exposure-analyzer").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "products": [ { "htsCode": "7213.10.00", "originCountry": "CN", "customsValueUsd": 50000, "shipMode": "ocean" }, { "htsCode": "8507.60.00", "originCountry": "CN", "customsValueUsd": 120000, "shipMode": "ocean" } ], "alternativeOrigins": [ "VN", "MX", "IN", "TH" ] }' | apify call maxwiles/us-tariff-exposure-analyzer --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=maxwiles/us-tariff-exposure-analyzer", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "US Tariff Exposure & Landed-Cost Analyzer", "description": "Stacks every current US duty layer (base/MFN + Section 301 + 232 + 122) into a true effective rate and landed cost for each HTS code + country of origin, and flags the cheapest alternative sourcing country. Bulk-screen a catalog or schedule it as an exposure monitor.", "version": "0.1", "x-build-id": "Kflz5c3DTPQ5tZH9R" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maxwiles~us-tariff-exposure-analyzer/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maxwiles-us-tariff-exposure-analyzer", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/maxwiles~us-tariff-exposure-analyzer/runs": { "post": { "operationId": "runs-sync-maxwiles-us-tariff-exposure-analyzer", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/maxwiles~us-tariff-exposure-analyzer/run-sync": { "post": { "operationId": "run-sync-maxwiles-us-tariff-exposure-analyzer", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "products" ], "properties": { "products": { "title": "Products to analyze", "type": "array", "description": "Each item is one product line. Provide an htsCode (8 or 10 digits) and an originCountry (ISO-2, e.g. CN, VN, MX). Optionally add customsValueUsd (for landed-cost), and shipMode ('ocean' or 'air') for the harbor fee. Don't know your HTS code? Look it up free at hts.usitc.gov — search by product name or description." }, "alternativeOrigins": { "title": "Alternative origin countries to compare", "type": "array", "description": "ISO-2 country codes to test as alternative sourcing for every product. The actor reports which of these yields the lowest stacked effective rate.", "items": { "type": "string" } }, "includeFees": { "title": "Include MPF + HMF customs fees in landed cost", "type": "boolean", "description": "Merchandise Processing Fee and (ocean only) Harbor Maintenance Fee. Rates are configured in src/tariffEngine.js and must be kept current.", "default": true }, "freightInsurancePctOfValue": { "title": "Freight + insurance as % of customs value", "minimum": 0, "maximum": 100, "type": "integer", "description": "Optional flat estimate added to landed cost (e.g. 8 = 8%). Set 0 to exclude.", "default": 0 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```