US Import Data API - ImportYeti Bill of Lading and Suppliers

Pull US customs import data from the official ImportYeti Data API: bills of lading, top US importers and overseas suppliers, company and supplier profiles and product rankings, as clean dataset rows, with your own ImportYeti key.

Bring your own API key. This actor calls only ImportYeti's own documented REST API on data.importyeti.com. It does not scrape importyeti.com.

What it does

• PowerQuery shipment search: search US import bills of lading by product description, HS code, US company, overseas supplier, supplier country, US port of entry, foreign port, vessel, carrier, container, notify party, weight, TEU, BOL type and date range, with AND, OR, NOT, phrases, wildcards and ranges.
• Top US importers and top overseas suppliers: the same filters, ranked by shipment volume or weight, with addresses, websites, phones, ports and HS codes for each company.
• Company and supplier search: find a US importer or an overseas supplier by name, phone or website and get its ImportYeti slug, address, total shipments, most recent shipment and top trading partners.
• Company and supplier profiles: the full ImportYeti profile for each slug: aliases, addresses, website, phone, total shipments, date range, carriers, containers, HS codes, trade lanes, time series, supplier or customer table, recent BOLs and shipping cost.
• BOL lists: every bill of lading number of a US company or a supplier in a date range, optionally opened into full bills of lading.
• Bill of lading lookup: one full US import BOL per number, with about 100 fields: shipper, consignee, notify party, contacts, ports, product, HS code, weight, TEU, vessel, carrier and containers.
• Product rankings: suppliers and US buyers ranked by how specialised they are in a product keyword, filtered by supplier country.
• Flat columns for spreadsheets, plus the complete ImportYeti record under record for every row.
• Not found slugs, unknown BOL numbers, empty searches and refused requests come back as one free row with found: false and a note.

How to get an ImportYeti API key

1. Create an account on importyeti.com and buy data credits (the API runs on prepaid data credits).
2. Open My Account, Settings, API Credits Settings. Your API key and remaining credit balance are shown there.
3. Paste the key into the API key field of this actor, or set it as the DATA_API_KEY environment variable. It is sent only in the IYApiKey header.

ImportYeti charges data credits per call: company and supplier search and the database date are free when you go on to open what you find, profiles cost 1 credit each, a BOL lookup 0.1 credit, and lists, product rankings and PowerQuery 1 credit per 10 records. If you use search on its own, ImportYeti bills it at 0.1 credit per record and may limit it until you ask support to switch billing on. Each run's log reports the credits ImportYeti says it used and the balance left.

Input

Field	Used by	What it does
What to run	all	Picks one of the twelve modes.
Product description, Raw product description, HS code	PowerQuery	Text filters with AND, OR, NOT, parentheses, "phrases" and wildcards (at most one * and three ?).
US company (slug), Overseas supplier (slug)	PowerQuery	Limit to one importer or supplier, such as ikea-supply.
Supplier country, US port of entry, Foreign port of lading, Last visited foreign port, Notify party, Vessel name, Carrier (SCAC), Container ID	PowerQuery	Exact or wildcard filters on the bill of lading.
BOL type	PowerQuery	R regular (carrier filed) or H house (forwarder filed).
Weight, TEU, Company and Supplier total shipments	PowerQuery	Ranges such as [1000 TO 15000] or [10 TO *].
Company phone, Company email, Internal supplier, Include records with no consignee or shipper	PowerQuery	Contact and relationship filters.
Rank by	Top importers, Top suppliers	Shipment count (default) or weight.
Start date, End date	PowerQuery, BOL lists	YYYY-MM-DD or mm/dd/yyyy. ImportYeti defaults to 01/01/2021 through the end of last month.
Company or supplier name, Phone number, Website	Search modes	At least one is needed.
Slugs	Profiles, BOL lists	One slug per line, or a search key such as company/walmart, or an importyeti.com URL.
Open each bill of lading	BOL lists	Turns each BOL number into a full bill of lading row.
BOL numbers	BOL lookup	One number per line.
Product keyword, Supplier countries, Exclude supplier countries	Product modes	The product and the supplier country filter.
Maximum rows	all	Stops the run after this many rows (default 20).
Requests per minute	all	Optional pacing.
API key	all	Your ImportYeti key.

Example output

One PowerQuery shipment search row (illustrative values, field names as ImportYeti documents them; record is shortened):

