{ "openapi": "3.0.1", "info": { "title": "US Tariff Schedule Scraper - HTS Codes & Duty Rates", "description": "One row per line of the US Harmonized Tariff Schedule: HTS code, description, unit of quantity, general rate of duty, special rates with the countries they cover, and the column 2 rate. Every row names the edition it came from. Keyless, no browser, no account.", "version": "0.1", "x-build-id": "zmgpr0ZTmSwfDqXoK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~hts-customs-duty-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-hts-customs-duty-scraper", "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/dami_studio~hts-customs-duty-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-hts-customs-duty-scraper", "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/dami_studio~hts-customs-duty-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-hts-customs-duty-scraper", "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", "properties": { "chapters": { "title": "Chapters", "minItems": 0, "maxItems": 120, "type": "array", "description": "Chapters of the tariff schedule to read, as numbers: 61 is knitted apparel, 84 is machinery, 87 is vehicles, 99 holds the temporary modifications. Ranges work too - write 61-63. Chapter 77 is reserved in the Harmonized System and has no lines.", "items": { "type": "string" } }, "hsCodes": { "title": "HTS codes", "minItems": 0, "maxItems": 200, "type": "array", "description": "Specific codes, at any depth. 8471 gives you the whole heading, 8471.30 the subheading, 6101.20.00.10 that one statistical line. Dots are optional. The run reads the chapter each code sits in and keeps the lines that start with it.", "items": { "type": "string" } }, "searchTerms": { "title": "Search terms", "minItems": 0, "maxItems": 10, "type": "array", "description": "Words to look up in the schedule's own index, like \"laptop\" or \"olive oil\". The matching codes come back as full rows with their duty rates and the description path above them. The index is broad - searching \"cotton shirt\" also returns cotton seed - so check the descriptions.", "items": { "type": "string" } }, "allChapters": { "title": "Read the whole schedule", "type": "boolean", "description": "Reads every chapter from 01 to 99 in order. That is about 29,900 numbered lines, so raise the row limit to match or you will get the first slice of it. This costs you one charge per row." }, "includeLines": { "title": "Which lines to return", "enum": [ "all", "withDutyRate", "statisticalOnly" ], "type": "string", "description": "The schedule is a tree. \"all\" returns every numbered line, including the 4-digit headings and 6-digit subheadings that hold the structure but print no rate. \"withDutyRate\" drops those and keeps the 8- and 10-digit lines. \"statisticalOnly\" keeps just the 10-digit lines, the ones that go on an entry." }, "maxItems": { "title": "Maximum rows", "minimum": 1, "maximum": 40000, "type": "integer", "description": "How many tariff lines to return. Keep it low while you are testing - you pay per row. The whole schedule is about 29,900 numbered lines, and the hard ceiling is 40,000." }, "requireEdition": { "title": "Only accept this edition", "type": "string", "description": "Optional. Put an edition name here, like 2026HTSRev19, and the run will refuse to return anything if the live schedule is a different edition. Useful on a schedule, where a revision landing overnight would otherwise change your rates without anyone noticing. Leave it empty to take whatever is current." }, "proxyUrls": { "title": "Your own proxy servers (optional)", "minItems": 0, "maxItems": 50, "type": "array", "description": "Leave this empty for a normal run. Fill it in only if you want the traffic to leave through proxy servers you already pay for, one URL per line, in the form http://user:pass@host:port.", "items": { "type": "string" } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }