# ImportYeti Scraper - US Import Records & Supplier Data (`zen-studio/importyeti-scraper`) Actor

Extract supplier profiles, shipment records, and trade data from ImportYeti. Search by company, product, or address. 60+ fields per result: HS codes, shipping lanes, carriers, bills of lading, trading partners, and contact info. No login required.

- **URL**: https://apify.com/zen-studio/importyeti-scraper.md
- **Developed by:** [Zen Studio](https://apify.com/zen-studio) (community)
- **Categories:** Lead generation, E-commerce, Automation
- **Features:** Limited permissions
- **Stats:** 650 total users, 84 monthly users, 100.0% runs succeeded, 9 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $4.99 / 1,000 profiles

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## ImportYeti Scraper — US Import Records, Suppliers & Trade Intelligence

[![75+ FIELDS PER COMPANY. Suppliers. Shipments. Trade routes.](https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/importyeti-scraper-readme-hero-v1.png)](https://console.apify.com/actors/7sDq1LHYZAlHQS9yW/input)

From <strong>Zen Studio</strong>, creators of <a href="https://apify.com/zen-studio/1688-wholesale-scraper">1688 Wholesale</a> and <a href="https://apify.com/zen-studio/thomasnet-suppliers-scraper">ThomasNet Suppliers</a>, with <strong>130,000+ combined runs</strong>. Established tools for finding manufacturers, researching suppliers and comparing sourcing options.

### Why choose this actor?

<strong>75+ fields, with company details included.</strong> Go from a search result to supplier relationships, shipment volumes, product descriptions, shipping routes, carriers and recent bills of lading. Profile details are collected automatically.

<strong>See who supplies which products.</strong> Find suppliers grouped by HS product code, with countries and shipment counts. Compare trading partners using recent activity and shipment history, then shortlist the companies relevant to your sourcing needs.

<strong>Research up to 1,000 profiles per run.</strong> Search by company, product keyword or address. Filter for suppliers or US importers, recent shipments and minimum shipment volume to focus on actively trading businesses.

<a href="https://console.apify.com/actors/7sDq1LHYZAlHQS9yW/input"><img src="https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/importyeti-scraper-readme-cta-v1.svg" width="224" height="48" alt="Find your suppliers"/></a>

### Quick start

Try 10 suppliers matching “hdmi cable” with shipments in the last six months. Company details are included automatically.

```json
{
  "query": "hdmi cable",
  "type": "supplier",
  "mostRecentShipment": "6mo",
  "maxResults": 10
}
```

<a href="https://console.apify.com/actors/7sDq1LHYZAlHQS9yW/input">Open actor input</a> to choose a company, product or location. Export JSON, CSV or Excel; JSON preserves nested suppliers, shipment histories and routes.

Fields depend on the profile. Phone numbers and emails may be masked or unavailable on ImportYeti. Unusually large sections are saved as linked files alongside the result.

<table><tr><td colspan="5" style="background:#285574;color:#FFFFFF;padding:10px 14px;font-size:13px;font-weight:700">Zen Studio · Sourcing & Trade Data</td></tr><tr><td style="background:#C9E5F3;padding:8px 10px;border:1px solid #B8D8E8;vertical-align:top"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-7sDq1LHYZAlHQS9yW-RbKRK5f5kR-importyeti-scraper-logo-square.png" width="20" height="20" alt="" style="display:inline-block;vertical-align:middle;margin:0"/>&nbsp;<a href="https://apify.com/zen-studio/importyeti-scraper" style="color:#193C55;text-decoration:none;font-weight:700;font-size:13px">ImportYeti</a></span><br><span style="color:#33586D;font-size:12px;white-space:nowrap">You are here</span></td><td style="background:#E4F3FA;padding:8px 10px;border:1px solid #B8D8E8;vertical-align:top"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-ghXSMZcW3GxsCrkiR-5hnvsKv4Yt-1688-wholesale-scraper-logo.png" width="20" height="20" alt="" style="display:inline-block;vertical-align:middle;margin:0"/>&nbsp;<a href="https://apify.com/zen-studio/1688-wholesale-scraper" style="color:#193C55;text-decoration:none;font-weight:700;font-size:13px">1688</a></span><br><span style="color:#33586D;font-size:12px;white-space:nowrap">Wholesale products</span></td><td style="background:#E4F3FA;padding:8px 10px;border:1px solid #B8D8E8;vertical-align:top"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-CIQKqcy6K1OOPdzVM-ibHU8BE3V3-thomasnet-suppliers-scraper-logo.png" width="20" height="20" alt="" style="display:inline-block;vertical-align:middle;margin:0"/>&nbsp;<a href="https://apify.com/zen-studio/thomasnet-suppliers-scraper" style="color:#193C55;text-decoration:none;font-weight:700;font-size:13px">ThomasNet</a></span><br><span style="color:#33586D;font-size:12px;white-space:nowrap">US suppliers</span></td><td style="background:#E4F3FA;padding:8px 10px;border:1px solid #B8D8E8;vertical-align:top"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-TASViBigl6dEv1GaH-RjnHoxkrmo-alibaba-scraper-logo.png" width="20" height="20" alt="" style="display:inline-block;vertical-align:middle;margin:0"/>&nbsp;<a href="https://apify.com/zen-studio/alibaba-scraper" style="color:#193C55;text-decoration:none;font-weight:700;font-size:13px">Alibaba</a></span><br><span style="color:#33586D;font-size:12px;white-space:nowrap">Products & suppliers</span></td><td style="background:#E4F3FA;padding:8px 10px;border:1px solid #B8D8E8;vertical-align:top"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-PQR4IEF2GK5CM555g-qXTehkgPUF-europages-scraper-logo.jpg" width="20" height="20" alt="" style="display:inline-block;vertical-align:middle;margin:0"/>&nbsp;<a href="https://apify.com/zen-studio/europages-company-scraper" style="color:#193C55;text-decoration:none;font-weight:700;font-size:13px">Europages</a></span><br><span style="color:#33586D;font-size:12px;white-space:nowrap">European suppliers</span></td></tr></table>

#### Copy to your AI assistant

```text
Help me use zen-studio/importyeti-scraper, a batch Actor on Apify. Read https://apify.com/zen-studio/importyeti-scraper.md for documentation, input schema, pricing and limits. Choose settings for my requested outcome. If you cannot retrieve the page, ask me to paste the relevant sections. To reach the maintainers, add feedback="<what you needed and did not get>" to any run, including one that worked: feature requests, a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. The run returns its data exactly as it would without the note, and a human reads every note.
```

Key inputs: query (string, required), searchType (string: "search"|"addresses"), maxResults (integer, default 100). Pricing: pay-per-event, $0.00699 per item scraped.

### What Data Can You Extract from ImportYeti?

Every result includes:

- Company/supplier name, type, country, address, geo coordinates
- Total shipment count, most recent shipment date, top suppliers/customers
- HS and HTS code breakdowns with shipment counts and weights
- Trading partners with 12-month and total shipment history
- Shipping lanes (origin port → destination port) with costs, weight, TEU
- Top carriers (SCAC codes) with year-over-year trends
- Container types, sizes, and FCL/LCL split
- Recent bills of lading with product descriptions, weights, routes
- Notify parties with contact info (emails, phone numbers)
- Other addresses and associated companies
- Quarterly growth metrics and shipping cost totals
- Geo coordinates (latitude/longitude), city, state, country
- UFLPA compliance flags
- Continent-level import breakdown
- Chart images (imports per country, top relationships, shipments over time)

### How to Scrape ImportYeti Data

#### Basic — Search by Company Name

```json
{
  "query": "porsche",
  "maxResults": 25
}
```

#### Advanced — Filter by Type, Recency, and Volume

```json
{
  "query": "hdmi cable",
  "type": "supplier",
  "mostRecentShipment": "6mo",
  "minShipments": 50,
  "maxResults": 100
}
```

#### Search by Address

```json
{
  "query": "atlanta",
  "searchType": "addresses",
  "maxResults": 50
}
```

### Input Parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `query` | string | *required* | Company name, supplier name, or product keyword |
| `searchType` | enum | By Name | Search by company/product name or by address/location |
| `maxResults` | integer | 100 | Maximum results to return (1–1,000; 25 on the free plan) |
| `type` | enum | Any | Filter by entity type: Supplier or Company |
| `mostRecentShipment` | enum | Any Time | Only entities with shipments in the last 6 or 12 months |
| `minShipments` | integer | — | Minimum total shipment count to include a result |

### Integrations and scheduling

Run this Actor on a schedule in Apify Console, daily or weekly to refresh results. Each run can call a webhook when it finishes, so n8n, Make and Zapier flows can pick up new rows; the Apify API and Apify MCP server accept the same input.

### Pricing — Pay Per Event (PPE)

**$6.99 per 1,000 results** (base price). Volume discounts available.

The Apify free plan covers 10 runs of up to 25 results each, so you can try the actor before paying. Any paid plan removes both limits.

| | No discount | Bronze | Silver | Gold |
|---|---|---|---|---|
| Per profile | $0.00699 | $0.00649 | $0.00599 | $0.00499 |

#### Cost Examples

| Results | Cost |
|---------|------|
| 10 | ~$0.07 |
| 100 | ~$0.70 |
| 1,000 | ~$6.99 |

#### Cost Optimization

- Use `type`, `mostRecentShipment`, and `minShipments` filters to narrow results before scraping
- Set `maxResults` to only what you need

### Output Example

The output schema is the same for both suppliers and companies. Every result includes all fields below.

```json
{
  "name": "Tesla",
  "type": "company",
  "countryCode": "US",
  "address": "45500 Fremont Blvd 510-249, Fremont, Ca 94538, Us",
  "totalShipments": 39826,
  "mostRecentShipment": "2026-02-24",
  "topSuppliers": [
    "Tesla Shanghai",
    "Quanta Computer",
    "Lg Energy Solution",
    "Catl Co"
  ],
  "trademarks": ["Tesla"],
  "otherAddressesCount": 300,
  "otherNamesCount": 99,
  "detailUrl": "https://www.importyeti.com/company/tesla",

  "alsoKnownAs": ["Tesl A", "Tesl A Inc", "// ... and 97 more"],
  "addressPlain": "45500 Fremont Blvd Fremont Ca 94538",
  "addressFormatted": "45500 Fremont Blvd 510-249, Fremont, Ca 94538, Us",
  "country": "United States of America",
  "addressCountryCode": "US",
  "addressShipments": 7,
  "addressUrl": null,
  "addressCountryUrl": "/location/company/united-states-of-america/country",
  "addressLocationUrl": "/location/company/united-states-of-america/county/5379121-alameda",
  "serpCountry": "United States",
  "serpCountryCode": "US",
  "locationHierarchy": [
    { "level": 1, "name": "California", "type": "State", "url": "/location/company/united-states-of-america/state/5332921-california", "latitude": 37.25022, "longitude": -119.75126 },
    { "level": 2, "name": "Alameda County", "type": "County", "url": "/location/company/united-states-of-america/county/5379121-alameda", "latitude": 37.65055, "longitude": -121.91789 },
    // ... and 1 more level
  ],
  "state": "California",
  "county": "Alameda County",
  "city": "Fremont",
  "latitude": 37.54827,
  "longitude": -121.98857,
  "dateRange": { "start": "2015-01-02", "end": "2026-02-24" },
  "shipments12m": 10816,
  "quarterlyGrowth": { "months": 3, "shipments": 208, "percent": 3.95 },
  "totalShippingCost": 17830912.86,
  "shippingCostCoverage": 2.84,
  "avgTeuPerShipment": { "12m": 1.73, "24m": 1.88, "36m": 2.33 },
  "avgTeuPerMonth": { "12m": 1557.57, "24m": 877.54, "36m": 2056.82 },
  "phone": "XXX-XXX-X783",
  "website": "teslamotors.com",

  "hsCodeSummary": [
    {
      "code": "85",
      "description": "Electric motors/Appliances",
      "url": "/hs-codes/85-electrical-machinery-and-equipment-and",
      "shipments": 6498,
      "weight": 1547283910,
      "teu": 11326,
      "children": [
        {
          "code": "8507",
          "description": "Electric storage batteries...",
          "url": "/hs-codes/8507-electric-storage-batteries",
          "shipments": 3884,
          "children": [
            { "code": "8507.60", "description": "Lithium-ion batteries", "url": "/hs-codes/850760-lithium-ion-batteries", "shipments": 3884 }
          ]
        },
        // ... and 8 more subcategories
      ]
    },
    // ... and 22 more HS code categories
  ],

  "htsCodes": [
    {
      "htsCode": "3801.90.10",
      "description": "Other",
      "shipments": 464,
      "mostRecentShipment": "2025-02-25",
      "bolNumber": "HLCUSZX2412DXAZ2",
      "productDescription": "Spherical Graphite Hs Code 2504109100..."
    },
    // ... and 9 more
  ],

  "topTradingPartners": [
    {
      "name": "Tesla Shanghai",
      "address": "Xincheng Road 3, Pudong, Shanghai, 200000, Cn",
      "addressLocation": "Pudong District",
      "addressLocationUrl": "/location/supplier/china/1809858-pudong-district",
      "country": "China",
      "countryCode": "CN",
      "addressCountry": "China",
      "addressCountryUrl": "/location/supplier/china/country",
      "url": "/supplier/tesla-shanghai",
      "shipments12m": 147,
      "totalShipments": 938,
      "totalWeight": 303584610,
      "totalTeus": 1544,
      "hsCodes": ["8507.60", "8703.90", "8544.30"],
      "hsCodeChapters": [
        { "chapter": "85", "name": "Electric motors/Appliances", "shipments": 612, "shipments_perc": 65.2, "teu": 998, "teu_perc": 64.6 }
      ],
      "productDescriptions": "Lithium Ion Battery, Electric Vehicle Parts",
      "topCompanies": [
        { "company_name": "Tesla", "shipments_12m": 147, "total_shipments": 938 }
      ],
      "timeSeries": {
        "01/01/2021": { "shipments": 12, "weight": 3027380, "teu": 18 },
        "01/01/2026": { "shipments": 11, "weight": 8399232, "teu": 18 },
        // ... quarterly data since 2021
      },
      "internal": true,
      "uflpa": false,
      "uflpaUrl": null,
      "alibabaData": null,
      "alibabaLink": false
    },
    // ... and 49 more partners
  ],

  "vendorHsCodes": [
    { "htsCode": "8507.60", "description": "Lithium-ion batteries", "link": "/hs-codes/850760-..." },
    // ... and 155 more
  ],

  "topHsChapters": [
    { "chapter": "85", "name": "Electric motors/Appliances", "color": "#22C55E" },
    { "chapter": "84", "name": "Boilers/machinery", "color": "#3B82F6" },
    // ... and 2 more
  ],

  "suppliersByHsCode": [
    {
      "hsCode": "8507.60",
      "supplierCount": 14,
      "suppliers": [
        { "name": "Lg Energy Solution", "url": "/supplier/lg-energy-solution", "country": "South Korea", "totalShipments": 1820, "shipments12m": 240 },
        { "name": "Catl Co", "url": "/supplier/catl-co", "country": "China", "totalShipments": 1190, "shipments12m": 173 }
        // ... and 12 more suppliers for this HS code
      ]
    },
    // ... one entry per HS code across all trading partners
  ],

  "topCarriers": [
    {
      "code": "CMDU",
      "name": "Compagnie Maritime Daffretemen",
      "url": "/scac-codes/cmdu",
      "shipments": 17573,
      "shipments12m": 4866,
      "shipments12_24m": 4953,
      "yoy": -1.76,
      "serviceTypes": [
        { "service_type": "HH", "shipments": 17573, "shipments_perc": 100 }
      ]
    },
    // ... and 12 more carriers
  ],

  "carriersPerCountry": {
    "China": ["Compagnie Maritime Daffretemen", "Orient Overseas Container Line", "..."],
    "Japan": ["..."],
    "Germany": ["..."],
    // ... more countries
  },
  "scacCodesDiversity": 2.11,
  "scacCodesDiversityNormalized": 0.41,

  "shippingLanes": [
    {
      "exitPort": "Shanghai",
      "exitPortUrl": "/ports/loading/57035",
      "exitPortCountry": "China",
      "entryPort": "Oakland, Calif",
      "entryPortUrl": "/ports/unloading/2811",
      "entryPortCountry": "United States of America",
      "entryPortRegion": "California",
      "entryPortRegionUrl": "/location/company/united-states-of-america/state/5332921-california",
      "shipments": 9837,
      "shipments12m": 2792,
      "shipments12_24m": 2683,
      "yoy": 4.06,
      "weight": 2454652948,
      "teu": 17206,
      "shippingCost": 7613927.94
    },
    // ... and 68 more lanes
  ],

  "containers": [
    {
      "isoType": "45G1",
      "length": "40ft",
      "group": "High Cube General Purpose Container",
      "shipments": 26144,
      "shipments12m": 7437,
      "shipments12_24m": 7318,
      "yoy": 1.63,
      "weight": 4662098862,
      "teu": 52288,
      "count": 26144
    },
    // ... and 97 more container types
  ],
  "containerTypes": {
    "45G1": 26144,
    "22G1": 8732,
    "42G1": 4901
    // ... ISO container code → count
  },
  "containerLoad": [
    { "loadType": "LCL", "shipments": 2026, "percent": 5.09 },
    { "loadType": "FCL", "shipments": 37800, "percent": 94.91 }
  ],

  "billTypeShipments": [
    { "billType": "regular", "shipments": 32052 },
    { "billType": "in_bond_regular", "shipments": 430 },
    // ... and 3 more
  ],

  "otherAddresses": [
    { "id": 1024787, "address": "45500 Fremont Blvd Fremont Ca 94538", "url": "/location/company/united-states-of-america/...", "shipments": 28116, "otherCompanies": 5 },
    // ... and 299 more
  ],

  "addressContactInfo": [
    {
      "address": "Street, Md 21154, Us",
      "mostRecentShipment": "2019-08-15",
      "mostRecentBol": "POLNCLLOAK190256",
      "emails": [],
      "phoneNumbers": ["XXXXXXX955"]
    }
  ],
  "addressContacts": {
    "phoneNumbers": [
      {
        "phoneNumber": "XXXXXXX122",
        "shipments": 1407,
        "companies": 2,
        "addresses": 4,
        "companyShipments": 1396,
        "companyAddresses": 2,
        "mostRecentShipmentTo": "2026-04-26",
        "mostRecentShipmentBol": "DSVFSTR0422287"
      }
    ],
    "emails": []
  },

  "notifyPartyShipments": 28117,
  "notifyPartyPercent": 70.6,
  "internalNotifyPartyShipments": 5775,
  "internalNotifyPartyPercent": 20.54,
  "notifyPartyTable": [
    {
      "notifyParty": "Livingston International",
      "address": "Marydel, Md 21649, Us",
      "url": "/notify-party/livingston-international",
      "shipments": 20547,
      "shipments12m": 0,
      "yoy": 0,
      "internal": false
    },
    // ... and 23 more
  ],
  "notifyPartyContactInfo": [
    {
      "address": "Mariner Ave, Torrance, Ca 90503, Us",
      "mostRecentShipment": "2024-12-03",
      "mostRecentBol": "CMDUSHZ6752661",
      "emails": [],
      "phoneNumbers": ["XXXXXXX031", "XXXXXXX235", "XXXXXXX129"]
    }
  ],

  "recentBols": [
    {
      "id": 50,
      "date": "2026-02-24",
      "bolNumber": "BANQ1072295106",
      "billCode": "H",
      "masterBol": "HLCUBC1260158214",
      "houseBol": "BANQ1072295106",
      "supplier": "Simoldes Portugal",
      "supplierName": "Simoldes",
      "supplierAddress": "Rua Comendador Antonia Da Silva 285 Santiago De Riba-Ul 3720-501",
      "supplierLocation": "Santiago De Riba-Ul",
      "supplierLocationUrl": "/location/supplier/portugal/...",
      "supplierCountry": "Portugal",
      "supplierCountryCode": "PT",
      "supplierCountryUrl": "/location/supplier/portugal/country",
      "supplierUrl": "/supplier/simoldes",
      "product": "Automotive Plastic",
      "weight": 1156,
      "shippingCost": null,
      "shippingRoute": null,
      "containersCount": 1,
      "quantity": "1",
      "quantityUnit": "CTN",
      "alibabaData": null,
      "hasMinimalData": true
    },
    // ... and 49 more BOLs
  ],

  "tags": [
    { "tag": "tesla", "url": "/tags/tesla", "shipments": 26696 },
    { "tag": "lithium", "url": "/tags/lithium", "shipments": 4348 },
    // ... and 48 more
  ],

  "manifestConfidentiality": [
    { "start": "2015-02-01", "end": "2023-02-01" },
    { "start": "2023-09-01", "end": "2025-09-01" }
  ],

  "hasInternalShipments": true,
  "internalSuppliersCount": 3,
  "otherCompanies": 0,
  "bookmarks": { "new_shipments": 0, "vendor_new_companies": [] },
  "alibabaData": null,
  "alibabaLink": null,
  "indiaIndexData": null,
  "indiaIndexLink": null,
  "uflpa": false,
  "uflpaUrl": null,

  "topImports": [
    { "hsCode": "85", "description": "Electric motors/Appliances", "shipments": 6498 },
    { "hsCode": "84", "description": "Boilers/machinery", "shipments": 5369 },
    { "hsCode": "87", "description": "Automotive", "shipments": 3073 }
  ],

  "avgShippingDelayPerWeek": {
    "26/02/2024": 5.2,
    "04/03/2024": 4.8,
    // ... weekly data for ~90 weeks
  },

  "continentBreakdown": [
    {
      "continent": "Asia",
      "totalShipments": 33333,
      "countriesShipmentData": [
        { "country": "China", "shipments": 23131 },
        { "country": "South Korea", "shipments": 3525 },
        { "country": "Japan", "shipments": 3361 }
      ]
    },
    {
      "continent": "Europe",
      "totalShipments": 5375,
      "countriesShipmentData": [
        { "country": "Germany", "shipments": 4154 },
        { "country": "Belgium", "shipments": 359 }
      ]
    },
    // ... and 4 more continents
  ],

  "images": {
    "importsPerCountry": "data:image/png;base64,...",
    "top10Relationships": "data:image/png;base64,...",
    "totalShipmentsOverTime": "data:image/png;base64,...",
    "productBreakdown": "data:image/png;base64,..."
  }
}
```

### How to Scrape ImportYeti with Python

```python
from apify_client import ApifyClient

client = ApifyClient("your_token")
run = client.actor("zen-studio/importyeti-scraper").call(run_input={
    "query": "porsche",
    "maxResults": 25,
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['name']} ({item['countryCode']}) — {item['totalShipments']} shipments")
```

### How to Scrape ImportYeti with JavaScript

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'your_token' });
const run = await client.actor('zen-studio/importyeti-scraper').call({
    query: 'porsche',
    maxResults: 25,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach(item => {
    console.log(`${item.name} (${item.countryCode}) — ${item.totalShipments} shipments`);
});
```

### Advanced Usage

#### Find High-Volume Suppliers in a Product Category

```json
{
  "query": "lithium battery",
  "type": "supplier",
  "minShipments": 100,
  "mostRecentShipment": "6mo",
  "maxResults": 50
}
```

#### Map All Importers at a Specific Location

```json
{
  "query": "los angeles port",
  "searchType": "addresses",
  "maxResults": 200
}
```

#### Quick Competitor Scan

```json
{
  "query": "tesla",
  "type": "company",
  "maxResults": 50
}
```

### Data Export

Results are available in:

- **JSON** — structured data for programmatic analysis
- **CSV** — flat tables for spreadsheets
- **Excel** — formatted data for reporting

Export directly from Apify Console or via API.

### Video: schedule it and chain it

[![How to schedule tasks to run automatically on the Apify platform](https://img.youtube.com/vi/GRFW_Loo2dk/hqdefault.jpg)](https://www.youtube.com/watch?v=GRFW_Loo2dk)

Apify's own walkthroughs apply to this actor unchanged: [scheduling a run](https://www.youtube.com/watch?v=GRFW_Loo2dk) (daily or hourly, from Console) and [chaining Actors with the Actor-to-Actor integration](https://www.youtube.com/watch?v=zExnYbvFoBM), so another Actor or a webhook picks up each new dataset.

### FAQ

**How many results can I extract?**
No hard limit. Set `maxResults: 0` for unlimited.

**Do I need an ImportYeti account?**
No. The scraper extracts publicly available data without any login.

**How fresh is the data?**
Data is scraped in real time from ImportYeti, so you always get the latest available records.

**Can I filter by country?**
Not directly as an input parameter, but you can use the search query (e.g., "germany automotive") or filter results by `countryCode` in your downstream processing.

**What are HS codes and HTS codes?**
HS (Harmonized System) codes are international product classification codes. HTS (Harmonized Tariff Schedule) codes are the US-specific extension used for import duties. Both are included in the detail output.

**Why did my run return no results?**
The run finished as SUCCEEDED and the log ends with "Done, 0 results" without a "Collected" line: ImportYeti's search returned nothing for the query and filters. Nearly every empty run we see is a company-name search with `type: "company"` and a small `maxResults`. The usual causes:

- The name as typed matches nothing. The query is passed to ImportYeti's search unchanged, so a misspelling or a legal suffix the records do not carry ("Acme Imports LLC") returns zero. Search the shortest distinctive part of the name (`acme imports`, or `porsche` as in the example above) and pick the right entity from the results.
- `type: "company"` when the entity is listed as a supplier. Companies are US importers; overseas manufacturers and exporters are suppliers. Set `type: "any"` and read the `type` field of each result instead.
- `mostRecentShipment` or `minShipments` excluding a dormant or low-volume entity. Set `mostRecentShipment: "any"` and remove `minShipments`, then narrow again.

A rate limit or a blocked request is never reported as zero results: the run fails with "Unable to retrieve results. Please try again in a few minutes." You are charged per result returned, so an empty run costs nothing beyond Apify's platform start fee.

### More from Clearpath

Sourcing from the SHEIN marketplace: enter a keyword and get the real factory or manufacturer behind each marketplace seller (name, address, phone, email), plus the EU responsible person.

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/DSvMCAwsufMyZeLyt-actor-P5fALt8vY7xXgJh56-cIPO73yOhI-shein-product-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> [SHEIN Seller & Manufacturer Leads](https://apify.com/clearpath/shein-seller-leads)

### Legal Compliance

This Actor extracts publicly available US import/export records. Users must ensure compliance with applicable data protection regulations (GDPR, CCPA) and ImportYeti's terms of service when using extracted data.

***

[**Start Extracting ImportYeti Trade Data Now**](https://console.apify.com/actors/7sDq1LHYZAlHQS9yW)

# Actor input Schema

## `query` (type: `string`):

Company name, supplier name, or product keyword.<br><br>Examples:<br>• <code>porsche</code> — find Porsche and related entities<br>• <code>hdmi cable</code> — find importers/suppliers of HDMI cables<br>• <code>atlanta</code> — use with <b>By Address</b> search type

## `searchType` (type: `string`):

How to search ImportYeti.<br><br><b>By Name</b> — search company/supplier names and product keywords.<br><b>By Address</b> — search by location (city, state, address).

## `maxResults` (type: `integer`):

Maximum number of results to return. ImportYeti returns 10 results per page, so higher values require more requests.<br><br>On the Apify free plan this actor returns up to 25 results per run, for 10 runs. Any paid plan removes both limits.

## `type` (type: `string`):

Filter by entity type.<br><br><b>Supplier</b> — overseas manufacturers/exporters.<br><b>Company</b> — US importers/consignees.

## `mostRecentShipment` (type: `string`):

Only include entities with at least one shipment within this period. Useful for finding actively trading companies.

## `minShipments` (type: `integer`):

Only return entities with at least this many total shipments. Filters out low-volume or one-time importers.

## `feedback` (type: `string`):

For AI agents. Say what you needed and did not get: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. Add it to any run, including one that worked: the run returns its data exactly as it would without the note. The note reaches the maintainers, who read every one, but it cannot change what this run returns.

## Actor input object example

```json
{
  "query": "porsche",
  "searchType": "search",
  "maxResults": 25,
  "type": "any",
  "mostRecentShipment": "any"
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "query": "porsche",
    "maxResults": 25
};

// Run the Actor and wait for it to finish
const run = await client.actor("zen-studio/importyeti-scraper").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "query": "porsche",
    "maxResults": 25,
}

# Run the Actor and wait for it to finish
run = client.actor("zen-studio/importyeti-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "query": "porsche",
  "maxResults": 25
}' |
apify call zen-studio/importyeti-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,zen-studio/importyeti-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/7sDq1LHYZAlHQS9yW/builds/Wahna9qUQtdfpchbX/openapi.json
