# US Importers Finder: ImportYeti Alternative for US Customs Data (`rich_minds/us-importer-finder-ai`) Actor
First 25 US importers free. US importers finder: pay per qualified US importer, junk never charged by us β buyers of your product ranked from US customs records, with their suppliers, ports and the pitch to send. MCP & AI agents ready. Free demo on any plan. An ImportGenius alternative.
- **URL**: https://apify.com/rich_minds/us-importer-finder-ai.md
- **Developed by:** [Rich Minds](https://apify.com/rich_minds) (community)
- **Categories:** Lead generation, E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $5.00 / 1,000 qualified us importer (rules only)s
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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
## US Importers Finder: ImportYeti Alternative for US Customs Data
**New US buyers of your product, ranked for your country, in your inbox every week.**
β‘ First **25 US importers free** Β· π΅ **β $0.036 per qualified US importer all in**, the source scan on your account included β $0.005 of it is ours Β· π€ **β $0.041 all in with AI**, on plans with model access or your key Β· β±οΈ demo in seconds
> **Try it in 30 seconds.** Click **Try it** β the form is pre-filled with a free demo on ten sample importers of five
> niches; type your product and press Start for the live search. Your first **25 qualified US importers** are free, and
> importers that fail your filters cost nothing here (the scan runs on your account).
> **Which plan:** the demo and your own rows (list mode) run on any Apify plan Β· the live search and the weekly digest
> run on a plan that runs Store Actors (Apify Starter and up).
> β [What a run costs](#-pricing--what-a-run-really-costs) Β· [Run it weekly](#-run-it-weekly)
### β‘ At a glance
| | |
|---|---|
| **What you get** | US companies that import your product, ranked: shipments, growth, last arrival, suppliers and their countries, ports, carriers, the share bought from your country, a pitch angle |
| **You provide** | your product in plain words ("cotton t-shirts") or an HS code, and the country you export from β or a US port and lane if you sell freight |
| **Output** | a ranked sheet (Excel / CSV / Google Sheets) plus a digest of what is new each run |
| **Typical run** | 30 profiles scanned β β 7 qualified US importers, 1 in 4 (estimate until the first platform run, 2026-10-30) |
| **Cost of that run** | $0.25 rules only Β· $0.29 with AI ($0.21 source scan + 7 Γ $0.005 / 7 Γ $0.01 + 7 Γ $0.0004 tokens) |
| **All in per importer** | β $0.036 rules only Β· β $0.041 with AI, the source scan on your account included |
| **Free tier** | your first 25 qualified US importers on this Actor β one free tier per Apify account, however many searches you run |
| **Keys / setup** | No API key where your Apify plan includes model access (Apify Starter plan and up) β on the Free plan your own Gemini / Groq key: a free key gives 1β3 AI verdicts per run, a paid key all |
| **Which plan** | Free demo and your own list (list mode, [template](https://api.apify.com/v2/key-value-stores/kyUl00SmdlTCTEV1i/records/list-template.json)): any plan Β· live search and the digest mail: a plan that runs Store Actors |
| **Works with** | Schedules, webhooks, Google Sheets, Slack, Teams, Discord, Telegram, Make / n8n / Zapier, MCP & AI agents |
### π― What this Actor does
- **Importers ranked for your product and country** β HS / product match, volume, recency, growth: one 0β100 score with its reason.
- **Who already buys from your country** β expand there, or switch-pitch where it buys only elsewhere.
- **The tariff-year angle** β who buys half or more from China, who is exposed to the UFLPA.
- **The whole outreach, never an invented price** β a pitch angle; with AI on, the first e-mail, a LinkedIn note and the day-5 follow-up.
- **Who to write to** β the contact add-on finds the checked address of the hot importers.
- **Never stuck on one broken scraper** β three ImportYeti Actors, one schema; forwarders and repeats cost nothing.
#### π Find US importers of your product by keyword or HS code
Type "cotton t-shirts" or HS 6109 and pick **Your country**; HS codes alone run memo23's HS-code pages. No product?
Describe the buyer in **Who is your ideal buyer?** β the terms are read from it.
#### π’ US importers by port and lane β for forwarders, NVOCCs and customs brokers
**US entry ports** ("savannah") and **Min containers (TEU)** keep the importers landing on your lane, carriers on the row.
#### π Tariff 2026: who is leaving China
**Target flags** β `china_plus_one` keeps the importers buying half or more from China; four presets pitch India,
Vietnam, Mexico or Bangladesh as the second source.
#### βοΈ Find the e-mail to write to β the contact add-on
**Find the e-mail to write to** sends the best hot / warm importers (10 a run) to our
[Company Contact Finder](https://apify.com/rich_minds/company-contact-finder-ai): its checked address and the named
person fill `contactEmail` / `contactName`, β $0.0075 per e-mail found, billed by that Actor on your account.
### π How to use it
1. **Click `Try it`** β the free demo on ten sample importers of five niches runs as is.
2. **Type your product** and pick **Your country** β it replaces the sample and runs the live search on your Apify
account, capped by "Max source spend". Leave "AI assessment" on ([which AI your plan gets](#-at-a-glance)).
3. **Press Start** β hot importers first; the Outreach view says how to reach each one.
4. **Schedule it weekly** with your address in "E-mail me the new US importers" β only new importers are charged.
Already scraped ImportYeti? Paste that dataset ID into **Dataset** β no second scrape.
π **Learn more:** [Step-by-step tutorial: find US importers of your product](https://api.apify.com/v2/key-value-stores/kyUl00SmdlTCTEV1i/records/tutorial.html)
### π Why this instead of the raw ImportYeti scraper?
| | [ImportYeti Scraper (`zen-studio/importyeti-scraper`)](https://apify.com/zen-studio/importyeti-scraper) | **This Actor (US Importers Finder)** |
|---|---|---|
| **Your time per 100 US importers** | β 13 h β open 400 profiles, check goods, suppliers, countries | β 0 h β ranked, origin share computed, pitch written |
| **Same 100 usable importers, all in** | β $3.01 for the β 430 profiles behind them, vetting yours | 100 ranked, explained importers: $3.50 rules only Β· $4.05 with AI, the source scan included, junk free |
#### vs other scrapers, Store neighbours and subscription tools
`memo23/importyeti-scraper` ($0.0008 a row + $0.02 a run), `scrapesage/importyeti-scraper` ($0.009 a profile), `muhammadafzal/importyeti-scraper` ($0.005 a row), `scrapemint/customs-ruling-finder` (CBP rulings) and ImportGenius / Panjiva / Volza seats, with users and 100 usable importers all in: [rivals side by side](https://api.apify.com/v2/key-value-stores/kyUl00SmdlTCTEV1i/records/api-reference.md).
### π΅ Pricing β what a run really costs
Pay per result: **one event per qualified US importer, nothing else.**
| Event | When it is charged | Price |
|---|---|---|
| `free-tier` | your first 25 qualified US importers on this Actor, in any mode | **$0.00** |
| `qualified-us-importer-basic` | AI off β the row, origin share, rule score, template pitch | **$0.005** |
| `qualified-us-importer-ai` | AI on β plus the quoted fit reason, company type, AI pitch, e-mail, LinkedIn note, follow-up | **$0.01** |
**One free tier:** your first 25 qualified US importers are free, whatever the tier. **Never charged by us:** importers
below "Minimum score", too old, too small, off your ports or TEU floor, forwarders, your exclude list, repeats. **No fee
of ours** β the source's $0.005 start fee per product term and $0.00699 per profile run on your account, capped by
"Max source spend".
**How that compares** β $0.005 is at the $0.005 median of the 10 Actors a Store search for "us importers finder"
shows (parity), but per qualified US importer: one replaces β 4 scanned profiles, $0.0013 per raw-row equivalent.
**Worked example** β "cotton t-shirts" from India, form defaults: 30 profiles scanned β β 7 qualified US importers
(estimate): source 30 Γ $0.00699 + $0.005 = $0.21, plus 7 Γ $0.005 = **$0.25 rules only** (β $0.036 each), or
7 Γ $0.01 + 7 Γ $0.0004 tokens = **$0.29 AI on** (β $0.041 each). **AI tier, all in:** β $0.010 per importer here
($0.01 + $0.0004 tokens: β 2,150 in / 510 out per importer measured 2026-10-24 with an own gemini-3.5-flash-lite key,
priced at the default gemini-2.5-flash-lite rates). **At volume** β 5 products weekly, 120 profiles β β 28 importers:
$1.00 rules only Β· $1.16 AI on, a week. Every figure: [cost table](https://api.apify.com/v2/key-value-stores/kyUl00SmdlTCTEV1i/records/api-reference.md).
### π€ What the AI tier adds
The same importer, AI **off** (the free demo, 2026-10-24):
```json
{"name": "Harbor & Pine Apparel Co", "ruleScore": 93, "label": "hot", "companyType": "brand", "originSharePct": 59.4, "pitchAngle": "You already source 59.4 % of your supplier shipments from India, with 64 shipments in the last 12 months β¦", "emailDraft": "", "linkedinNote": ""}
```
AI on β the same importer (qualified-us-importer-ai, own Gemini key, 2026-10-24)
```json
{
"name": "Harbor & Pine Apparel Co", "fitScore": 93, "score": 93, "label": "hot", "companyType": "brand",
"fitReason": "\"100% COTTON KNITTED MENS T-SHIRTS\" matches the exporter's cotton t-shirts.",
"emailSubject": "Expanding your cotton t-shirt supply from India",
"emailDraft": "Hi Sourcing Team, I noticed Harbor & Pine Apparel Co imported 64 shipments in the last 12 months, with 59.4% already coming from India. We manufacture premium cotton t-shirts in India β¦ Could we send samples to evaluate for your upcoming lines? β¦",
"linkedinNote": "Hi, I saw Harbor & Pine Apparel Co imported 64 shipments recently with 59.4% originating from India. We supply premium cotton t-shirts from India and would love to connect with your sourcing team.",
"followUpDraft": "Hi, following up on my previous note. Since your shipments grew 33.3% to 64 in the last 12 months, we would love to support your expanded volume with our cotton t-shirts. Can we schedule a brief call this week? β¦",
"aiModel": "google:gemini-3.5-flash-lite"
}
```
The drafts leave your name, company and lead time as fill-in fields.
The fields a buyer decides on, with defaults
| Field | Default | What it does |
|---|---|---|
| `products` | β | Your product in bill-of-lading words, up to 5 β one source run per term |
| `hsCodes` | β | Next to a product they filter and score; alone they run memo23's HS-code pages |
| `originCountry` | `IN` | Your country β drives `originSharePct` and expand / switch |
| `goalDescription` | β | Your ideal buyer β the AI scores against it |
| `entryPorts` / `minTeu12m` | β / `0` | Only importers landing at these US ports / moving at least this many TEU a year |
| `minScore` | `50` | Decides what you pay: below this = not delivered, not charged |
| `maxQualified` | `100` | Hard cap on output and on our charges |
| `maxImporters` | `30` | Profiles the source reads per run, all terms together |
| `maxDiscoveryChargeUsd` | `0.5` | Hard cap on the source scan on your account |
| `mostRecentWithinMonths` / `minShipments12m` | `6` / `3` | Only active importers |
| `excludeForwarders` | `true` | Drops plain forwarders free (`allowList` keeps a name) |
| `enableAi` | `true` | AI fit, company type, pitch, the e-mails and the LinkedIn note |
| `enrichContacts` | `false` | The contact add-on (`enrichContactsMax` 10 a run) |
| `sourceMode` | `live` | The mode that runs = `sourceMode`, except `{}` = the free demo, nothing charged; `list` / `dataset` = your rows |
Every output field, the upsert key and the run records
**Every field:** `itemId`, `name`, `url`, `alsoKnownAs`, `address`, `city`,
`state`, `website`, `domain`, `phone`, `contactRoute`, `companyType`, `shipmentsTotal`, `shipments12m`,
`shipmentsPrior12m`, `growthPct`, `growthBasis`, `firstArrival`, `lastArrival` (the records' own arrival dates),
`weightKg12m`, `weightBasis`, `teu12m`, `hsCodes`, `goodsDescriptions`, `entryPorts`, `topCarriers`, `topSuppliers`,
`originSharePct`, `originShareBasis`, `buysFromOrigin`, `chinaSharePct`, `uflpaExposed`, `estValueUsd12m`, `valueBasis`,
`flags`, `targetFlagsMatched`, `ruleScore`, `fitScore`, `score`, `label`, `assessedBy`, `fitReason`, `pitchAngle`,
`scoreReasons`, `summary`, `generatedText` (= `pitchAngle`), `recommendedNextStep`, `emailSubject`, `emailDraft`,
`linkedinNote`, `followUpDraft`, `contactEmail`, `contactEmailRole`, `contactName`, `contactTitle` (the contact
add-on), `aiModel`, `sourceActor`, `source`, `chargedEvent`, `billedAs`, `dedupeKey`, `scrapedAt` (the download time).
**Upsert key:** `dedupeKey` β `iy:` + the ImportYeti company slug; `itemId` hashes it. A **`DIGEST`**, a client-ready
**`REPORT`** page (`OUTPUT.reportUrl`) and the `OUTPUT` run record (funnel, charges, `aiCoverage`, `contactEnrichment`).
Every run outcome: status, OUTPUT, charge, next step
| Outcome | Run status Β· dataset | `OUTPUT` | Charged? | What to do |
|---|---|---|---|---|
| Free demo (`{}`) Β· Success | SUCCEEDED Β· rows | `mode: demo` Β· `outcome: ok` | no Β· per importer | type your product |
| Nothing matched Β· Invalid input | SUCCEEDED, empty Β· FAILED | `outcome: empty` Β· β | not by us Β· no | broader words Β· fix the field named |
| Your plan cannot run the source Store Actor | SUCCEEDED, check `OUTPUT.ok` Β· Console: the sample scored on your product (`sampleFallback`) | `ok: false`, `outcome: source_refused`; a schedule / API run alerts `notifyEmail` and your chats (`refusalAlerted`) | no | list-mode rows (any plan); `failOnSourceError: true` β FAILED |
| Source failed Β· partial | FAILED Β· SUCCEEDED, rows read | `outcome: source_failed` Β· `sourceStatus.partial` | no Β· per importer | follow the status |
| Crashed Β· AI unavailable | FAILED Β· SUCCEEDED, rule-scored | `outcome: error` Β· `aiError` | rows delivered Β· basic | re-run Β· your own key |
Python and JavaScript snippets
```python
from apify_client import ApifyClient
client = ApifyClient("")
run = client.actor("rich_minds/us-importer-finder-ai").call(
run_input={ # free first call: {} (the demo) or {"sourceMode": "list", "itemsList": [...]}
"sourceMode": "live", "products": ["cotton t-shirts"], "hsCodes": ["6109"], "originCountry": "IN",
"maxQualified": 50, "maxDiscoveryChargeUsd": 0.5, "failOnSourceError": True},
timeout_secs=3240, # "How long does a run take?"; build="0.1.3" pins the build you tested
) # the mode that runs = sourceMode; autoSwitchToLive acts on Console runs only
out = client.key_value_store(run["defaultKeyValueStoreId"]).get_record("OUTPUT")["value"]
if not out.get("ok", True): # a plan refusal ends SUCCEEDED with 0 rows
raise RuntimeError(out.get("outcome"), out.get("sourceError"))
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item["name"], item["score"], item["label"], item["url"])
```
```javascript
import { ApifyClient } from "apify-client";
const client = new ApifyClient({ token: "" });
// free first call instead: {} (the demo)
const run = await client.actor("rich_minds/us-importer-finder-ai").call(
{ sourceMode: "live", products: ["cotton t-shirts"], hsCodes: ["6109"], originCountry: "IN",
maxQualified: 50, maxDiscoveryChargeUsd: 0.5, failOnSourceError: true },
{ timeout: 3240 /* , build: "0.1.3" pins the build you tested */ },
);
const { value: out } = await client.keyValueStore(run.defaultKeyValueStoreId).getRecord("OUTPUT");
if (out.ok === false) throw new Error(`${out.outcome}: ${out.sourceError}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
for (const item of items) console.log(item.name, item.score, item.label, item.url);
```
Required and optional fields of a pasted row
| Field | Needed? | What it enables |
|---|---|---|
| `name` | required | the row |
| `url` | required | the ImportYeti `/company/` page β the dedupe key |
| `lastArrival` | optional | recency β the arrival date published in the customs record (when the ship arrived) |
| `shipments12m` | optional | volume and growth (with `shipmentsPrior12m`) |
| `goodsDescriptions` | optional | product fit and the AI's quoted reason (with `hsCodes`) |
| `topSuppliers` | optional | `originSharePct`, `chinaSharePct` and the pitch (`name`, `countryCode`, `shipments12m` each) |
| `entryPorts` | optional | the lane filter (with `teu12m`, `topCarriers`) |
| `website` | optional | the contact route and the contact add-on (with `phone`) |
Measured times per mode and the timeout to set
| Mode | Measured time | `timeoutSecs` |
|---|---|---|
| Free demo (10 sample importers) | 0.3 s (local, 2026-10-24) | 120 |
| Your own rows, rules only | β 0.1 s per 10 rows (local) | 300 |
| Live search, rules only | β 2β4 min for 30 profiles (estimate until the first platform run) | 900 |
| AI via Apify's model access | β 3 s per importer (estimate β not measured on the platform yet, 2026-10-30) | 1800 |
| AI with a free own key, rate-limited | 1β3 importers, the AI stops after 60 s of waiting | 1800 |
| AI with an own key that answered | measured 1β8 s per US importer, gemini-3.5-flash-lite key (8 s on the platform 2026-10-23); 50 importers β 580 s | 1800 |
Worst case with a slow own key: 100 importers at 8 s β 800 s of AI, 2 at a time; the run's budget stops the AI before
the timeout and pushes every row. A free Gemini key answers β 10 importers a minute (measured 2026-10-24).
cotton t-shirts, basmati rice), up to 5 β typing one starts the live search on your Apify plan; a plan that cannot run Store Actors gets the free sample scored on your product. Affects what you pay: one scan per product term (5 terms = 5 scans sharing the scan size), $0.005 start fee each.
## `originCountry` (type: `string`):
Each importer's origin share is the part of its supplier shipments that already comes from this country: above 0 % = it already buys there (pitch: be its next supplier), 0 % = it buys only from your rivals' countries (pitch: switch / second source).
## `goalDescription` (type: `string`):
Describe the US buyer you want in plain words, e.g. US apparel brands and retailers that import cotton knit t-shirts (HS 6109) in volume and could add an Indian supplier. The AI scores every importer against it, explains why and writes the first e-mail; empty = the AI judges each importer as a buyer of your product.
## `notifyEmail` (type: `string`):
After every run with at least one new US importer, the run's digest (how many are new, by type, how many already buy from your country, the top 10 with links) is e-mailed here through Apify's send-mail Actor. Schedule the run weekly (Actions β Schedule) and only new importers come to your inbox. Never sent for the free demo.
## `minScore` (type: `integer`):
The field that decides what you pay: US importers scoring below this are discarded and not charged. Raise it to pay only for the strongest buyers, lower it to see more.
## `maxQualified` (type: `integer`):
Hard cap on results β and the ceiling of what this Actor charges: at most the US importers scanned or this many, whichever is smaller, Γ $0.01 with AI on (Γ $0.005 with AI off) β $0.30 on the default scan of 30; the source's own spend has its cap right below. The best-scoring importers are output first.
## `maxDiscoveryChargeUsd` (type: `number`):
Affects what you pay: hard cap on what the ImportYeti source run may charge your Apify account in the live search β $0.50 in the form and over the API. A failed first source leaves the rest of this cap to the fallback; a scheduled run that doubles the scan doubles it too.
## `enableAi` (type: `boolean`):
Fit score quoting the bills of lading, company type, pitch, first e-mail, LinkedIn note, day-5 follow-up. On = $0.01 per qualified US importer + β $0.0004 of AI tokens; off = $0.005. No key with model access (Apify Starter plan and up; not measured on the platform yet) β else your own key (free key: 1β3 verdicts a run).
## `hsCodes` (type: `array`):
Harmonized System codes of your product, 2β10 digits: 6109 (t-shirts), 610910 (cotton t-shirts), 9403 (furniture). Next to a product term they filter and score only (never a second scan β the scans stay one per product term). Alone they start the live search on memo23's HS-code pages β one run for all your codes ($0.0008 a row + $0.02 a run on your Apify plan), never a text query of the digits. A plan that cannot run Store Actors gets the free sample scored on your codes (or paste rows into itemsList).
## `mostRecentWithinMonths` (type: `integer`):
Only importers whose last shipment arrived within this many months β active buyers, not old records. 0 = any date. Filtered importers are free.
## `minShipments12m` (type: `integer`):
Only importers with at least this many shipments in the last 12 months (a regular buyer, not a one-off). Filtered importers are free.
## `excludeForwarders` (type: `boolean`):
On (default): consignees that are plainly forwarders, customs brokers or logistics companies (unambiguous name tokens such as logistics, freight, NVOCC, 3PL, or consolidated-cargo goods; and the AI's company type when it is on) are dropped free β they ship for others and do not buy your product. An ambiguous name (Express, β¦ Shipping Co) is kept with the forwarder flag for the AI to decide; every dropped name is listed in OUTPUT.skips, and Always keep forces one back in.
## `entryPorts` (type: `array`):
Only importers whose goods land at one of these US ports β part of the port's name, one per line: savannah, los angeles, long beach, newark, houston. For forwarders, 3PLs and customs brokers selling a lane. Filtered importers are free; empty = every port.
## `minTeu12m` (type: `number`):
Only importers moving at least this many TEU a year β the volume a forwarder or NVOCC quotes for. 0 = any. An importer whose TEU the source does not report is kept. Filtered importers are free.
## `maxImporters` (type: `integer`):
Affects what you pay: how many importer profiles the ImportYeti source reads in one run, all your terms together β β 30 Γ $0.00699 + $0.005 per term β $0.22 on your Apify account with the default source, capped by Max source spend. A scheduled run doubles it when left at the default.
## `unitValueUsdPerKg` (type: `number`):
US bills of lading carry no price. Give a benchmark (e.g. the unit value per kg from UN Comtrade for your HS code and country) and each row gets estValueUsd12m = its 12-month weight Γ this price, labelled an estimate. Empty = no value estimate.
## `unitValueSource` (type: `string`):
API only β hidden on the form. Shown in each row's valueBasis, e.g. UN Comtrade 2025, HS 6109 India β USA.
## `targetFlags` (type: `array`):
Only deliver US importers that have at least one of these flags, and rank those with more of them higher. Leave empty to keep everything. An API call passes the flag names from the README's flag table, e.g. buys_from_origin (buysFromOrigin works too); an unknown name stops the run at once with the list of valid ones.
## `suppressionList` (type: `array`):
Importer names, ImportYeti URLs or websites to never output (your current customers). Suppressed importers are skipped before any processing and never charged.
## `allowList` (type: `array`):
API only β hidden on the form. Importer names, ImportYeti URLs or websites no free rule may drop (a buyer the forwarder rule or a port / volume filter skipped last run β see OUTPUT.skips for the names). They still need to pass Minimum score.
## `llmProvider` (type: `string`):
Apify (no keys) β the AI runs through Apify's built-in OpenRouter proxy; tokens are billed to your Apify account at OpenRouter's rates (not measured on the platform yet β the first platform run is dated in the README's Coming next). My own key β use your OpenAI / Anthropic / Gemini / Groq key instead; a free-tier key assesses only a few US importers per run β expect 1β3 AI checks (2 calls at a time, one after a rate limit, then the 3 borderline US importers retried one by one) β and the rest keep their rule score; a paid Groq / Gemini key (billing on) assesses every US importer. Measured 2026-10-23 / 2026-10-24: β 1β8 s per US importer with a free google:gemini-3.5-flash-lite key (1 s, 1.6 s and 8 s on the platform, 1.4β2.2 s locally) β size a 50-importer own-key run's timeout at β 580 s.
## `llmModel` (type: `string`):
API only β hidden on the form. Leave empty for the default: google/gemini-2.5-flash-lite through Apify's model access; with your own key the key's provider picks it (a Gemini key β google:gemini-3.5-flash-lite, an Anthropic key β anthropic:claude-haiku-4-5-20251001, Groq β groq:openai/gpt-oss-20b, OpenAI β openai:gpt-4.1-mini). Apify mode takes an OpenRouter slug such as openai/gpt-4.1-mini; own-key mode takes provider:model.
## `llmApiKey` (type: `string`):
Required when AI model access is My own API key. Stored encrypted by Apify, never logged.
## `aiCandidateMultiplier` (type: `integer`):
API only β hidden on the form. How many of the best rule-scored US importers get the AI pass, as a multiple of Max qualified. Higher = more thorough, slower, more tokens.
## `sendAlertsTo` (type: `string`):
Paste one or more URLs, one per line β the service is detected from the address: a Slack or Discord channel webhook, a Teams Workflows or Google Chat space webhook, your Telegram bot's send link (https://api.telegram.org/bot\/sendMessage?chat_id=@yourchannel) or any other https URL (Zapier, Make, n8n, your CRM), which gets the US importers as JSON. After every run with at least one new US importer, the digest (how many are new, the top 10 with links) is posted there. Never sent for the free demo. Headers, batching and signing: Delivery details (advanced).
## `dedupeAcrossRuns` (type: `boolean`):
Remembers every US importer you were charged for (by its ImportYeti company page, in a named key-value store on your account) and skips it in future runs of this search.
## `dedupeTtlDays` (type: `integer`):
API only β hidden on the form. How long a delivered importer stays remembered. 0 = never deliver or charge it again. A number of days lets an importer you already have come back (e.g. 180 to re-check last year's buyers) β charged again as a new US importer.
## `historyDatasetName` (type: `string`):
Optional. Type a name (e.g. us-importers-log) and every run appends its new US importers with the date to that named dataset on your account β one list across months to connect to Google Sheets or your CRM once. Empty = off. Costs nothing extra.
## `enrichContacts` (type: `boolean`):
On: the best hot / warm importers with a website go to our Company Contact Finder (rich_minds/company-contact-finder-ai) inside this run β its checked e-mail and the named person fill contactEmail / contactName, and the Outreach view opens with them. Affects what you pay: β $0.0075 per importer with an e-mail found, billed by that Actor on your Apify account (its first contacts free; a plan that runs Store Actors). Off: the website stays the contact route.
## `enrichContactsMax` (type: `integer`):
API only β hidden on the form. Affects what you pay: at most this many hot / warm importers go to the contact add-on β worst case 10 Γ $0.0075 = $0.075 a run at the default, hard-capped at $1.
## `sourceMode` (type: `string`):
{} over the API runs the free demo β nothing charged, whatever the declared default says; any product or HS code you send runs the live search. The mode that runs = this field, except {} = the free demo. live β run the ImportYeti Store Actors on your account (zen-studio/importyeti-scraper for product terms, memo23/importyeti-scraper for HS codes alone, falling back once to the next in Fallback sources), billed separately. dataset β an existing dataset of any of the three ImportYeti Actors. list β importer rows you paste in. Bring your own data: rows or a dataset ID, and you pay only for the analysis β no source is run. The mode you choose always runs as chosen; only the untouched sample records next to a product you typed on the Console form switch to the live search (spend-capped).
## `autoSwitchToLive` (type: `boolean`):
API only β hidden on the form. On (default, Console runs only): search terms typed next to the untouched sample records start the live search (spend-capped; OUTPUT.switchedToLive names them). Off: the mode you send is the mode that runs β the sample stays the free demo and the status names the terms it did not search. Over the API the mode you send is always the mode that runs.
## `failOnSourceError` (type: `boolean`):
API only β hidden on the form. Off (default): a plan that cannot run the source Store Actor ends SUCCEEDED with 0 rows and OUTPUT.ok: false. On: the same run ends FAILED with the same message, so a schedule's or an API pipeline's failed-run alert fires. Send it on every schedule.
## `datasetId` (type: `string`):
Only for dataset mode: a dataset of zen-studio/importyeti-scraper, memo23/importyeti-scraper or scrapesage/importyeti-scraper (its BOL, lane and supplier rows are skipped). Pick the dataset so the Actor is granted read access to it.
## `itemsList` (type: `array`):
Only for list mode. JSON array of importer rows with at least name and the ImportYeti url; optional shipments12m, lastArrival, hsCodes, topSuppliers (name, country, shipments12m), goodsDescriptions, entryPorts, teu12m β¦ (README β List-mode rows). Rows of the three ImportYeti Actors work as they are. The prefilled ten are the free demo's sample importers (five niches).
## `discoveryActorId` (type: `string`):
The ImportYeti Store Actor the live search runs first for product terms. When it fails, returns no importer or a changed format, the next one in Fallback sources runs once β never more than one extra source per run. HS codes without a product term always go to memo23 (the HS-code source), whatever is picked here.
## `sourceChain` (type: `array`):
API only β hidden on the form. The order the ImportYeti Actors are tried in after the first source. Default: zen-studio, memo23, scrapesage.
## `discoveryInput` (type: `object`):
API only β hidden on the form. Only for the live search. Extra input passed as-is to the first source Actor (it overrides what the Actor builds from your product and filters) β see that Actor's input schema. The live search runs that Store Actor on your Apify plan β if your plan cannot run Store Actors, a run from this form scores the free sample against your product instead (nothing charged), and you can paste your own rows in list mode (any plan); dataset only for a dataset you already have from another account or tool.
## `maxToProcess` (type: `integer`):
API only β hidden on the form. Upper bound on how many US importers are scored in one run (controls run time). Default = 3 Γ max qualified.
## `webhookUrl` (type: `string`):
Qualified US importers are POSTed here as JSON (Zapier, Make, n8n, your CRM). For Google Sheets / Slack you can also use Apify's built-in Integrations tab. Stored encrypted β Zapier / Make hook URLs carry their secret in the path.
## `webhookHeaders` (type: `object`):
API only β hidden on the form. Extra HTTP headers for the webhook, e.g. {"Authorization": "Bearer β¦"}. Stored encrypted by Apify, never logged.
## `webhookBatchSize` (type: `integer`):
API only β hidden on the form. 1 = one POST per US importer the moment it is ready. Higher = one POST per N US importers.
## `webhookSecret` (type: `string`):
API only β hidden on the form. Any random string. Every webhook POST then carries X-Signature: sha256=\, so your endpoint can verify it came from this Actor. Stored encrypted by Apify, never logged.
## `dedupeStoreName` (type: `string`):
API only β hidden on the form. Key-value store used for cross-run memory. Left at the default, the memory is kept per search (source and search terms): rewording goalDescription keeps it, so a scheduled run never re-delivers what you already have, and another search starts its own list. Running it for several clients on one account, type one name per client.
## `discoveryTimeoutSecs` (type: `integer`):
API only β hidden on the form. How long the source Store Actor may run before its partial results are used β never more than 60 % of the run's time left, so the AI, the charges and the digest keep the rest. Raise it (and the run timeout) when the status says the source stopped early.
## `slackWebhookUrl` (type: `string`):
API only β hidden on the form, where sendAlertsTo takes it. Slack incoming-webhook URL for the digest.
## `discordWebhookUrl` (type: `string`):
API only β hidden on the form, where sendAlertsTo takes it. Discord channel webhook URL for the digest.
## `teamsWebhookUrl` (type: `string`):
API only β hidden on the form, where sendAlertsTo takes it. Teams Workflows webhook URL for the digest.
## `googleChatWebhookUrl` (type: `string`):
API only β hidden on the form, where sendAlertsTo takes it. Google Chat space webhook URL for the digest.
## `telegramUrl` (type: `string`):
API only β hidden on the form, where sendAlertsTo takes it. The bot's sendMessage link with its chat_id.
## Actor input object example
```json
{
"preset": "custom",
"originCountry": "IN",
"minScore": 50,
"maxQualified": 100,
"maxDiscoveryChargeUsd": 0.5,
"enableAi": true,
"mostRecentWithinMonths": 6,
"minShipments12m": 3,
"excludeForwarders": true,
"minTeu12m": 0,
"maxImporters": 30,
"unitValueSource": "",
"llmProvider": "apify",
"aiCandidateMultiplier": 2,
"dedupeAcrossRuns": true,
"dedupeTtlDays": 0,
"historyDatasetName": "",
"enrichContacts": false,
"enrichContactsMax": 10,
"sourceMode": "list",
"autoSwitchToLive": true,
"failOnSourceError": false,
"itemsList": [
{
"name": "Harbor & Pine Apparel Co",
"url": "https://www.importyeti.com/company/sample-harbor-pine-apparel",
"address": "2140 E 7th St, Los Angeles, CA 90021, US",
"website": "harborpine-apparel.example",
"shipmentsTotal": 412,
"shipments12m": 64,
"shipmentsPrior12m": 48,
"firstArrival": "2017-03-14",
"lastArrival": "2026-10-06",
"weightKg12m": 182400,
"teu12m": 71.5,
"hsCodes": [
"6109.10",
"6110.20"
],
"topSuppliers": [
{
"name": "Tiruppur Knit Exports",
"country": "India",
"countryCode": "IN",
"shipments12m": 38,
"hsCodes": [
"6109.10"
]
},
{
"name": "Dhaka Cotton Wear",
"country": "Bangladesh",
"countryCode": "BD",
"shipments12m": 20,
"hsCodes": [
"6109.10"
]
},
{
"name": "Jiangsu Garment Co",
"country": "China",
"countryCode": "CN",
"shipments12m": 6,
"hsCodes": [
"6110.20"
]
}
],
"entryPorts": [
"Los Angeles, Calif",
"Long Beach, Calif"
],
"goodsDescriptions": [
"100% COTTON KNITTED MENS T-SHIRTS",
"LADIES COTTON CREW NECK TEE",
"COTTON PULLOVER SWEATSHIRTS"
],
"topCarriers": [
{
"name": "Maersk Line",
"code": "MAEU",
"shipments12m": 40,
"shipmentsTotal": 260
}
]
},
{
"name": "Northgate Outlet Stores Inc",
"url": "https://www.importyeti.com/company/sample-northgate-outlet-stores",
"address": "800 Commerce Pkwy, Columbus, OH 43219, US",
"website": "northgate-outlet.example",
"shipmentsTotal": 1960,
"shipments12m": 210,
"shipmentsPrior12m": 190,
"firstArrival": "2014-06-02",
"lastArrival": "2026-10-15",
"weightKg12m": 905000,
"teu12m": 388,
"hsCodes": [
"6109.10",
"6203.42"
],
"topSuppliers": [
{
"name": "Chittagong Apparel Ltd",
"country": "Bangladesh",
"countryCode": "BD",
"shipments12m": 120,
"hsCodes": [
"6109.10"
]
},
{
"name": "Saigon Textile JSC",
"country": "Vietnam",
"countryCode": "VN",
"shipments12m": 60,
"hsCodes": [
"6203.42"
]
},
{
"name": "Phnom Penh Knitwear",
"country": "Cambodia",
"countryCode": "KH",
"shipments12m": 30,
"hsCodes": [
"6109.10"
]
}
],
"entryPorts": [
"Savannah, Ga",
"New York/Newark Area"
],
"goodsDescriptions": [
"MENS 100 PCT COTTON T-SHIRTS",
"MENS DENIM TROUSERS",
"BOYS COTTON TEES"
],
"topCarriers": [
{
"name": "MSC Mediterranean Shipping",
"code": "MSCU",
"shipments12m": 140,
"shipmentsTotal": 1300
}
]
},
{
"name": "Cedar Lane Distributors LLC",
"url": "https://www.importyeti.com/company/sample-cedar-lane-distributors",
"address": "55 Industrial Rd, Edison, NJ 08817, US",
"phone": "+1 732 555 0190",
"shipmentsTotal": 160,
"shipments12m": 22,
"shipmentsPrior12m": 30,
"firstArrival": "2019-01-09",
"lastArrival": "2026-08-28",
"weightKg12m": 61000,
"teu12m": 24,
"hsCodes": [
"6109.90",
"6302.60"
],
"topSuppliers": [
{
"name": "Faisalabad Knits Pvt",
"country": "Pakistan",
"countryCode": "PK",
"shipments12m": 12,
"hsCodes": [
"6109.90"
]
},
{
"name": "Karur Home Textiles",
"country": "India",
"countryCode": "IN",
"shipments12m": 4,
"hsCodes": [
"6302.60"
]
}
],
"entryPorts": [
"New York/Newark Area"
],
"goodsDescriptions": [
"COTTON BLEND T SHIRTS",
"TERRY BATH TOWELS"
]
},
{
"name": "Bluefin Promotional Products",
"url": "https://www.importyeti.com/company/sample-bluefin-promotional",
"address": "410 Harbor Blvd, Tampa, FL 33602, US",
"website": "bluefin-promo.example",
"shipmentsTotal": 21,
"shipments12m": 9,
"shipmentsPrior12m": 4,
"firstArrival": "2023-05-11",
"lastArrival": "2026-09-19",
"weightKg12m": 14800,
"teu12m": 9,
"hsCodes": [
"6109.10"
],
"topSuppliers": [
{
"name": "Ningbo Blank Apparel",
"country": "China",
"countryCode": "CN",
"shipments12m": 9,
"hsCodes": [
"6109.10"
]
}
],
"entryPorts": [
"Tampa, Fla"
],
"goodsDescriptions": [
"BLANK COTTON TEES FOR SCREEN PRINTING"
]
},
{
"name": "Swift Ocean Logistics Inc",
"url": "https://www.importyeti.com/company/sample-swift-ocean-logistics",
"address": "1 World Trade Ctr, Long Beach, CA 90831, US",
"shipmentsTotal": 5300,
"shipments12m": 640,
"shipmentsPrior12m": 600,
"firstArrival": "2012-02-01",
"lastArrival": "2026-10-18",
"hsCodes": [
"6109.10",
"8471.30",
"9403.60"
],
"topSuppliers": [
{
"name": "Various Shippers Hong Kong",
"country": "Hong Kong",
"countryCode": "HK",
"shipments12m": 400
}
],
"entryPorts": [
"Long Beach, Calif"
],
"goodsDescriptions": [
"CONSOLIDATED CARGO SAID TO CONTAIN GARMENTS",
"FURNITURE PARTS"
]
},
{
"name": "Maple Ridge Home Goods",
"url": "https://www.importyeti.com/company/sample-maple-ridge-home",
"address": "92 Mill St, Burlington, VT 05401, US",
"shipmentsTotal": 48,
"shipments12m": 15,
"shipmentsPrior12m": 15,
"firstArrival": "2020-04-20",
"lastArrival": "2026-07-01",
"hsCodes": [
"6912.00"
],
"topSuppliers": [
{
"name": "Chaozhou Ceramics Factory",
"country": "China",
"countryCode": "CN",
"shipments12m": 15,
"hsCodes": [
"6912.00"
]
}
],
"entryPorts": [
"Boston, Mass"
],
"goodsDescriptions": [
"STONEWARE COFFEE MUGS",
"PORCELAIN DINNERWARE SETS"
],
"uflpaExposed": true
},
{
"name": "Lakeshore Living Furniture Inc",
"url": "https://www.importyeti.com/company/sample-lakeshore-living-furniture",
"address": "1800 Furniture Row, High Point, NC 27260, US",
"website": "lakeshore-living.example",
"shipmentsTotal": 530,
"shipments12m": 118,
"shipmentsPrior12m": 96,
"firstArrival": "2016-02-09",
"lastArrival": "2026-10-12",
"weightKg12m": 1460000,
"teu12m": 260,
"hsCodes": [
"9403.60",
"9401.61"
],
"topSuppliers": [
{
"name": "Binh Duong Woodcraft JSC",
"country": "Vietnam",
"countryCode": "VN",
"shipments12m": 70,
"hsCodes": [
"9403.60"
]
},
{
"name": "Foshan Home Furnishing Co",
"country": "China",
"countryCode": "CN",
"shipments12m": 48,
"hsCodes": [
"9401.61"
]
}
],
"entryPorts": [
"Savannah, Ga",
"Norfolk, Va"
],
"goodsDescriptions": [
"WOODEN FURNITURE: DINING TABLES AND CHAIRS",
"SOLID ACACIA WOOD BEDROOM FURNITURE"
],
"topCarriers": [
{
"name": "Evergreen Marine",
"code": "EGLV",
"shipments12m": 70,
"shipmentsTotal": 320
},
{
"name": "CMA CGM",
"code": "CMDU",
"shipments12m": 48,
"shipmentsTotal": 210
}
]
},
{
"name": "Driftwood Bath & Linen Co",
"url": "https://www.importyeti.com/company/sample-driftwood-bath-linen",
"address": "4400 Harbor Pkwy, Charleston, SC 29405, US",
"website": "driftwood-linen.example",
"shipmentsTotal": 240,
"shipments12m": 54,
"shipmentsPrior12m": 50,
"firstArrival": "2018-09-03",
"lastArrival": "2026-10-02",
"weightKg12m": 268000,
"teu12m": 62,
"hsCodes": [
"6302.60",
"6302.21"
],
"topSuppliers": [
{
"name": "Denizli Havlu Tekstil AS",
"country": "Turkey",
"countryCode": "TR",
"shipments12m": 30,
"hsCodes": [
"6302.60"
]
},
{
"name": "Karur Home Textiles",
"country": "India",
"countryCode": "IN",
"shipments12m": 24,
"hsCodes": [
"6302.21"
]
}
],
"entryPorts": [
"Charleston, S.C."
],
"goodsDescriptions": [
"100% COTTON TERRY BATH TOWELS",
"COTTON BED LINEN SETS"
]
},
{
"name": "Sunrise Specialty Foods Corp",
"url": "https://www.importyeti.com/company/sample-sunrise-specialty-foods",
"address": "9 Produce Market Rd, Edison, NJ 08837, US",
"phone": "+1 732 555 0144",
"shipmentsTotal": 310,
"shipments12m": 76,
"shipmentsPrior12m": 61,
"firstArrival": "2015-11-20",
"lastArrival": "2026-10-09",
"weightKg12m": 1820000,
"teu12m": 92,
"hsCodes": [
"1006.30",
"0713.31"
],
"topSuppliers": [
{
"name": "Amritsar Basmati Exports Pvt",
"country": "India",
"countryCode": "IN",
"shipments12m": 52,
"hsCodes": [
"1006.30"
]
},
{
"name": "Lahore Grain Traders",
"country": "Pakistan",
"countryCode": "PK",
"shipments12m": 24,
"hsCodes": [
"1006.30"
]
}
],
"entryPorts": [
"New York/Newark Area"
],
"goodsDescriptions": [
"BASMATI RICE 1121 STEAM 20 KG BAGS",
"PULSES AND LENTILS"
]
},
{
"name": "Granite Peak Tile & Stone LLC",
"url": "https://www.importyeti.com/company/sample-granite-peak-tile",
"address": "7701 Industrial Blvd, Dallas, TX 75247, US",
"website": "granitepeak-tile.example",
"shipmentsTotal": 190,
"shipments12m": 41,
"shipmentsPrior12m": 33,
"firstArrival": "2019-06-17",
"lastArrival": "2026-09-27",
"weightKg12m": 1110000,
"teu12m": 55,
"hsCodes": [
"6907.21",
"6907.22"
],
"topSuppliers": [
{
"name": "Morbi Ceramic Works",
"country": "India",
"countryCode": "IN",
"shipments12m": 29,
"hsCodes": [
"6907.21"
]
},
{
"name": "Foshan Porcelain Tiles Co",
"country": "China",
"countryCode": "CN",
"shipments12m": 12,
"hsCodes": [
"6907.22"
]
}
],
"entryPorts": [
"Houston, Tex"
],
"goodsDescriptions": [
"GLAZED PORCELAIN FLOOR TILES 600X600",
"CERAMIC WALL TILES"
]
}
],
"discoveryActorId": "zen-studio/importyeti-scraper",
"sourceChain": [
"zen-studio/importyeti-scraper",
"memo23/importyeti-scraper",
"scrapesage/importyeti-scraper"
],
"webhookBatchSize": 1,
"dedupeStoreName": "us-importer-finder-ai-seen",
"discoveryTimeoutSecs": 3600
}
```
# Actor output Schema
## `qualified` (type: `string`):
All qualified us importers as JSON, best-scoring first.
## `sheet` (type: `string`):
The same us importers as a spreadsheet.
## `runSummary` (type: `string`):
JSON record with the funnel (loaded -> filtered -> AI-assessed -> qualified), per-reason skip counts, charged events by type, free-tier us importers used and remaining, whether a budget limit was reached, webhook delivery counts and the dedupe store size.
# 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 = {
"maxDiscoveryChargeUsd": 0.5,
"maxImporters": 30,
"sourceMode": "list",
"itemsList": [
{
"name": "Harbor & Pine Apparel Co",
"url": "https://www.importyeti.com/company/sample-harbor-pine-apparel",
"address": "2140 E 7th St, Los Angeles, CA 90021, US",
"website": "harborpine-apparel.example",
"shipmentsTotal": 412,
"shipments12m": 64,
"shipmentsPrior12m": 48,
"firstArrival": "2017-03-14",
"lastArrival": "2026-10-06",
"weightKg12m": 182400,
"teu12m": 71.5,
"hsCodes": [
"6109.10",
"6110.20"
],
"topSuppliers": [
{
"name": "Tiruppur Knit Exports",
"country": "India",
"countryCode": "IN",
"shipments12m": 38,
"hsCodes": [
"6109.10"
]
},
{
"name": "Dhaka Cotton Wear",
"country": "Bangladesh",
"countryCode": "BD",
"shipments12m": 20,
"hsCodes": [
"6109.10"
]
},
{
"name": "Jiangsu Garment Co",
"country": "China",
"countryCode": "CN",
"shipments12m": 6,
"hsCodes": [
"6110.20"
]
}
],
"entryPorts": [
"Los Angeles, Calif",
"Long Beach, Calif"
],
"goodsDescriptions": [
"100% COTTON KNITTED MENS T-SHIRTS",
"LADIES COTTON CREW NECK TEE",
"COTTON PULLOVER SWEATSHIRTS"
],
"topCarriers": [
{
"name": "Maersk Line",
"code": "MAEU",
"shipments12m": 40,
"shipmentsTotal": 260
}
]
},
{
"name": "Northgate Outlet Stores Inc",
"url": "https://www.importyeti.com/company/sample-northgate-outlet-stores",
"address": "800 Commerce Pkwy, Columbus, OH 43219, US",
"website": "northgate-outlet.example",
"shipmentsTotal": 1960,
"shipments12m": 210,
"shipmentsPrior12m": 190,
"firstArrival": "2014-06-02",
"lastArrival": "2026-10-15",
"weightKg12m": 905000,
"teu12m": 388,
"hsCodes": [
"6109.10",
"6203.42"
],
"topSuppliers": [
{
"name": "Chittagong Apparel Ltd",
"country": "Bangladesh",
"countryCode": "BD",
"shipments12m": 120,
"hsCodes": [
"6109.10"
]
},
{
"name": "Saigon Textile JSC",
"country": "Vietnam",
"countryCode": "VN",
"shipments12m": 60,
"hsCodes": [
"6203.42"
]
},
{
"name": "Phnom Penh Knitwear",
"country": "Cambodia",
"countryCode": "KH",
"shipments12m": 30,
"hsCodes": [
"6109.10"
]
}
],
"entryPorts": [
"Savannah, Ga",
"New York/Newark Area"
],
"goodsDescriptions": [
"MENS 100 PCT COTTON T-SHIRTS",
"MENS DENIM TROUSERS",
"BOYS COTTON TEES"
],
"topCarriers": [
{
"name": "MSC Mediterranean Shipping",
"code": "MSCU",
"shipments12m": 140,
"shipmentsTotal": 1300
}
]
},
{
"name": "Cedar Lane Distributors LLC",
"url": "https://www.importyeti.com/company/sample-cedar-lane-distributors",
"address": "55 Industrial Rd, Edison, NJ 08817, US",
"phone": "+1 732 555 0190",
"shipmentsTotal": 160,
"shipments12m": 22,
"shipmentsPrior12m": 30,
"firstArrival": "2019-01-09",
"lastArrival": "2026-08-28",
"weightKg12m": 61000,
"teu12m": 24,
"hsCodes": [
"6109.90",
"6302.60"
],
"topSuppliers": [
{
"name": "Faisalabad Knits Pvt",
"country": "Pakistan",
"countryCode": "PK",
"shipments12m": 12,
"hsCodes": [
"6109.90"
]
},
{
"name": "Karur Home Textiles",
"country": "India",
"countryCode": "IN",
"shipments12m": 4,
"hsCodes": [
"6302.60"
]
}
],
"entryPorts": [
"New York/Newark Area"
],
"goodsDescriptions": [
"COTTON BLEND T SHIRTS",
"TERRY BATH TOWELS"
]
},
{
"name": "Bluefin Promotional Products",
"url": "https://www.importyeti.com/company/sample-bluefin-promotional",
"address": "410 Harbor Blvd, Tampa, FL 33602, US",
"website": "bluefin-promo.example",
"shipmentsTotal": 21,
"shipments12m": 9,
"shipmentsPrior12m": 4,
"firstArrival": "2023-05-11",
"lastArrival": "2026-09-19",
"weightKg12m": 14800,
"teu12m": 9,
"hsCodes": [
"6109.10"
],
"topSuppliers": [
{
"name": "Ningbo Blank Apparel",
"country": "China",
"countryCode": "CN",
"shipments12m": 9,
"hsCodes": [
"6109.10"
]
}
],
"entryPorts": [
"Tampa, Fla"
],
"goodsDescriptions": [
"BLANK COTTON TEES FOR SCREEN PRINTING"
]
},
{
"name": "Swift Ocean Logistics Inc",
"url": "https://www.importyeti.com/company/sample-swift-ocean-logistics",
"address": "1 World Trade Ctr, Long Beach, CA 90831, US",
"shipmentsTotal": 5300,
"shipments12m": 640,
"shipmentsPrior12m": 600,
"firstArrival": "2012-02-01",
"lastArrival": "2026-10-18",
"hsCodes": [
"6109.10",
"8471.30",
"9403.60"
],
"topSuppliers": [
{
"name": "Various Shippers Hong Kong",
"country": "Hong Kong",
"countryCode": "HK",
"shipments12m": 400
}
],
"entryPorts": [
"Long Beach, Calif"
],
"goodsDescriptions": [
"CONSOLIDATED CARGO SAID TO CONTAIN GARMENTS",
"FURNITURE PARTS"
]
},
{
"name": "Maple Ridge Home Goods",
"url": "https://www.importyeti.com/company/sample-maple-ridge-home",
"address": "92 Mill St, Burlington, VT 05401, US",
"shipmentsTotal": 48,
"shipments12m": 15,
"shipmentsPrior12m": 15,
"firstArrival": "2020-04-20",
"lastArrival": "2026-07-01",
"hsCodes": [
"6912.00"
],
"topSuppliers": [
{
"name": "Chaozhou Ceramics Factory",
"country": "China",
"countryCode": "CN",
"shipments12m": 15,
"hsCodes": [
"6912.00"
]
}
],
"entryPorts": [
"Boston, Mass"
],
"goodsDescriptions": [
"STONEWARE COFFEE MUGS",
"PORCELAIN DINNERWARE SETS"
],
"uflpaExposed": true
},
{
"name": "Lakeshore Living Furniture Inc",
"url": "https://www.importyeti.com/company/sample-lakeshore-living-furniture",
"address": "1800 Furniture Row, High Point, NC 27260, US",
"website": "lakeshore-living.example",
"shipmentsTotal": 530,
"shipments12m": 118,
"shipmentsPrior12m": 96,
"firstArrival": "2016-02-09",
"lastArrival": "2026-10-12",
"weightKg12m": 1460000,
"teu12m": 260,
"hsCodes": [
"9403.60",
"9401.61"
],
"topSuppliers": [
{
"name": "Binh Duong Woodcraft JSC",
"country": "Vietnam",
"countryCode": "VN",
"shipments12m": 70,
"hsCodes": [
"9403.60"
]
},
{
"name": "Foshan Home Furnishing Co",
"country": "China",
"countryCode": "CN",
"shipments12m": 48,
"hsCodes": [
"9401.61"
]
}
],
"entryPorts": [
"Savannah, Ga",
"Norfolk, Va"
],
"goodsDescriptions": [
"WOODEN FURNITURE: DINING TABLES AND CHAIRS",
"SOLID ACACIA WOOD BEDROOM FURNITURE"
],
"topCarriers": [
{
"name": "Evergreen Marine",
"code": "EGLV",
"shipments12m": 70,
"shipmentsTotal": 320
},
{
"name": "CMA CGM",
"code": "CMDU",
"shipments12m": 48,
"shipmentsTotal": 210
}
]
},
{
"name": "Driftwood Bath & Linen Co",
"url": "https://www.importyeti.com/company/sample-driftwood-bath-linen",
"address": "4400 Harbor Pkwy, Charleston, SC 29405, US",
"website": "driftwood-linen.example",
"shipmentsTotal": 240,
"shipments12m": 54,
"shipmentsPrior12m": 50,
"firstArrival": "2018-09-03",
"lastArrival": "2026-10-02",
"weightKg12m": 268000,
"teu12m": 62,
"hsCodes": [
"6302.60",
"6302.21"
],
"topSuppliers": [
{
"name": "Denizli Havlu Tekstil AS",
"country": "Turkey",
"countryCode": "TR",
"shipments12m": 30,
"hsCodes": [
"6302.60"
]
},
{
"name": "Karur Home Textiles",
"country": "India",
"countryCode": "IN",
"shipments12m": 24,
"hsCodes": [
"6302.21"
]
}
],
"entryPorts": [
"Charleston, S.C."
],
"goodsDescriptions": [
"100% COTTON TERRY BATH TOWELS",
"COTTON BED LINEN SETS"
]
},
{
"name": "Sunrise Specialty Foods Corp",
"url": "https://www.importyeti.com/company/sample-sunrise-specialty-foods",
"address": "9 Produce Market Rd, Edison, NJ 08837, US",
"phone": "+1 732 555 0144",
"shipmentsTotal": 310,
"shipments12m": 76,
"shipmentsPrior12m": 61,
"firstArrival": "2015-11-20",
"lastArrival": "2026-10-09",
"weightKg12m": 1820000,
"teu12m": 92,
"hsCodes": [
"1006.30",
"0713.31"
],
"topSuppliers": [
{
"name": "Amritsar Basmati Exports Pvt",
"country": "India",
"countryCode": "IN",
"shipments12m": 52,
"hsCodes": [
"1006.30"
]
},
{
"name": "Lahore Grain Traders",
"country": "Pakistan",
"countryCode": "PK",
"shipments12m": 24,
"hsCodes": [
"1006.30"
]
}
],
"entryPorts": [
"New York/Newark Area"
],
"goodsDescriptions": [
"BASMATI RICE 1121 STEAM 20 KG BAGS",
"PULSES AND LENTILS"
]
},
{
"name": "Granite Peak Tile & Stone LLC",
"url": "https://www.importyeti.com/company/sample-granite-peak-tile",
"address": "7701 Industrial Blvd, Dallas, TX 75247, US",
"website": "granitepeak-tile.example",
"shipmentsTotal": 190,
"shipments12m": 41,
"shipmentsPrior12m": 33,
"firstArrival": "2019-06-17",
"lastArrival": "2026-09-27",
"weightKg12m": 1110000,
"teu12m": 55,
"hsCodes": [
"6907.21",
"6907.22"
],
"topSuppliers": [
{
"name": "Morbi Ceramic Works",
"country": "India",
"countryCode": "IN",
"shipments12m": 29,
"hsCodes": [
"6907.21"
]
},
{
"name": "Foshan Porcelain Tiles Co",
"country": "China",
"countryCode": "CN",
"shipments12m": 12,
"hsCodes": [
"6907.22"
]
}
],
"entryPorts": [
"Houston, Tex"
],
"goodsDescriptions": [
"GLAZED PORCELAIN FLOOR TILES 600X600",
"CERAMIC WALL TILES"
]
}
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("rich_minds/us-importer-finder-ai").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 = {
"maxDiscoveryChargeUsd": 0.5,
"maxImporters": 30,
"sourceMode": "list",
"itemsList": [
{
"name": "Harbor & Pine Apparel Co",
"url": "https://www.importyeti.com/company/sample-harbor-pine-apparel",
"address": "2140 E 7th St, Los Angeles, CA 90021, US",
"website": "harborpine-apparel.example",
"shipmentsTotal": 412,
"shipments12m": 64,
"shipmentsPrior12m": 48,
"firstArrival": "2017-03-14",
"lastArrival": "2026-10-06",
"weightKg12m": 182400,
"teu12m": 71.5,
"hsCodes": [
"6109.10",
"6110.20",
],
"topSuppliers": [
{
"name": "Tiruppur Knit Exports",
"country": "India",
"countryCode": "IN",
"shipments12m": 38,
"hsCodes": ["6109.10"],
},
{
"name": "Dhaka Cotton Wear",
"country": "Bangladesh",
"countryCode": "BD",
"shipments12m": 20,
"hsCodes": ["6109.10"],
},
{
"name": "Jiangsu Garment Co",
"country": "China",
"countryCode": "CN",
"shipments12m": 6,
"hsCodes": ["6110.20"],
},
],
"entryPorts": [
"Los Angeles, Calif",
"Long Beach, Calif",
],
"goodsDescriptions": [
"100% COTTON KNITTED MENS T-SHIRTS",
"LADIES COTTON CREW NECK TEE",
"COTTON PULLOVER SWEATSHIRTS",
],
"topCarriers": [{
"name": "Maersk Line",
"code": "MAEU",
"shipments12m": 40,
"shipmentsTotal": 260,
}],
},
{
"name": "Northgate Outlet Stores Inc",
"url": "https://www.importyeti.com/company/sample-northgate-outlet-stores",
"address": "800 Commerce Pkwy, Columbus, OH 43219, US",
"website": "northgate-outlet.example",
"shipmentsTotal": 1960,
"shipments12m": 210,
"shipmentsPrior12m": 190,
"firstArrival": "2014-06-02",
"lastArrival": "2026-10-15",
"weightKg12m": 905000,
"teu12m": 388,
"hsCodes": [
"6109.10",
"6203.42",
],
"topSuppliers": [
{
"name": "Chittagong Apparel Ltd",
"country": "Bangladesh",
"countryCode": "BD",
"shipments12m": 120,
"hsCodes": ["6109.10"],
},
{
"name": "Saigon Textile JSC",
"country": "Vietnam",
"countryCode": "VN",
"shipments12m": 60,
"hsCodes": ["6203.42"],
},
{
"name": "Phnom Penh Knitwear",
"country": "Cambodia",
"countryCode": "KH",
"shipments12m": 30,
"hsCodes": ["6109.10"],
},
],
"entryPorts": [
"Savannah, Ga",
"New York/Newark Area",
],
"goodsDescriptions": [
"MENS 100 PCT COTTON T-SHIRTS",
"MENS DENIM TROUSERS",
"BOYS COTTON TEES",
],
"topCarriers": [{
"name": "MSC Mediterranean Shipping",
"code": "MSCU",
"shipments12m": 140,
"shipmentsTotal": 1300,
}],
},
{
"name": "Cedar Lane Distributors LLC",
"url": "https://www.importyeti.com/company/sample-cedar-lane-distributors",
"address": "55 Industrial Rd, Edison, NJ 08817, US",
"phone": "+1 732 555 0190",
"shipmentsTotal": 160,
"shipments12m": 22,
"shipmentsPrior12m": 30,
"firstArrival": "2019-01-09",
"lastArrival": "2026-08-28",
"weightKg12m": 61000,
"teu12m": 24,
"hsCodes": [
"6109.90",
"6302.60",
],
"topSuppliers": [
{
"name": "Faisalabad Knits Pvt",
"country": "Pakistan",
"countryCode": "PK",
"shipments12m": 12,
"hsCodes": ["6109.90"],
},
{
"name": "Karur Home Textiles",
"country": "India",
"countryCode": "IN",
"shipments12m": 4,
"hsCodes": ["6302.60"],
},
],
"entryPorts": ["New York/Newark Area"],
"goodsDescriptions": [
"COTTON BLEND T SHIRTS",
"TERRY BATH TOWELS",
],
},
{
"name": "Bluefin Promotional Products",
"url": "https://www.importyeti.com/company/sample-bluefin-promotional",
"address": "410 Harbor Blvd, Tampa, FL 33602, US",
"website": "bluefin-promo.example",
"shipmentsTotal": 21,
"shipments12m": 9,
"shipmentsPrior12m": 4,
"firstArrival": "2023-05-11",
"lastArrival": "2026-09-19",
"weightKg12m": 14800,
"teu12m": 9,
"hsCodes": ["6109.10"],
"topSuppliers": [{
"name": "Ningbo Blank Apparel",
"country": "China",
"countryCode": "CN",
"shipments12m": 9,
"hsCodes": ["6109.10"],
}],
"entryPorts": ["Tampa, Fla"],
"goodsDescriptions": ["BLANK COTTON TEES FOR SCREEN PRINTING"],
},
{
"name": "Swift Ocean Logistics Inc",
"url": "https://www.importyeti.com/company/sample-swift-ocean-logistics",
"address": "1 World Trade Ctr, Long Beach, CA 90831, US",
"shipmentsTotal": 5300,
"shipments12m": 640,
"shipmentsPrior12m": 600,
"firstArrival": "2012-02-01",
"lastArrival": "2026-10-18",
"hsCodes": [
"6109.10",
"8471.30",
"9403.60",
],
"topSuppliers": [{
"name": "Various Shippers Hong Kong",
"country": "Hong Kong",
"countryCode": "HK",
"shipments12m": 400,
}],
"entryPorts": ["Long Beach, Calif"],
"goodsDescriptions": [
"CONSOLIDATED CARGO SAID TO CONTAIN GARMENTS",
"FURNITURE PARTS",
],
},
{
"name": "Maple Ridge Home Goods",
"url": "https://www.importyeti.com/company/sample-maple-ridge-home",
"address": "92 Mill St, Burlington, VT 05401, US",
"shipmentsTotal": 48,
"shipments12m": 15,
"shipmentsPrior12m": 15,
"firstArrival": "2020-04-20",
"lastArrival": "2026-07-01",
"hsCodes": ["6912.00"],
"topSuppliers": [{
"name": "Chaozhou Ceramics Factory",
"country": "China",
"countryCode": "CN",
"shipments12m": 15,
"hsCodes": ["6912.00"],
}],
"entryPorts": ["Boston, Mass"],
"goodsDescriptions": [
"STONEWARE COFFEE MUGS",
"PORCELAIN DINNERWARE SETS",
],
"uflpaExposed": True,
},
{
"name": "Lakeshore Living Furniture Inc",
"url": "https://www.importyeti.com/company/sample-lakeshore-living-furniture",
"address": "1800 Furniture Row, High Point, NC 27260, US",
"website": "lakeshore-living.example",
"shipmentsTotal": 530,
"shipments12m": 118,
"shipmentsPrior12m": 96,
"firstArrival": "2016-02-09",
"lastArrival": "2026-10-12",
"weightKg12m": 1460000,
"teu12m": 260,
"hsCodes": [
"9403.60",
"9401.61",
],
"topSuppliers": [
{
"name": "Binh Duong Woodcraft JSC",
"country": "Vietnam",
"countryCode": "VN",
"shipments12m": 70,
"hsCodes": ["9403.60"],
},
{
"name": "Foshan Home Furnishing Co",
"country": "China",
"countryCode": "CN",
"shipments12m": 48,
"hsCodes": ["9401.61"],
},
],
"entryPorts": [
"Savannah, Ga",
"Norfolk, Va",
],
"goodsDescriptions": [
"WOODEN FURNITURE: DINING TABLES AND CHAIRS",
"SOLID ACACIA WOOD BEDROOM FURNITURE",
],
"topCarriers": [
{
"name": "Evergreen Marine",
"code": "EGLV",
"shipments12m": 70,
"shipmentsTotal": 320,
},
{
"name": "CMA CGM",
"code": "CMDU",
"shipments12m": 48,
"shipmentsTotal": 210,
},
],
},
{
"name": "Driftwood Bath & Linen Co",
"url": "https://www.importyeti.com/company/sample-driftwood-bath-linen",
"address": "4400 Harbor Pkwy, Charleston, SC 29405, US",
"website": "driftwood-linen.example",
"shipmentsTotal": 240,
"shipments12m": 54,
"shipmentsPrior12m": 50,
"firstArrival": "2018-09-03",
"lastArrival": "2026-10-02",
"weightKg12m": 268000,
"teu12m": 62,
"hsCodes": [
"6302.60",
"6302.21",
],
"topSuppliers": [
{
"name": "Denizli Havlu Tekstil AS",
"country": "Turkey",
"countryCode": "TR",
"shipments12m": 30,
"hsCodes": ["6302.60"],
},
{
"name": "Karur Home Textiles",
"country": "India",
"countryCode": "IN",
"shipments12m": 24,
"hsCodes": ["6302.21"],
},
],
"entryPorts": ["Charleston, S.C."],
"goodsDescriptions": [
"100% COTTON TERRY BATH TOWELS",
"COTTON BED LINEN SETS",
],
},
{
"name": "Sunrise Specialty Foods Corp",
"url": "https://www.importyeti.com/company/sample-sunrise-specialty-foods",
"address": "9 Produce Market Rd, Edison, NJ 08837, US",
"phone": "+1 732 555 0144",
"shipmentsTotal": 310,
"shipments12m": 76,
"shipmentsPrior12m": 61,
"firstArrival": "2015-11-20",
"lastArrival": "2026-10-09",
"weightKg12m": 1820000,
"teu12m": 92,
"hsCodes": [
"1006.30",
"0713.31",
],
"topSuppliers": [
{
"name": "Amritsar Basmati Exports Pvt",
"country": "India",
"countryCode": "IN",
"shipments12m": 52,
"hsCodes": ["1006.30"],
},
{
"name": "Lahore Grain Traders",
"country": "Pakistan",
"countryCode": "PK",
"shipments12m": 24,
"hsCodes": ["1006.30"],
},
],
"entryPorts": ["New York/Newark Area"],
"goodsDescriptions": [
"BASMATI RICE 1121 STEAM 20 KG BAGS",
"PULSES AND LENTILS",
],
},
{
"name": "Granite Peak Tile & Stone LLC",
"url": "https://www.importyeti.com/company/sample-granite-peak-tile",
"address": "7701 Industrial Blvd, Dallas, TX 75247, US",
"website": "granitepeak-tile.example",
"shipmentsTotal": 190,
"shipments12m": 41,
"shipmentsPrior12m": 33,
"firstArrival": "2019-06-17",
"lastArrival": "2026-09-27",
"weightKg12m": 1110000,
"teu12m": 55,
"hsCodes": [
"6907.21",
"6907.22",
],
"topSuppliers": [
{
"name": "Morbi Ceramic Works",
"country": "India",
"countryCode": "IN",
"shipments12m": 29,
"hsCodes": ["6907.21"],
},
{
"name": "Foshan Porcelain Tiles Co",
"country": "China",
"countryCode": "CN",
"shipments12m": 12,
"hsCodes": ["6907.22"],
},
],
"entryPorts": ["Houston, Tex"],
"goodsDescriptions": [
"GLAZED PORCELAIN FLOOR TILES 600X600",
"CERAMIC WALL TILES",
],
},
],
}
# Run the Actor and wait for it to finish
run = client.actor("rich_minds/us-importer-finder-ai").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 '{
"maxDiscoveryChargeUsd": 0.5,
"maxImporters": 30,
"sourceMode": "list",
"itemsList": [
{
"name": "Harbor & Pine Apparel Co",
"url": "https://www.importyeti.com/company/sample-harbor-pine-apparel",
"address": "2140 E 7th St, Los Angeles, CA 90021, US",
"website": "harborpine-apparel.example",
"shipmentsTotal": 412,
"shipments12m": 64,
"shipmentsPrior12m": 48,
"firstArrival": "2017-03-14",
"lastArrival": "2026-10-06",
"weightKg12m": 182400,
"teu12m": 71.5,
"hsCodes": [
"6109.10",
"6110.20"
],
"topSuppliers": [
{
"name": "Tiruppur Knit Exports",
"country": "India",
"countryCode": "IN",
"shipments12m": 38,
"hsCodes": [
"6109.10"
]
},
{
"name": "Dhaka Cotton Wear",
"country": "Bangladesh",
"countryCode": "BD",
"shipments12m": 20,
"hsCodes": [
"6109.10"
]
},
{
"name": "Jiangsu Garment Co",
"country": "China",
"countryCode": "CN",
"shipments12m": 6,
"hsCodes": [
"6110.20"
]
}
],
"entryPorts": [
"Los Angeles, Calif",
"Long Beach, Calif"
],
"goodsDescriptions": [
"100% COTTON KNITTED MENS T-SHIRTS",
"LADIES COTTON CREW NECK TEE",
"COTTON PULLOVER SWEATSHIRTS"
],
"topCarriers": [
{
"name": "Maersk Line",
"code": "MAEU",
"shipments12m": 40,
"shipmentsTotal": 260
}
]
},
{
"name": "Northgate Outlet Stores Inc",
"url": "https://www.importyeti.com/company/sample-northgate-outlet-stores",
"address": "800 Commerce Pkwy, Columbus, OH 43219, US",
"website": "northgate-outlet.example",
"shipmentsTotal": 1960,
"shipments12m": 210,
"shipmentsPrior12m": 190,
"firstArrival": "2014-06-02",
"lastArrival": "2026-10-15",
"weightKg12m": 905000,
"teu12m": 388,
"hsCodes": [
"6109.10",
"6203.42"
],
"topSuppliers": [
{
"name": "Chittagong Apparel Ltd",
"country": "Bangladesh",
"countryCode": "BD",
"shipments12m": 120,
"hsCodes": [
"6109.10"
]
},
{
"name": "Saigon Textile JSC",
"country": "Vietnam",
"countryCode": "VN",
"shipments12m": 60,
"hsCodes": [
"6203.42"
]
},
{
"name": "Phnom Penh Knitwear",
"country": "Cambodia",
"countryCode": "KH",
"shipments12m": 30,
"hsCodes": [
"6109.10"
]
}
],
"entryPorts": [
"Savannah, Ga",
"New York/Newark Area"
],
"goodsDescriptions": [
"MENS 100 PCT COTTON T-SHIRTS",
"MENS DENIM TROUSERS",
"BOYS COTTON TEES"
],
"topCarriers": [
{
"name": "MSC Mediterranean Shipping",
"code": "MSCU",
"shipments12m": 140,
"shipmentsTotal": 1300
}
]
},
{
"name": "Cedar Lane Distributors LLC",
"url": "https://www.importyeti.com/company/sample-cedar-lane-distributors",
"address": "55 Industrial Rd, Edison, NJ 08817, US",
"phone": "+1 732 555 0190",
"shipmentsTotal": 160,
"shipments12m": 22,
"shipmentsPrior12m": 30,
"firstArrival": "2019-01-09",
"lastArrival": "2026-08-28",
"weightKg12m": 61000,
"teu12m": 24,
"hsCodes": [
"6109.90",
"6302.60"
],
"topSuppliers": [
{
"name": "Faisalabad Knits Pvt",
"country": "Pakistan",
"countryCode": "PK",
"shipments12m": 12,
"hsCodes": [
"6109.90"
]
},
{
"name": "Karur Home Textiles",
"country": "India",
"countryCode": "IN",
"shipments12m": 4,
"hsCodes": [
"6302.60"
]
}
],
"entryPorts": [
"New York/Newark Area"
],
"goodsDescriptions": [
"COTTON BLEND T SHIRTS",
"TERRY BATH TOWELS"
]
},
{
"name": "Bluefin Promotional Products",
"url": "https://www.importyeti.com/company/sample-bluefin-promotional",
"address": "410 Harbor Blvd, Tampa, FL 33602, US",
"website": "bluefin-promo.example",
"shipmentsTotal": 21,
"shipments12m": 9,
"shipmentsPrior12m": 4,
"firstArrival": "2023-05-11",
"lastArrival": "2026-09-19",
"weightKg12m": 14800,
"teu12m": 9,
"hsCodes": [
"6109.10"
],
"topSuppliers": [
{
"name": "Ningbo Blank Apparel",
"country": "China",
"countryCode": "CN",
"shipments12m": 9,
"hsCodes": [
"6109.10"
]
}
],
"entryPorts": [
"Tampa, Fla"
],
"goodsDescriptions": [
"BLANK COTTON TEES FOR SCREEN PRINTING"
]
},
{
"name": "Swift Ocean Logistics Inc",
"url": "https://www.importyeti.com/company/sample-swift-ocean-logistics",
"address": "1 World Trade Ctr, Long Beach, CA 90831, US",
"shipmentsTotal": 5300,
"shipments12m": 640,
"shipmentsPrior12m": 600,
"firstArrival": "2012-02-01",
"lastArrival": "2026-10-18",
"hsCodes": [
"6109.10",
"8471.30",
"9403.60"
],
"topSuppliers": [
{
"name": "Various Shippers Hong Kong",
"country": "Hong Kong",
"countryCode": "HK",
"shipments12m": 400
}
],
"entryPorts": [
"Long Beach, Calif"
],
"goodsDescriptions": [
"CONSOLIDATED CARGO SAID TO CONTAIN GARMENTS",
"FURNITURE PARTS"
]
},
{
"name": "Maple Ridge Home Goods",
"url": "https://www.importyeti.com/company/sample-maple-ridge-home",
"address": "92 Mill St, Burlington, VT 05401, US",
"shipmentsTotal": 48,
"shipments12m": 15,
"shipmentsPrior12m": 15,
"firstArrival": "2020-04-20",
"lastArrival": "2026-07-01",
"hsCodes": [
"6912.00"
],
"topSuppliers": [
{
"name": "Chaozhou Ceramics Factory",
"country": "China",
"countryCode": "CN",
"shipments12m": 15,
"hsCodes": [
"6912.00"
]
}
],
"entryPorts": [
"Boston, Mass"
],
"goodsDescriptions": [
"STONEWARE COFFEE MUGS",
"PORCELAIN DINNERWARE SETS"
],
"uflpaExposed": true
},
{
"name": "Lakeshore Living Furniture Inc",
"url": "https://www.importyeti.com/company/sample-lakeshore-living-furniture",
"address": "1800 Furniture Row, High Point, NC 27260, US",
"website": "lakeshore-living.example",
"shipmentsTotal": 530,
"shipments12m": 118,
"shipmentsPrior12m": 96,
"firstArrival": "2016-02-09",
"lastArrival": "2026-10-12",
"weightKg12m": 1460000,
"teu12m": 260,
"hsCodes": [
"9403.60",
"9401.61"
],
"topSuppliers": [
{
"name": "Binh Duong Woodcraft JSC",
"country": "Vietnam",
"countryCode": "VN",
"shipments12m": 70,
"hsCodes": [
"9403.60"
]
},
{
"name": "Foshan Home Furnishing Co",
"country": "China",
"countryCode": "CN",
"shipments12m": 48,
"hsCodes": [
"9401.61"
]
}
],
"entryPorts": [
"Savannah, Ga",
"Norfolk, Va"
],
"goodsDescriptions": [
"WOODEN FURNITURE: DINING TABLES AND CHAIRS",
"SOLID ACACIA WOOD BEDROOM FURNITURE"
],
"topCarriers": [
{
"name": "Evergreen Marine",
"code": "EGLV",
"shipments12m": 70,
"shipmentsTotal": 320
},
{
"name": "CMA CGM",
"code": "CMDU",
"shipments12m": 48,
"shipmentsTotal": 210
}
]
},
{
"name": "Driftwood Bath & Linen Co",
"url": "https://www.importyeti.com/company/sample-driftwood-bath-linen",
"address": "4400 Harbor Pkwy, Charleston, SC 29405, US",
"website": "driftwood-linen.example",
"shipmentsTotal": 240,
"shipments12m": 54,
"shipmentsPrior12m": 50,
"firstArrival": "2018-09-03",
"lastArrival": "2026-10-02",
"weightKg12m": 268000,
"teu12m": 62,
"hsCodes": [
"6302.60",
"6302.21"
],
"topSuppliers": [
{
"name": "Denizli Havlu Tekstil AS",
"country": "Turkey",
"countryCode": "TR",
"shipments12m": 30,
"hsCodes": [
"6302.60"
]
},
{
"name": "Karur Home Textiles",
"country": "India",
"countryCode": "IN",
"shipments12m": 24,
"hsCodes": [
"6302.21"
]
}
],
"entryPorts": [
"Charleston, S.C."
],
"goodsDescriptions": [
"100% COTTON TERRY BATH TOWELS",
"COTTON BED LINEN SETS"
]
},
{
"name": "Sunrise Specialty Foods Corp",
"url": "https://www.importyeti.com/company/sample-sunrise-specialty-foods",
"address": "9 Produce Market Rd, Edison, NJ 08837, US",
"phone": "+1 732 555 0144",
"shipmentsTotal": 310,
"shipments12m": 76,
"shipmentsPrior12m": 61,
"firstArrival": "2015-11-20",
"lastArrival": "2026-10-09",
"weightKg12m": 1820000,
"teu12m": 92,
"hsCodes": [
"1006.30",
"0713.31"
],
"topSuppliers": [
{
"name": "Amritsar Basmati Exports Pvt",
"country": "India",
"countryCode": "IN",
"shipments12m": 52,
"hsCodes": [
"1006.30"
]
},
{
"name": "Lahore Grain Traders",
"country": "Pakistan",
"countryCode": "PK",
"shipments12m": 24,
"hsCodes": [
"1006.30"
]
}
],
"entryPorts": [
"New York/Newark Area"
],
"goodsDescriptions": [
"BASMATI RICE 1121 STEAM 20 KG BAGS",
"PULSES AND LENTILS"
]
},
{
"name": "Granite Peak Tile & Stone LLC",
"url": "https://www.importyeti.com/company/sample-granite-peak-tile",
"address": "7701 Industrial Blvd, Dallas, TX 75247, US",
"website": "granitepeak-tile.example",
"shipmentsTotal": 190,
"shipments12m": 41,
"shipmentsPrior12m": 33,
"firstArrival": "2019-06-17",
"lastArrival": "2026-09-27",
"weightKg12m": 1110000,
"teu12m": 55,
"hsCodes": [
"6907.21",
"6907.22"
],
"topSuppliers": [
{
"name": "Morbi Ceramic Works",
"country": "India",
"countryCode": "IN",
"shipments12m": 29,
"hsCodes": [
"6907.21"
]
},
{
"name": "Foshan Porcelain Tiles Co",
"country": "China",
"countryCode": "CN",
"shipments12m": 12,
"hsCodes": [
"6907.22"
]
}
],
"entryPorts": [
"Houston, Tex"
],
"goodsDescriptions": [
"GLAZED PORCELAIN FLOOR TILES 600X600",
"CERAMIC WALL TILES"
]
}
]
}' |
apify call rich_minds/us-importer-finder-ai --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"type": "http",
"url": "https://mcp.apify.com/?tools=fetch-actor-details,rich_minds/us-importer-finder-ai"
}
}
}
```
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 ` 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/WDtpWtnK8aPrxkMAC/builds/rLYOi4IsmbpyoIlj4/openapi.json