{ "openapi": "3.0.1", "info": { "title": "ImportYeti Scraper - US Import Records & Shipment Monitor", "description": "For sales pipelines, supplier sourcing and competitor watchlists: ImportYeti company and supplier pages - US customs bill of lading records, top suppliers or customers, the 50 latest shipments, HS/HTS codes, ports, trade lanes and carriers. Monitor: only companies with new shipments or suppliers.", "version": "0.1", "x-build-id": "rDh2u15bR8JeKBFab" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~importyeti-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-importyeti-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/neverempty~importyeti-scraper/runs": { "post": { "operationId": "runs-sync-neverempty-importyeti-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/neverempty~importyeti-scraper/run-sync": { "post": { "operationId": "run-sync-neverempty-importyeti-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": { "companies": { "title": "ImportYeti company or supplier pages", "type": "array", "description": "One per line: an ImportYeti company page URL (https://www.importyeti.com/company/tesla), a supplier page URL (https://www.importyeti.com/supplier/citic-dicastal) or a company name (\"Tesla\" is read as importyeti.com/company/tesla). Company pages list that US importer's suppliers; supplier pages list that supplier's US customers. Up to 20 pages per run: ImportYeti asks for a login after about 25 page views from one IP address, and this Actor does not work around that. Search pages are not read (ImportYeti's robots.txt disallows them), so a name that does not match ImportYeti's own page name comes back as a free not-found row; paste the page URL instead. If empty, the example company Tesla is used.", "items": { "type": "string" } }, "maxRecentShipments": { "title": "Latest shipments per company", "minimum": 0, "maximum": 50, "type": "integer", "description": "How many of the latest bills of lading shown on the page to include in recentShipments (date, bill of lading number, supplier or customer, weight, containers, product description, route). 0 to 50; ImportYeti shows up to 50 on the public page. Monitor mode always compares all of them.", "default": 50 }, "maxTradingPartners": { "title": "Top suppliers (or customers) per company", "minimum": 0, "maximum": 50, "type": "integer", "description": "How many rows of the page's supplier table (on a supplier page: customer table) to include in tradingPartners, largest first. 0 to 50; ImportYeti shows up to 50.", "default": 50 }, "onlyChanges": { "title": "Monitor mode: only companies with new shipments or new suppliers", "type": "boolean", "description": "Return only companies that have a new bill of lading, or a new supplier (customer on a supplier page) whose first shipment is in the quarter of the last check or later, since the last run with the same watch name. The new ones are listed in newShipments and newPartners (new shipments are counted among the up to 50 latest bills of lading the page shows; a shipment dated on or before the oldest one seen last time is not called new). The first run returns every company as the starting point. A run in which nothing changed returns a free row saying so and charges only the run start fee.", "default": false }, "watchName": { "title": "Watch name", "type": "string", "description": "Name of the remembered state used to compare runs (letters, digits, dot, dash, underscore; up to 40). Setting it (or turning on monitor mode) fills changeType, newShipments and the previous columns. Use a different name for each list of companies you track on its own schedule. With monitor mode on and no name, the name \"default\" is used." }, "resetMonitoringState": { "title": "Forget what this watch remembered", "type": "boolean", "description": "Start this watch over: forget the remembered shipments before this run, so every company is returned as a first check.", "default": false } } }, "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 } } } } } } } } } }