ImportYeti Scraper

Turn ImportYeti company, supplier, HS-code, and location pages into structured US import data: recent bills of lading, target summaries, top-partner league tables, and port-to-port trade lanes — in one Actor run and one Dataset.

Features

• Four target types — US importers, foreign suppliers, HS codes (84 / 8471 / 847130), and country/location directories
• Rich embedded payload — reads the page’s full data blob (not just the visible HTML table), including counterparty addresses, routes, and estimated freight cost
• Four record types — bill_of_lading, summary, top_partner, trade_lane (toggle each independently)
• Resume support — when maxItems stops a run early, a resumeCursor is written to run OUTPUT so you can continue without re-processing finished targets
• Public pages only — up to ~50 most-recent shipments per target (site public cap); no login or premium unlock

Input

Field	Type	Default	Description
companies	array	[]	Importer slugs or URLs (apple, /company/walmart, full URL)
suppliers	array	[]	Supplier slugs or URLs
hsCodes	array	[]	2/4/6-digit codes or /hs-codes/... URLs
locations	array	[]	Country slugs (china) or full /location/... URLs
locationType	string	supplier	Directory type for bare country slugs
startUrls	array	[]	Any importyeti.com URL (auto-classified)
includeBols	boolean	true	Emit shipment rows
includeSummary	boolean	true	Emit one summary per target
includeTopPartners	boolean	false	Emit partner league-table rows
includeTradeLanes	boolean	false	Emit port-pair lanes
maxItems	integer	1000	Cap across all record types
resumeCursor	string	—	Cursor from a previous OUTPUT
proxyConfiguration	object	—	Residential US recommended

Example

{
  "companies": ["apple"],
  "includeBols": true,
  "includeSummary": true,
  "includeTopPartners": true,
  "maxItems": 60,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}

Output

Every row shares recordType, targetType, targetSlug, targetUrl, targetName, sourceUrl, scrapedAt.

bill_of_lading

Arrival date, house/master BOL, carrier SCAC, counterparty name + address, weight, quantity, containers, product description, shipping route, estimated freight cost.

summary

Total shipments, most-recent date, website, address, UFLPA flag, trademarks count, top carriers, bill-type mix, and page counts.

top_partner

Partner name/address/country, volumes (shipments, weight, TEU), HS codes, and top counterparties.

trade_lane

Exit/entry ports, region, shipments, weight, TEU, estimated shipping cost.

Notes

• ImportYeti rate-limits and blocks many datacenter IPs. Prefer residential US proxies for production.
• Emails and masked phone numbers behind the site’s paid tier are not included.
• This Actor is independent and not affiliated with ImportYeti.

Use cases

• Supplier discovery and sourcing maps
• Competitor import / freight-lane analysis
• HS-code and tariff exposure research
• Lead lists of active US importers by product or origin country