{
  "mode": "shipmentSearch",
  "found": true,
  "recordType": "bill_of_lading",
  "input": "product_description=furniture",
  "name": "Poliform Usa Inc",
  "slug": "poliform-usa",
  "bolNumber": "CCLLMILS17011590",
  "arrivalDate": "08/21/2017",
  "companyName": "Poliform Usa Inc",
  "supplierName": "Poliform Spa",
  "supplierCountry": "Italy",
  "productDescription": "Kitchen Furniture Bedroom Furniture Living Room Furniture",
  "hsCode": "940340",
  "entryPort": "Newark, Nj",
  "exitPort": "Genova",
  "weight": 1327,
  "teu": 1,
  "vesselName": "Seaspan Chiba",
  "carrier": "CCLL - Cargo Container Line Limited",
  "country": "United States",
  "countryCode": "US",
  "totalShipments": 2066,
  "partners": "Poliform Usa Inc",
  "phone": "+12124211600",
  "position": 1,
  "totalMatches": 1000,
  "note": null,
  "record": { "bol_number": "CCLLMILS17011590", "bol_type": "H", "master_bol_number": "NYKSMILT12616400", "containers": [ { "id": "NYKU3438730", "type": "22G0" } ] },
  "retrievedAt": "2026-10-20T09:00:00.000Z"
}

A top US importers row fills name, slug, address, website, phone, totalShipments, matchingShipments, entryPort, exitPort, hsCode, weight and teu. A product ranking row fills name, slug, matchingShipments, specialization, productDescription and partners.

Pricing

Pay per event, only for rows that carry ImportYeti data. Not found, empty and refused rows are free.

Event	Price
Company or supplier search match	$0.005
Bill of lading number listed	$0.005
Bill of lading returned (lookup, opened list entry, PowerQuery shipment)	$0.01
Ranked importer or supplier (product or PowerQuery ranking)	$0.01
Company or supplier profile	$0.02

ImportYeti data credits are billed separately by ImportYeti on your own account.

FAQ

Is this the official ImportYeti API?

Yes. The actor calls the ImportYeti Data API at data.importyeti.com, the same versioned /v1.0 REST API described on docs.importyeti.com, with your own key. It is not affiliated with or endorsed by ImportYeti.

What data does ImportYeti cover?

ImportYeti compiles US Customs vessel manifests (bills of lading for ocean imports into the United States), matches them to US importers and overseas suppliers, and adds contacts, HS codes, ports, carriers and container details. ImportYeti's API also covers US exports and Mexico customs declarations; this actor wraps the US import routes.

How do I find a company's suppliers?

Run Search US companies with the company name, copy the slug of the right match, then run US company profiles (the supplier table) or PowerQuery top overseas suppliers with that slug in US company (slug).

How do I find US buyers for a product?

Use US buyers ranked by product with a product keyword for specialised buyers, or PowerQuery top US importers with a product description or HS code for the biggest buyers by volume.

How is this different from an ImportYeti scraper?

Scrapers read importyeti.com pages, which ImportYeti's Terms of Service s.6.2 forbids for automated retrieval. This actor uses the paid API that ImportYeti sells for programmatic access, so results come from documented JSON fields and the run uses your own credits.

What happens if my key is missing, wrong or out of credits?

The run ends cleanly with a status message saying what to fix: a missing key, a key ImportYeti rejects (HTTP 401), an empty credit balance (HTTP 403 Not enough credits) or a search limit on the account.

How do I keep costs down?

Keep Maximum rows small while you tune filters, use the search modes to get slugs before opening profiles, and leave Open each bill of lading off unless you need full BOLs.

Licensing note

ImportYeti's Terms of Service (effective 2026-08-21) call data delivered through the API "Purchased Data" (s.5.1) and give a perpetual, irrevocable covenant not to sue over its use, "including modification, publication, distribution, and resale" (s.5.2), with no audit, reporting or field of use restriction (s.5.3); you may keep the data after your subscription ends. Bulk delivery of the full database or a continuous feed is not Purchased Data (s.5.1), and the Services may not be used to copy ImportYeti's database or build a substitute for it (s.6.2). Login credentials may not be shared (s.2.3). Use your own key and check the current Terms and Data Use Policy on importyeti.com before relying on this.

Keywords

US import data API, bill of lading API, US customs data, ImportYeti API, import records, supplier search, find suppliers, US importers list, shipment data, trade data API, HS code search, PowerQuery, freight and container data, sourcing intelligence, lead generation for importers.