# ImportYeti Scraper: US Customs Records, Suppliers & Importers (`getascraper/importyeti-suppliers-scraper`) Actor

Scrape ImportYeti US customs data on importers and suppliers: profiles, bill of lading shipments, supplier-to-customer links and port lanes. Search by name, HS code, product or country, load whole lists, and get only new shipments on every scheduled run. No login. Export to Excel, CSV or JSON.

- **URL**: https://apify.com/getascraper/importyeti-suppliers-scraper.md
- **Developed by:** [GetAScraper](https://apify.com/getascraper) (community)
- **Categories:** Lead generation, E-commerce, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 customs records

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 Customs Records, Suppliers & Importers

<table width="100%" style="margin-bottom:0">
<tr>
<td style="padding:24px 28px;background:#EAF1FA;border:1px solid #C3D7EE;border-top:4px solid #1F5AA6;border-radius:12px 12px 0 0">
<span style="font-size:23px;font-weight:800;color:#1C1917;line-height:1.3">See who ships what to whom in US imports, and get told when it changes</span><br>
<span style="font-size:15px;color:#57534E;line-height:1.6">Look up importers and overseas suppliers by name, product, HS code or country. Get profiles, shipment records and supplier-to-customer links in a spreadsheet, for a whole list at once.</span>
</td>
</tr>
</table>
<table width="100%" style="margin-top:0">
<tr>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #C3D7EE;border-radius:0 0 0 10px;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#163A68">📦 Real shipment rows</span><br>
<span style="font-size:12px;color:#57534E">Date, bill numbers, weight, containers, product description, route and supplier on every row.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #C3D7EE;border-left:none;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#163A68">🧭 Find whole markets</span><br>
<span style="font-size:12px;color:#57534E">Start from an HS code, product word, country or port and get the biggest importers and suppliers.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #C3D7EE;border-left:none;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#163A68">🔗 Who buys from whom</span><br>
<span style="font-size:12px;color:#57534E">Supplier-to-customer links with shipment counts, volumes and the partner's other big buyers.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #C3D7EE;border-left:none;border-radius:0 0 10px 0;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#163A68">🔔 Only what is new</span><br>
<span style="font-size:12px;color:#57534E">Schedule a run and receive just the shipments and partners you have not seen before.</span>
</td>
</tr>
</table>

**Get US customs import records from ImportYeti and download them as JSON, CSV or Excel.** Search companies and suppliers, open their profiles, and pull one row per shipment, per trading partner and per shipping lane. No account, no login and no key is needed.

***

### 🔍 What can you do with it?

- **I source products overseas** and want to see which factories already ship my product category to US buyers, how often, and from which country.
- **I sell to importers** and need a list of active US buyers of one HS code, filtered to companies that shipped in the last 6 months.
- **I do competitor and customer research** and want to see who supplies a rival, how fast that volume is growing and which ports it moves through.
- **I qualify suppliers** and need shipment counts, carriers and product mix before I place a first order.
- **I analyse trade flows** and need clean shipment and lane rows for one product or country, not a screenshot of a page.

***

### 🚀 How to use it

<table width="100%">
<tr>
<td style="padding:16px 14px;width:33%;background:#EAF1FA;border:1px solid #C3D7EE;border-radius:10px 0 0 10px;vertical-align:top">
<span style="font-size:12px;font-weight:800;color:#1F5AA6;letter-spacing:1px">STEP 1</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Say what to look up</span><br>
<span style="font-size:12px;color:#57534E">Names, products, profile links, HS codes, product words or countries. Mix them in one run.</span>
</td>
<td style="padding:16px 14px;width:33%;background:#EAF1FA;border:1px solid #C3D7EE;border-left:none;vertical-align:top">
<span style="font-size:12px;font-weight:800;color:#1F5AA6;letter-spacing:1px">STEP 2</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Filter and choose the detail</span><br>
<span style="font-size:12px;color:#57534E">Keep recent, active traders and switch on shipments, partners or lanes.</span>
</td>
<td style="padding:16px 14px;width:33%;background:#EAF1FA;border:1px solid #C3D7EE;border-left:none;border-radius:0 10px 10px 0;vertical-align:top">
<span style="font-size:12px;font-weight:800;color:#1F5AA6;letter-spacing:1px">STEP 3</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Download or schedule</span><br>
<span style="font-size:12px;color:#57534E">Export the table, or schedule the run to receive only new activity each time.</span>
</td>
</tr>
</table>

**Good to know before you start**

- Leave every lookup field empty and the Actor runs a small sample search, so a first test always returns rows.
- A search returns at most 150 matches. For longer lists, add several searches, for example one per country or product word.
- Each profile lists its 50 latest shipments. Each HS code, product word, country or port page lists up to 50 importers and 50 suppliers.
- Profiles, shipments, partners and lanes are off by default. Switch on only what you need, because each one adds rows.
- A bare name such as `apple` tries the importer first. Use `supplier/foxconn-interconnect-technology` to open a supplier with that exact link path.
- Product words work when the site has a page for that word, for example `hdmi` or `carpet`. A word with no page is reported in the log and skipped.

***

### ⚙️ Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| Search names or products | array of text | No | Company names, supplier names or product words, one per row. Each row returns up to Max results per lookup. |
| Search by | enum | No | Match names and products, or match the address a company ships from or to. |
| Company or supplier profiles | array of text | No | Profile links, link paths or bare names to open in full. The cheapest way to enrich a list you already have. |
| HS codes | array of text | No | Product codes of 2 to 10 digits, for example `8504` or `8504.40`. Returns the biggest importers and suppliers of that product, the latest shipments and market totals. |
| Product keywords | array of text | No | Single product words as they appear in shipment descriptions, for example `hdmi`. |
| Supplier countries or location pages | array of text | No | A country name such as `vietnam`, or a link to a state, city or port page. |
| Any ImportYeti links | array of URLs | No | Paste links of any supported page type. Each one is recognised automatically. |
| Importer or supplier | enum | No | Keep only overseas suppliers, only US importers, or both. |
| Shipped within | enum | No | Keep only companies whose latest record is within 6 or 12 months. |
| Minimum total shipments | integer | No | Skip companies with fewer customs records than this. |
| Countries (two-letter codes) | array of text | No | Keep only companies based in these countries, for example `VN` or `IN`. |
| Rankings to return for HS codes, keywords and locations | enum | No | Importers, suppliers or both. |
| Load full profiles | boolean | No | Opens every match and returns its full profile. Off by default. |
| Include shipment records | boolean | No | One row per shipment for each profile, or the latest shipments of a market. Off by default. |
| Include supplier and customer links | boolean | No | One row per trading partner of each profile. Off by default. |
| Include port-to-port lanes | boolean | No | One row per shipping lane with year-on-year change. Off by default. |
| Include monthly history | boolean | No | Adds month-by-month shipment counts. Off by default. |
| Only new shipments and partners since last run | boolean | No | Returns only what was not delivered on an earlier run with the same monitor name. The first run returns everything. |
| Monitor name | text | No | A label for the watch, so separate schedules keep separate memory. |
| Max rows | integer | No | Upper limit on rows for the whole run. The default is 10. |
| Max results per lookup | integer | No | Matches kept per search row and per side of a market ranking. The default is 10, the most the site serves is 150. |
| Proxy | object | No | Connection settings. The default works for most runs. |

***

### 📦 Output

Every row has a `recordType`, so one table holds several kinds of rows and you can filter on it. Fields with no data are left out, never filled with placeholders.

```json
{
  "recordType": "shipment",
  "targetType": "company",
  "targetSlug": "apple",
  "targetName": "Apple",
  "arrivalDate": "2026-10-18",
  "billOfLading": "GOLA156912681581",
  "masterBol": "MEDUABV67504",
  "supplierName": "Modern Space Design Co Ltd",
  "supplierSlug": "modern-space-design-decoration",
  "supplierCity": "Shanghai Shi",
  "supplierCountry": "China",
  "supplierCountryCode": "CN",
  "weightKg": 5056,
  "quantity": 18,
  "quantityUnit": "PKG",
  "containerCount": 1,
  "productDescription": "Display Fixture Carpet Underlay Subfloor",
  "route": "Asia / Pacific",
  "estFreightCostUsd": 8514.98,
  "scrapedAt": "2026-10-24T23:52:23.512Z"
}
```

#### Record types

| recordType | One row is | When you get it |
| --- | --- | --- |
| `search_result` | A matching company or supplier card. | Name, product or address searches. |
| `profile` | The full profile of a company or supplier. | Profile links, or Load full profiles. |
| `shipment` | One shipment (bill of lading). | Include shipment records. |
| `partner` | One trading partner of a profile. | Include supplier and customer links. |
| `trade_lane` | One departure port to US arrival port lane. | Include port-to-port lanes. |
| `market_summary` | Totals for an HS code, product word, country or port. | HS codes, product keywords and locations. |
| `market_entity` | One ranked importer or supplier in that market. | HS codes, product keywords and locations. |

#### Field reference

| Field | Type | Description |
| --- | --- | --- |
| recordType, scrapedAt | text / date | Row type and the time it was collected. |
| entityType, slug, name, url | text | Whether the company is an importer or supplier, its short name, display name and page link. |
| address, city, country, countryCode, latitude, longitude, locationHierarchy | text / number / array | Where it is based, with coordinates and region path. |
| website, otherWebsites, alsoKnownAs, tags, trademarks | text / array | Websites, alternative names, product tags and trademarks on the profile. |
| totalShipments, shipments12m, mostRecentShipment, firstShipmentDate | number / date | How many customs records and how recently. |
| quarterlyShipmentChangePct, avgTeuPerMonth, totalShippingCostUsd | number | Trend and volume figures when shown. |
| topCountries, hsChapters, topHsCodes, htsCodes, topCarriers, containerLoad, notifyParties | array | Where goods come from or go, what they are and who carries them. |
| topPartners, shipmentsByMonth | array | Leading partners and the monthly shipment series. |
| arrivalDate, billOfLading, houseBol, masterBol, billTypeCode | date / text | Shipment identifiers and arrival date. |
| supplierName, supplierCountry, importerName, importerCountry (with slug, address, city, code) | text | The other side of each shipment. For an importer you get the supplier, for a supplier you get the importer. |
| weightKg, quantity, quantityUnit, containerCount, productDescription, route | number / text | What was shipped and how much. |
| estFreightCostUsd, declaredValueCifUsd | number | Estimated freight cost, and the declared value on older records that carry one. |
| partnerRole, partnerName, partnerSlug, partnerUrl, partnerCountry | text | The trading partner and which side of the trade it is on. |
| shipmentsTogether, shipmentsTogether12m, teu, hsCodes, firstShipmentMonth, lastShipmentMonth | number / array / text | How much the two sides trade and over what period. |
| partnerOtherTradePartners | array | The partner's other large trading partners. |
| exitPort, entryPort, entryPortRegion, laneShipments, laneShipments12m, laneYoyChangePct, estShippingCostUsd | text / number | Port-to-port lane figures. |
| marketType, marketKey, marketTitle, totalWeightKg, totalTeu, tariffs | text / number / array | Totals for an HS code, product word, country or port. |
| marketRole, marketRank, marketShipments, marketShipments12m, isTopInMarket, isFastestGrowing, isNewInMarket | text / number / boolean | A ranked importer or supplier in that market. |
| sourceQuery, rank | text / number | The search that found a card and its position. |
| monitor | object | In monitor mode: what was new since the last run. |

**What is not included:** phone numbers are masked and email addresses are locked on the source site, so they are not returned. Only the 50 latest shipments per profile are listed publicly. Shipment value, buyer contacts and per-record detail beyond the public view stay out of reach without a paid account on the source site, and this Actor never asks you for one.

***

### 💰 Pricing

Pay per result. An empty run costs nothing and there are no subscriptions. See the pricing box at the top of this page for the current rates.

**Free plan:** up to 25 rows per run, 3 runs per day, with a 30 minute pause between runs.

***

### ⭐ Enjoying ImportYeti Scraper?

<table width="100%" style="display:table;width:100%">
<tr>
<td style="padding:20px 24px 14px;background:#EAF1FA;border:1px solid #C3D7EE;border-left:5px solid #1F5AA6;border-radius:10px 10px 0 0">
<span style="font-size:20px;letter-spacing:4px">⭐ ⭐ ⭐ ⭐ ⭐</span><br>
<span style="font-size:17px;font-weight:800;color:#1C1917">Stop copying supplier pages by hand and keep a list of who ships what that updates itself.</span><br>
<span style="font-size:14px;color:#57534E">A 5-star rating takes 10 seconds and helps other sourcing, sales and trade research teams find it. Your feedback also tells us what to build next.</span>
</td>
</tr>
<tr>
<td style="padding:0;background:#1F5AA6;border:1px solid #C3D7EE;border-top:none;border-radius:0 0 10px 10px;text-align:center">
<a href="https://apify.com/getascraper/importyeti-suppliers-scraper/reviews" style="display:block;padding:13px 16px;color:#FFFFFF;text-decoration:none;font-weight:800;font-size:15px;letter-spacing:0.3px">★&nbsp;&nbsp;Rate this Actor on Apify</a>
</td>
</tr>
</table>

***

### ✨ Tips and best practices

- Start with the default 10 rows to see the shape of the data, then raise the limit.
- Use Shipped within and Minimum total shipments to drop dormant and one-off companies from lead lists.
- Search a product word with Include supplier and customer links to see which factories sit behind the biggest buyers.
- For monitoring, keep the same Monitor name and the same lookups on every scheduled run. The first run saves the baseline and returns everything.
- Names on customs records are spelled many ways. Check the `alsoKnownAs` list on a profile before you decide two companies are different.

***

### ❓ FAQ

##### Does it need an ImportYeti account or API key?

No. It reads only what is visible to anyone on the site, so there is nothing to log in to and no key to enter.

##### How do I find all importers of one product?

Put the HS code in HS codes, for example `8504.40`, and choose importers in the rankings option. You get the largest importers of that product, plus the latest shipments for it if you switch shipments on. For deeper lists, add more specific codes.

##### Can I get a company's phone number or email?

No. The source site masks phone numbers and locks email addresses for anonymous visitors, so the Actor leaves them out rather than guessing. You get websites, addresses and shipment history instead.

##### How do I track a competitor's new suppliers?

Add the competitor's profile link, switch on Include supplier and customer links and Include shipment records, turn on the new-only option and give the watch a Monitor name. Schedule the run daily or weekly. Each run returns only new shipments and new partners.

***

### 🛡️ Disclaimers and support

This Actor is an independent tool and is not affiliated with ImportYeti. It collects publicly available customs information. You are responsible for using the data in line with the law and the source's terms. Questions or feature ideas are welcome in the Issues tab of this Actor.

***

### 🔗 Other actors

- [Zauba Scraper: India Customs Trade Data by HS Code or Keyword](https://apify.com/getascraper/zauba-trade-data-scraper) ↗ - Indian import and export customs records by HS code or keyword.
- [Made-in-China Scraper 中国制造网: Products, Suppliers, Price Changes](https://apify.com/getascraper/made-in-china-catalog-scraper) ↗ - Chinese supplier catalogs with price change tracking.
- [Toocle Scraper 生意宝: China B2B Products, Suppliers & Prices](https://apify.com/getascraper/toocle-b2b-sourcing-scraper) ↗ - Chinese B2B products and suppliers with prices.
- [TradeKorea Scraper: Korean Suppliers, Products & Buying Leads](https://apify.com/getascraper/tradekorea-supplier-rfq-feed) ↗ - Korean suppliers, products and buying leads.
- [GYS Scraper 供应商网: China Suppliers, Prices, MOQ & Phone Contacts](https://apify.com/getascraper/gys-supplier-catalog-scraper) ↗ - Chinese suppliers with prices, minimum orders and phone contacts.

# Changelog

This Actor's version history is a separate document: https://apify.com/getascraper/importyeti-suppliers-scraper/changelog.md

# Actor input Schema

## `searchQueries` (type: `array`):

Company names, supplier names or product words to search for, one per row, for example nike or led lighting. Each row returns up to the value of Max results per lookup (150 is the most the site serves per search). Leave every lookup field empty to run a small sample search.

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

Choose whether the search rows above match names and products, or the address a company or supplier ships from or to, such as atlanta or ho chi minh.

## `profiles` (type: `array`):

Known profiles to load in full, one per row. Use a link, a path such as supplier/foxconn-interconnect-technology, or a bare name like apple (the importer is tried first). This is the cheapest way to enrich a list you already have.

## `hsCodes` (type: `array`):

Product classification codes of 2 to 10 digits, for example 8504 or 8504.40. Each one returns the biggest importers and suppliers of that product, the latest shipments and the market totals.

## `productTags` (type: `array`):

Single product words as they appear in shipment descriptions, for example hdmi or carpet. Each one returns the biggest importers and suppliers shipping goods described with that word. The tags field on a profile lists words that are known to work; a word with no page is reported and skipped.

## `locations` (type: `array`):

A country name such as vietnam (lists foreign suppliers there), or a full ImportYeti location or port link for a state, city or port. Each one returns the biggest suppliers or importers based there.

## `startUrls` (type: `array`):

Paste importyeti.com links of any supported page type (company, supplier, HS code, product keyword, location or port). Each link is recognised automatically.

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

Keep only overseas suppliers, only US importers, or both. Applied to search results and to bare profile names.

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

Keep only entities whose latest customs record is within this window. Useful to drop dormant companies from lead lists.

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

Skip entities with fewer customs records than this. Use it to separate regular traders from one-off buyers.

## `countryCodes` (type: `array`):

Keep only entities based in these countries, for example VN, IN or US. Leave empty to allow every country.

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

HS code, keyword, location and port pages list up to 50 top importers and 50 top suppliers. Choose which side you want.

## `fetchProfiles` (type: `boolean`):

Open every matched company or supplier and return its full profile: addresses, HS codes, carriers, notify parties, trademarks and volume trends. Slower than plain search cards because each profile is one more page load.

## `includeShipments` (type: `boolean`):

Add one row per bill of lading for each profile, with date, bill numbers, supplier or importer, weight, quantity, containers, product description, trade route and estimated freight cost. The site shows the 50 latest per profile. For HS code and keyword lookups this returns the latest shipments in that market.

## `includePartners` (type: `boolean`):

Add one row per trading partner of each profile: an importer's suppliers or a supplier's customers, with shipments together, last 12 months, volumes, HS codes and the partner's other big buyers. This is the supplier-to-customer map.

## `includeTradeLanes` (type: `boolean`):

Add one row per shipping lane (departure port to US arrival port) with shipments, year-on-year change, weight, containers and estimated cost.

## `includeTimeSeries` (type: `boolean`):

Add the month-by-month shipment counts to profiles and partner rows. Makes rows larger.

## `onlyNewShipments` (type: `boolean`):

Remember what each profile or market already returned and, on later runs, return only shipment rows and trading partners that have not been seen before. The first run returns everything and saves the baseline. Schedule the Actor daily or weekly to watch competitors, customers or suppliers.

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

A label for this watch. Use different names for different schedules so each keeps its own memory of what was already delivered.

## `maxItems` (type: `integer`):

Hard cap on rows saved in the whole run, across every row type. Free plans are capped at 25 per run.

## `maxResultsPerSource` (type: `integer`):

How many matches to keep for each search row and for each side of an HS code, keyword or location ranking. The site serves at most 150 matches per search.

## `proxyConfiguration` (type: `object`):

Datacenter proxies work for this site and keep runs cheap. Every request uses a fresh exit address. If the site refuses datacenter addresses the Actor retries through residential ones automatically.

## Actor input object example

```json
{
  "searchQueries": [],
  "searchBy": "name",
  "profiles": [],
  "hsCodes": [],
  "productTags": [],
  "locations": [],
  "startUrls": [],
  "entityType": "any",
  "mostRecentShipment": "any",
  "minShipments": 0,
  "countryCodes": [],
  "marketRoles": "both",
  "fetchProfiles": false,
  "includeShipments": false,
  "includePartners": false,
  "includeTradeLanes": false,
  "includeTimeSeries": false,
  "onlyNewShipments": false,
  "monitorId": "default",
  "maxItems": 10,
  "maxResultsPerSource": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

No description

## `summary` (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 = {
    "searchQueries": [],
    "searchBy": "name",
    "profiles": [],
    "hsCodes": [],
    "productTags": [],
    "locations": [],
    "startUrls": [],
    "entityType": "any",
    "mostRecentShipment": "any",
    "minShipments": 0,
    "countryCodes": [],
    "marketRoles": "both",
    "fetchProfiles": false,
    "includeShipments": false,
    "includePartners": false,
    "includeTradeLanes": false,
    "includeTimeSeries": false,
    "onlyNewShipments": false,
    "monitorId": "default",
    "maxItems": 10,
    "maxResultsPerSource": 10,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("getascraper/importyeti-suppliers-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 = {
    "searchQueries": [],
    "searchBy": "name",
    "profiles": [],
    "hsCodes": [],
    "productTags": [],
    "locations": [],
    "startUrls": [],
    "entityType": "any",
    "mostRecentShipment": "any",
    "minShipments": 0,
    "countryCodes": [],
    "marketRoles": "both",
    "fetchProfiles": False,
    "includeShipments": False,
    "includePartners": False,
    "includeTradeLanes": False,
    "includeTimeSeries": False,
    "onlyNewShipments": False,
    "monitorId": "default",
    "maxItems": 10,
    "maxResultsPerSource": 10,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("getascraper/importyeti-suppliers-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 '{
  "searchQueries": [],
  "searchBy": "name",
  "profiles": [],
  "hsCodes": [],
  "productTags": [],
  "locations": [],
  "startUrls": [],
  "entityType": "any",
  "mostRecentShipment": "any",
  "minShipments": 0,
  "countryCodes": [],
  "marketRoles": "both",
  "fetchProfiles": false,
  "includeShipments": false,
  "includePartners": false,
  "includeTradeLanes": false,
  "includeTimeSeries": false,
  "onlyNewShipments": false,
  "monitorId": "default",
  "maxItems": 10,
  "maxResultsPerSource": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call getascraper/importyeti-suppliers-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,getascraper/importyeti-suppliers-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/XLkSvPULxFzndGXpc/builds/47SD3FLcgxnlOkPZZ/openapi.json