US Import Shipment Monitor — New Bills of Lading by Importer, Supplier or HS Code

Schedule this actor daily and it tells you only what is new: US customs bills of lading that arrived since the last run for the importers, overseas suppliers, HS codes and product keywords on your watchlist. It remembers every shipment it has already reported, so a daily run costs cents and never repeats itself.

Data comes from public US Customs and Border Protection (CBP) ocean manifest records as republished on ImportYeti (no login, no API key). Records are typically available 5 to 10 days after arrival.

What you get per shipment

Field	Example
bolNumber, masterBolNumber, houseBolNumber, billType	CMDUCHN3760614, regular
arrivalDate	2026-09-22
shipper, shipperAddress, shipperCountry, shipperUrl	Hongkong Sun Rise Trade, China
consignee, consigneeAddress, consigneeCountry, consigneeUrl	Walmart Inc, Bentonville AR
productDescription	Trimmer Blower ... Lithium Ion Batteries Packed Equipment
hsCode (HS-code watches only)	8507
containerCount, weightKg, quantity, quantityUnit	1, 5374, 417, CTN
shippingRoute, estimatedFreightUsd	Asia,Transatlantic, 3377.42
sourceUrl	link to the bill of lading page
watchType, matchedWatch, matchedKeywords	consignee, Walmart, ["battery"]
changeType, firstSeenAt, monitorId	new, ISO timestamp, default

Rows from HS-code watches carry the shipper but no consignee, because the source hides the importer on product pages. Vessel, voyage, ports and notify party are not exposed without a paid login and are therefore not included.

Use cases

• Find who imports what. Watch an HS code (8507 batteries, 9403 furniture, 0804.30 pineapples) and see every new overseas shipper of that product, with weight and container counts.
• Monitor your competitors' suppliers. Watch a competitor as a consignee: each new bill of lading names the factory that shipped to them, what it contained and how much.
• Track a supplier's other customers. Watch a factory as a shipper and learn which US companies receive its goods.
• Lead generation. Combine an HS code with productKeywords to build a daily list of active importers in your niche and hand it to sales.
• Supply-chain risk. Get alerted when a watched supplier starts shipping to a new US customer, or when a customer's volume from a region changes.

Input

Field	Default	Notes
watchConsignees	["Walmart", "Home Depot"]	US importers: company name, ImportYeti slug or /company/... URL
watchShippers	[]	Overseas suppliers: name, slug or /supplier/... URL
watchHsCodes	[]	2 to 6 digit HS codes, dots allowed
productKeywords	[]	Keep only shipments whose cargo description contains one of these words
lookbackDays	30	Arrival-date window; keep at 14 or more because of the publishing lag
maxNewPerWatch	5	Cap per watched company / supplier / HS code
maxItems	10	Cap per run
firstRunMode	emitAll	or baseline
webhookUrl	""	POST target for the run summary
monitorId	default	Separate state per watchlist
proxyConfiguration	Apify residential	Keep it on: the source hides data after 25 company/supplier pageviews per IP, so every page is fetched through a fresh IP

Names are resolved to the matching company with the most shipments and the match is cached in the monitor's state, so the search runs once per name. Pass a slug or URL to pin an exact page.

Each source page lists the 50 most recent shipments of that company, supplier or HS code. For very large importers (thousands of shipments per week) this is a sample of recent activity, not a complete feed; for most companies and suppliers it is complete.

Scheduling

1. Create a task with your watchlist.
2. Run it once with firstRunMode: "baseline" to record the current state without emitting anything (or leave emitAll to get the current shipments right away).
3. Schedule the task daily. Every run emits only shipments that were not seen before and posts the summary to your webhook.

Shipments beyond maxNewPerWatch or maxItems are left unseen and appear on the next run, so nothing is lost when a watch spikes.

Webhook payload

{
  "monitorId": "default",
  "runAt": "2026-09-28T20:00:00.000Z",
  "newCount": 7,
  "scanned": 62,
  "seenTotal": 913,
  "baseline": false,
  "watches": [
    { "watch": "Walmart", "type": "company", "url": "https://www.importyeti.com/company/wal-mart", "title": "Wal Mart", "recent": 28, "newCount": 5 }
  ],
  "shipments": [ { "bolNumber": "...", "arrivalDate": "2026-09-22", "shipper": "...", "consignee": "...", "productDescription": "..." } ]
}

shipments holds the first 50 new records; the full list is in the run's dataset.

Pricing

$0.005 per run plus $0.02 per new shipment. A daily monitor on ten companies that surfaces 20 new shipments a day costs about $12 a month.