{ "openapi": "3.0.1", "info": { "title": "US Tariff Scraper - US Import Tariff API, HTS Codes & Duty", "description": "For importers, customs brokers and landed-cost tools: official USITC tariff lines with duty rates as numbers you can calculate with. 10-digit statistical lines come back with a rate - in the raw schedule all 35 lines under heading 6109 are blank. No API key.", "version": "0.1", "x-build-id": "AO6ZbAhtuvzsk5Xd0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~us-import-tariff-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-us-import-tariff-api", "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/neverempty~us-import-tariff-api/runs": { "post": { "operationId": "runs-sync-neverempty-us-import-tariff-api", "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/neverempty~us-import-tariff-api/run-sync": { "post": { "operationId": "run-sync-neverempty-us-import-tariff-api", "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": { "codes": { "title": "HTS numbers", "type": "array", "description": "HTS numbers with 4, 6, 8 or 10 digits, with or without dots: \"0901\", \"6109.10\", \"0901.11.00.15\". Each one returns the tariff lines under it. If you give values and none of them are usable, the run fails rather than quietly returning a default. Only when both this field and the keyword are empty does the run use the example 0901 (coffee), and it says so in each row. If this field holds only the example 0901 and you type a keyword, the example is skipped (and a free row says so); add another code next to it if you really want 0901.", "items": { "type": "string" } }, "keyword": { "title": "Keyword (optional)", "type": "string", "description": "Search the tariff schedule for a word, for example \"espresso\" or \"t-shirts\". Only lines whose description (including the headings above them) contains every word you type are returned, so \"t-shirts\" does not return lines that merely have t (tons) as their unit. Plurals and hyphens are treated alike: \"t-shirts\", \"T-shirt\" and \"t shirts\" are the same search. A broad word can return hundreds of lines, up to maxRowsPerCode (500 by default; at $0.015 per line that is about $7.50). Try a small maxRowsPerCode first, or narrow the search with HTS numbers. Can be used on its own or together with HTS numbers.", "default": "" }, "includeHeadings": { "title": "Include headings without a rate", "type": "boolean", "description": "Off by default: only lines with 8 or 10 digits, which are the ones that carry a duty rate. Turn on to also get the 4 and 6 digit headings and the wording rows above them.", "default": false }, "maxRowsPerCode": { "title": "Maximum rows per code", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Upper bound per HTS number, and for the keyword search, so a whole chapter cannot run up a bill. A 4 digit heading usually has 10 to 60 lines. A keyword search with a broad word can reach the full 500 (at $0.015 per line, about $7.50): try a small number first.", "default": 500 }, "maxRetries": { "title": "Retries", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many times to retry when USITC does not answer. A rejected request is not retried.", "default": 4 } } }, "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 } } } } } } } } } }