{ "openapi": "3.0.1", "info": { "title": "ImportYeti Scraper | US Import Records & Bills of Lading", "description": "ImportYeti US import data: the latest bills of lading per importer (date, supplier, country, weight, containers, cargo description, route) or a company profile (top suppliers, HS codes, port lanes, monthly shipment trend). Watch competitors' suppliers with only-new mode. No login.", "version": "0.1", "x-build-id": "NT8vrxJEvVeakrKOh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_daemon~importyeti-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_daemon-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/data_daemon~importyeti-scraper/runs": { "post": { "operationId": "runs-sync-data_daemon-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/data_daemon~importyeti-scraper/run-sync": { "post": { "operationId": "run-sync-data_daemon-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": "Importers (US companies)", "type": "array", "description": "Company names or ImportYeti URLs, e.g. `Walmart`, `ikea-supply`, `https://www.importyeti.com/company/wal-mart`. A name is turned into the page address (`Ikea Supply` becomes /company/ikea-supply); if it is not found, copy the exact URL from importyeti.com.", "default": [], "items": { "type": "string" } }, "suppliers": { "title": "Suppliers (exporters)", "type": "array", "description": "Supplier names or ImportYeti supplier URLs, e.g. `https://www.importyeti.com/supplier/foxconn`. Shipments then list the US importers they ship to.", "default": [], "items": { "type": "string" } }, "output": { "title": "Output", "enum": [ "shipments", "profile" ], "type": "string", "description": "`shipments`: one row per recent bill of lading (the page lists the 50 newest). `profile`: one row per company with totals, top suppliers (or, for supplier pages, top US buyers), HS codes, port lanes and monthly shipments for up to the last 24 months that had shipments.", "default": "shipments" }, "shippedWithinDays": { "title": "Shipped within the last N days", "minimum": 0, "type": "integer", "description": "Shipments mode: keep bills of lading dated within the last N days." }, "maxShipmentsPerCompany": { "title": "Max shipments per company", "minimum": 1, "maximum": 50, "type": "integer", "description": "Up to 50 (ImportYeti shows the 50 newest bills of lading per company).", "default": 50 }, "topSuppliers": { "title": "Suppliers per profile", "minimum": 0, "maximum": 50, "type": "integer", "description": "Profile mode: how many suppliers (company pages) or US buyers (supplier pages) to include, up to 50, largest first.", "default": 20 }, "maxResults": { "title": "Max rows", "minimum": 0, "type": "integer", "description": "Stop after this many saved rows (default 100). 0 = no cap.", "default": 100 }, "onlyNewSinceLastRun": { "title": "Only new since the last run", "type": "boolean", "description": "Shipments: skip bills of lading delivered by earlier runs. Profiles: deliver a company again only after it has a newer shipment. Memory is kept in a key-value store named `importyeti-state` (skipped rows are not charged).", "default": false }, "stateName": { "title": "Memory name for only-new mode", "type": "string", "description": "By default it follows the output and the company list." }, "skipIds": { "title": "Ids to skip", "type": "array", "description": "Bill of lading numbers (shipments) or `company/` ids (profiles) you already have. Not saved, not charged.", "default": [], "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Usually not needed: ImportYeti pages answer Apify's servers directly; the Actor switches to Apify Proxy by itself if it is rate limited.", "default": { "useApifyProxy": 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 } } } } } } } } } }