# ImportYeti Scraper (Cheap) (`data_api/importyeti-scraper-cheap`) Actor ImportYeti scraper that collects supplier lists, shipment counts, and HS code data for any U.S. importer, so you can map a competitor's supply chain in seconds. - **URL**: https://apify.com/data\_api/importyeti-scraper-cheap.md - **Developed by:** [Data API](https://apify.com/data_api) (community) - **Categories:** Developer tools, Lead generation, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.99 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## ImportYeti Supplier Scraper ![ImportYeti Supplier Scraper](cover.jpg) Finding out who actually ships goods to a company usually means clicking through ImportYeti one supplier at a time. This scraper does it in one pass. Give it an importer slug and you get back the company profile, its full supplier list, shipment counts, HS code mix, and shipping spend, all as clean fields you can drop straight into a spreadsheet or a model. No code, low cost, and you only pay for the profiles you pull. ### What you get Each importer comes back as one row that bundles three kinds of data: - **Company profile** — `importerName`, `alternateNames`, `importerAddress`, `importerCountry`, `importerWebsite`, `profileUrl`, `importerSlug`, and a short `profileSummary` - **Shipping activity** — `shipmentsTotal`, `shipmentsLastYear`, `shippingSpendUsd`, `leadSupplierName`, `leadSupplierCountry`, and `dataRefreshedOn` - **Supplier and trade detail** — `supplierList` (per-supplier shipments, weight, TEU, and country), `hsCodeBreakdown` (product categories by HS code), and `continentBreakdown` (shipments grouped by continent) ### Quick start 1. Open the importer on importyeti.com and copy the slug from the URL — it's the part after `/company/`. 2. Hit **Try for free** and paste the slug into **Importer slugs**. Add as many as you like. 3. Set a **Results limit** to cap how many profiles you pull in one run. 4. Press **Start**, then export the results as JSON, CSV, Excel, or XML. ![How it works](how-it-works.jpg) ### Use cases - **Supply chain mapping** — see who supplies a competitor and how concentrated their sourcing is - **Lead generation** — turn a list of importers into a contact sheet of overseas suppliers - **Procurement research** — find alternative suppliers already shipping to firms like yours - **Market sizing** — gauge import volume by shipment counts, weight, and TEU across continents - **Trade compliance** — pull HS code mixes to understand what categories a company brings in ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `importerSlugs` | array of strings | Yes | ImportYeti company slugs to look up, taken from `importyeti.com/company/{slug}`. Prefilled with `target`. | | `resultsLimit` | integer | No | How many importer profiles to pull per run. Default `50`. | | `timeoutSeconds` | integer | No | Seconds to wait on each request before it times out. Default `45`. | #### Example input ```json { "importerSlugs": ["target", "costco-wholesale"], "resultsLimit": 50, "timeoutSeconds": 45 } ```` ### Output Every slug becomes one row. The profile fields and headline numbers sit at the top level, with the detailed supplier, HS code, and continent breakdowns nested as arrays. Fields ImportYeti does not publish for a given company come back empty rather than guessed; a row that fails to load carries an `errorMessage` and keeps the rest of the fields blank. #### Example output ```json { "importerSlug": "target", "importerName": "Target Corporation", "alternateNames": ["Target Stores", "Target Brands Inc"], "importerAddress": "1000 Nicollet Mall, Minneapolis, MN 55403", "importerCountry": "United States", "importerWebsite": "https://www.target.com", "profileUrl": "https://www.importyeti.com/company/target", "shipmentsTotal": 184302, "shipmentsLastYear": 21540, "shippingSpendUsd": 48750000.0, "leadSupplierName": "Shenzhen Sunrise Industrial Co Ltd", "leadSupplierCountry": "China", "dataRefreshedOn": "2026-06-01", "profileSummary": "Target Corporation is a major U.S. retailer importing home goods, apparel, and electronics from suppliers across Asia.", "supplierList": [ { "vendorName": "Shenzhen Sunrise Industrial Co Ltd", "vendorAddress": "Bao'an District, Shenzhen, Guangdong", "country": "China", "countryCode": "CN", "shipments12m": 1320, "totalShipments": 9870, "totalWeightKg": 4521000.0, "totalTeu": 1840, "hsCodes": ["9503", "6307"], "productSample": "Plush toys, textile home decor, seasonal goods", "importYetiUrl": "https://www.importyeti.com/supplier/shenzhen-sunrise-industrial" } ], "hsCodeBreakdown": [ { "hsCode": "9503", "productCategory": "Toys and games", "shipments": 5210, "weightKg": 1840000.0, "teu": 720 } ], "continentBreakdown": [ { "continent": "Asia", "totalShipments": 158900 } ], "collectedAt": "2026-06-29T12:00:00.000000+00:00", "errorMessage": null } ``` #### Output fields | Field | Type | Description | |-------|------|-------------| | `importerSlug` | string | The company slug used for the lookup | | `importerName` | string | Registered name of the importing company | | `alternateNames` | array | Other names the company trades under | | `importerAddress` | string | Headquarters or registered address | | `importerCountry` | string | Country the importer is based in | | `importerWebsite` | string | Company website, normalised to a full https URL | | `profileUrl` | string | Link to the ImportYeti profile page | | `shipmentsTotal` | integer | All-time shipment count on record | | `shipmentsLastYear` | integer | Shipments in the trailing 12 months | | `shippingSpendUsd` | number | Estimated shipping spend in US dollars | | `leadSupplierName` | string | Name of the top supplier by volume | | `leadSupplierCountry` | string | Country of the top supplier | | `dataRefreshedOn` | string | Date ImportYeti last refreshed the data | | `profileSummary` | string | Short summary pulled from the page meta description | | `supplierList` | array | Per-supplier rows: name, address, country, shipments, weight, TEU, HS codes, and profile link | | `hsCodeBreakdown` | array | Product categories by HS code with shipment, weight, and TEU totals | | `continentBreakdown` | array | Shipment counts grouped by continent | | `collectedAt` | string | ISO 8601 timestamp of when the row was captured | | `errorMessage` | string | Reason a profile failed to load; null on success | ### Tips for best results - **Get the slug right.** It's the exact text after `/company/` in the importyeti.com URL, lowercase with hyphens. A wrong slug returns an `errorMessage` row. - **Batch your slugs.** Drop several into `importerSlugs` in one run; the actor pauses briefly between profiles to stay polite. - **Use `resultsLimit` for test runs.** Start small to confirm the output fits your pipeline, then raise it for a bigger pull. - **Big importers carry long supplier lists.** `supplierList` is capped at the top 50 suppliers and `hsCodeBreakdown` at the top 20 codes, so the heaviest profiles stay manageable. - **Raise `timeoutSeconds`** if large profiles occasionally time out. ### How can I use ImportYeti supplier data? **How can I use the ImportYeti Supplier Scraper to map a competitor's supply chain?** Pass the competitor's slug and read `supplierList` alongside `leadSupplierName` and `continentBreakdown`. You get every supplier on record with shipment counts and countries, so you can see how concentrated or diversified their sourcing really is. **How can I find new overseas suppliers from ImportYeti data?** Pull a handful of importers in your category, then pool their `supplierList` rows. Each carries `vendorName`, `country`, and an `importYetiUrl`, which gives you a ready shortlist of factories already shipping to companies like yours. **How can I export ImportYeti shipment data to a spreadsheet?** Run the scraper with your slugs and export to CSV or Excel. Headline numbers like `shipmentsTotal`, `shipmentsLastYear`, and `shippingSpendUsd` land in their own columns, and the nested arrays come through as structured data you can flatten for analysis. **How can I research import volume by HS code?** Read `hsCodeBreakdown` for any importer to see which product categories they bring in, with shipments, weight, and TEU per code. It's a quick way to size a category or check what a company actually ships. ### Is it legal to scrape data? Our actors are ethical and do not extract any private user data, such as email addresses or private contact information. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). ### Support Questions, feature requests, or a field you'd like added? Reach out at and we'll get back to you. # Actor input Schema ## `importerSlugs` (type: `array`): ImportYeti company slugs to look up. The slug is the last part of the profile URL: importyeti.com/company/{slug}. For example, the Target profile lives at importyeti.com/company/target, so the slug is "target". ## `resultsLimit` (type: `integer`): How many importer profiles to pull in a single run. ## `timeoutSeconds` (type: `integer`): Seconds to wait on each request before it times out. ## Actor input object example ```json { "importerSlugs": [ "target", "costco-wholesale" ], "resultsLimit": 50, "timeoutSeconds": 45 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "importerSlugs": [ "target" ] }; // Run the Actor and wait for it to finish const run = await client.actor("data_api/importyeti-scraper-cheap").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "importerSlugs": ["target"] } # Run the Actor and wait for it to finish run = client.actor("data_api/importyeti-scraper-cheap").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "importerSlugs": [ "target" ] }' | apify call data_api/importyeti-scraper-cheap --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=data_api/importyeti-scraper-cheap", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "ImportYeti Scraper (Cheap)", "description": "ImportYeti scraper that collects supplier lists, shipment counts, and HS code data for any U.S. importer, so you can map a competitor's supply chain in seconds.", "version": "0.0", "x-build-id": "jSdj3V1UM7A4Kdeos" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_api~importyeti-scraper-cheap/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_api-importyeti-scraper-cheap", "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_api~importyeti-scraper-cheap/runs": { "post": { "operationId": "runs-sync-data_api-importyeti-scraper-cheap", "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_api~importyeti-scraper-cheap/run-sync": { "post": { "operationId": "run-sync-data_api-importyeti-scraper-cheap", "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", "required": [ "importerSlugs" ], "properties": { "importerSlugs": { "title": "Importer slugs", "type": "array", "description": "ImportYeti company slugs to look up. The slug is the last part of the profile URL: importyeti.com/company/{slug}. For example, the Target profile lives at importyeti.com/company/target, so the slug is \"target\".", "items": { "type": "string" } }, "resultsLimit": { "title": "Results limit", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many importer profiles to pull in a single run.", "default": 50 }, "timeoutSeconds": { "title": "Timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Seconds to wait on each request before it times out.", "default": 45 } } }, "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 } } } } } } } } } } ```