{ "openapi": "3.0.1", "info": { "title": "Customs Ruling Finder, HTS Classification Precedent", "description": "Search CBP customs rulings by product or tariff code, keyless. See which HTS code Customs actually assigned, read the full ruling, and know whether it was revoked or modified before you cite it. Codes are reformatted automatically so tariff-schedule codes actually match.", "version": "0.1", "x-build-id": "tmuk7V9DEcpTZn4XB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapemint~customs-ruling-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapemint-customs-ruling-finder", "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/scrapemint~customs-ruling-finder/runs": { "post": { "operationId": "runs-sync-scrapemint-customs-ruling-finder", "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/scrapemint~customs-ruling-finder/run-sync": { "post": { "operationId": "run-sync-scrapemint-customs-ruling-finder", "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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Product names or tariff codes, for example \"integrated solar panel\" or \"6109.10.0040\". Codes are reformatted automatically: CROSS groups ten digits 4.2.4, so a code copied from the tariff schedule in 4.2.2.2 form would otherwise return nothing.", "default": [], "items": { "type": "string" } }, "rulingNumbers": { "title": "Ruling numbers", "type": "array", "description": "Fetch specific rulings directly, for example N160415 or H305865. These always return the full ruling text, because that is the only thing the ruling endpoint serves.", "default": [], "items": { "type": "string" } }, "collection": { "title": "Collection", "enum": [ "ALL", "ny", "hq" ], "type": "string", "description": "New York rulings are the high-volume classification rulings. Headquarters rulings carry more weight and often decide contested questions.", "default": "ALL" }, "sortBy": { "title": "Sort order", "enum": [ "DATE_DESC", "RELEVANCE" ], "type": "string", "description": "Newest first is the default because relevance order returns 1990s rulings ahead of current ones.", "default": "DATE_DESC" }, "dateFrom": { "title": "From ruling date", "type": "string", "description": "Earliest ruling date as YYYY-MM-DD. CBP has no server-side date filter, so this is applied after fetching and rulings with no recorded date are excluded." }, "dateTo": { "title": "To ruling date", "type": "string", "description": "Latest ruling date as YYYY-MM-DD." }, "onlyCurrentPrecedent": { "title": "Skip superseded rulings", "type": "boolean", "description": "Drop rulings that CROSS records as revoked or modified. CBP returns those alongside live ones with nothing to tell them apart, and citing one is a real problem at entry.", "default": false }, "includeFullText": { "title": "Include full ruling text", "type": "boolean", "description": "Fetch the complete ruling body: the reasoning, the product description CBP worked from, and the classification it landed on. Costs one extra request per ruling and is charged at the higher rate.", "default": false }, "newOnly": { "title": "Monitor mode: new rulings only", "type": "boolean", "description": "Remember rulings already returned and emit only ones not seen before. Pair it with newest-first sorting and a saved search to watch for new precedent on your products. Quiet runs cost nothing.", "default": false }, "maxRows": { "title": "Max rows", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stop after this many rulings.", "default": 100 } } }, "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 } } } } } } } } } }