Question 1

Where do the companies come from?

Accepted Answer

From ImportYeti's own directory pages: a product keyword reads its tag page (up to 20 US importers and 20 suppliers), an HS code its HS-code page (up to 50 and 50), a country its supplier page (50 suppliers). Every company listed there is then opened on its own profile page. These pages have no page two, so when you ask for more than a page lists, the run returns what it lists and says so on a free row; another keyword or an HS code lists different companies. The Actor never uses ImportYeti's search box, which sits behind a Cloudflare challenge and is excluded in its robots.txt.

Question 2

Does it return the product description on each shipment?

Accepted Answer

Yes. Switch on 'Include recent bills of lading' and each profile adds its 50 most recent shipments as free rows, with the product description read from the data the page embeds for its own front end (it is filled into the visible table only after the page loads). Each row also carries the carrier, named from the bill of lading's SCAC prefix using the carrier table on the same page.

Question 3

Where do contact details come from?

Accepted Answer

Two places, both public. The phone numbers ImportYeti publishes for the company, and the emails, phones and social links on the company's own website (the address in the website field). ImportYeti's own emails and LinkedIn link are locked on its site and are not in the page at all, so they cannot be returned. The contact option opens on 2026-11-14, when its price starts, and is charged only for a profile where at least one email or phone was found.

Question 4

Why does it use a proxy, and who pays for it?

Accepted Answer

ImportYeti limits each IP address to 25 page views and then asks for a login. A product query is one list page plus up to 40 profiles, so the run moves to a fresh Apify Proxy IP every 20 pages, and again if an IP was already used up. Proxy traffic is platform usage on your Apify plan, billed like compute; the Actor's own charge is per profile. If a run still cannot get through, it ends with a free 'blocked' row saying how many profiles it fetched.

Question 5

How far back does the shipment history go?

Accepted Answer

Profiles carry ImportYeti's totals over all the shipments it holds. The bill-of-lading rows are the 50 most recent per company: the free page serves 50 and has no page two. Deeper history is behind ImportYeti's paid plans.

Question 6

What does a company that matches nothing cost?

Accepted Answer

Nothing. Filters (importers or suppliers, 12-month activity, minimum shipments, country) are applied to the directory list before any profile is opened, so a skipped company is never fetched or charged. A query ImportYeti has no page for returns a free 'no_match' row.

Field	Type
`name`	string\|null
`entity_type`	string\|null
`address`	string\|null
`city`	string\|null
`region`	string\|null
`country`	string\|null
`country_code`	string\|null
`total_shipments`	integer\|null
`shipments_12m`	integer\|null
`most_recent_shipment`	string\|null
`avg_teu_per_month`	number\|null
`avg_teu_per_shipment`	number\|null
`total_shipping_cost_usd`	number\|null
`shipping_cost_coverage_pct`	number\|null
`hs_codes`	array\|null
`hs_chapters`	array\|null
`product_descriptions`	string\|null
`top_carriers`	array\|null
`website`	string\|null
`other_websites`	array\|null
`other_names_count`	integer\|null
`other_addresses_count`	integer\|null
`uflpa_flag`	boolean\|null
`phones`	array\|null
`emails`	array\|null
`social_links`	array\|null
`contact_source_url`	string\|null
`shipment_date`	string\|null
`bill_of_lading`	string\|null
`master_bill_of_lading`	string\|null
`carrier`	string\|null
`partner_name`	string\|null
`partner_country`	string\|null
`weight_kg`	number\|null
`product_description`	string\|null
`profile_name`	string\|null
`partner_url`	string\|null
`container_count`	integer\|null
`estimated_freight_cost_usd`	number\|null
`requested_query`	string\|null
`source_url`	string\|null
`notice`	string\|null

Field	Type	Req	Default	Description
`mode`	string	no	`"product"`	product: the US importers and the foreign suppliers of a product keyword or HS code. location: the suppliers ImportYeti lists in a country. profile: one named company or supplier.
`query`	string	no	`"hdmi cable"`	product: a keyword ('hdmi cable', 'lithium battery') or an HS code ('850760', '8507.60'). location: a country ('china', 'vietnam'). profile: a company or supplier name ('nike usa'), slug, or ImportYeti URL. Any ImportYeti directory or profile URL also works.
`queries`	array	no	`[]`	Several queries in ONE run, all in the chosen mode. Combined with 'Query'; duplicates are removed. 'Maximum results' applies per query.
`entityType`	string	no	`"any"`	product mode: keep only US importers, only foreign suppliers, or both (interleaved). Location pages list suppliers only.
`activeOnly`	boolean	no	`false`	product and location modes: skip companies with no shipment in the last 12 months. Applied before a profile is fetched, so skipped companies are never charged.
`minShipments`	integer	no	`0`	product and location modes: skip companies with fewer shipments on the listing than this. 0 keeps all.
`country`	string	no	—	product and location modes: keep only companies in this country, as a two-letter code ('CN', 'VN', 'US') or the name ImportYeti uses ('China').
`countries`	array	no	`[]`	As 'Country filter', for several countries at once.
`includeShipments`	boolean	no	`false`	Also return each profile's 50 most recent bills of lading as separate free rows: date, house/master BOL, carrier, the other party, weight (kg), quantity, containers, product description, lane and ImportYeti's freight-cost estimate.
`enrichContacts`	boolean	no	`false`	Add phone numbers ImportYeti publishes for the company, plus emails, phones and social links found on the company's own website. Charged as a separate 'Contact details found' event, only for profiles where at least one email or phone was found.
`maxResults`	integer	no	`20`	Profiles per query. A tag page lists up to 20 importers + 20 suppliers, an HS-code page up to 50 + 50, a country page 50 suppliers; ImportYeti has no page 2, so asking for more returns what is listed and says so on a free row.
`company`	string	no	—	Older input name for a profile query, kept so saved tasks keep working. Without 'Mode', it runs in profile mode.
`companies`	array	no	`[]`	Older batch input for profile queries, kept so saved tasks keep working.
`proxyConfiguration`	object	no	`{"useApifyProxy":true}`	ImportYeti limits each IP address to 25 pages, so the run spreads its pages over fresh Apify Proxy IPs. Leave on; proxy use is billed by Apify as platform usage on your plan.