ImportYeti Scraper - US Customs Import Records

Look up US customs import records by brand, factory or product: who ships to whom, how many shipments, the goods, the HS code, the ports at each end, and the first and last shipment dates, as one row per trading partner, bill of lading, company profile or search match. No ImportYeti account.

Read this before you budget a run. It is US sea freight only, and only as much history as ImportYeti's own page shows. Air, rail, trucking and outbound shipments are not in the source at all, and a company page lists its largest partner relationships and most recent bills of lading rather than everything ever filed.

Input	Company, supplier or product terms, or ImportYeti company, supplier and search URLs
Output	One row per trading partner, bill of lading, company profile or search match: counterpart, shipments, goods, HS codes, ports and dates
Ceiling	20,000 rows per run, and up to 50 company pages per search term
Account needed	None
Price	$0.025 per 1,000 rows, plus $0.50 per 1,000 company pages opened on the Free plan, a little less on paid plans. The free plan's $5 a month covers about 200,000 rows in search mode, fewer once company pages are opened

🔍 What ImportYeti Scraper does

US inward vessel manifests name the importer and the shipper. ImportYeti indexes those records. This reads them back out as rows.

resultType decides what a row is, and it is the setting that changes everything else:

Mode	One row is	Rows per company
partners	one supplier or buyer relationship	usually 30 to 50
shipments	one bill of lading, with dates and BOL numbers	up to 100
profiles	one wide row per company, partners and lanes nested inside	1
search	one match from ImportYeti's index, no company page opened	varies

A company page runs the table one way and a supplier page runs it the other, so counterpartRole comes back as supplier when you start from a buyer, and buyer when you start from a factory.

Big importers file under several names. maxProfilesPerQuery is how many of those name variants actually get opened, and raising it is how you widen the partner list for one brand.

📋 What data you get from each ImportYeti record

What you get	Field
The company or supplier page the row came from	profileType, profileName, profileUrl, profileAddress, profileCountry, profileCountryCode, profileTotalShipments, databaseUpdated
What the row is, and which side the counterpart is on	rowType, counterpartRole
The counterpart: name, page, address and country	counterpartName, counterpartUrl, counterpartAddress, counterpartCountry, counterpartCountryCode, counterpartLocation
Volume on the relationship	shipments, shipmentsLast12Months, weightKg, teu
The goods and their HS codes	productDescription, hsCode, hsCodes, topProductCategory
The busiest lane	originPort, originPortCountry, destinationPort, destinationPortCountry, destinationPortRegion
First and last shipment dates, and related-party flag	firstShipmentDate, lastShipmentDate, isRelatedParty
Who else the counterpart ships to	counterpartTopBuyers
In shipments mode: the bill of lading	shipmentDate, billOfLading, masterBillOfLading, houseBillOfLading, billTypeCode, quantity, quantityUnit, containers, declaredValueUsd, estimatedShippingCostUsd, shippingRoute
In profiles mode: the company in one wide row	alsoKnownAs, website, email, phone, tradingPartnerCount, topCountries, tradeLanes, tradingPartners, recentShipments

▶️ How to scrape US import records

1. Open ImportYeti Scraper and click Try for free.
2. Type a brand, factory or product into Company or product terms, or paste ImportYeti links into ImportYeti URLs.
3. Pick What each row should be. Start on Trading partners.
4. Set Maximum rows and Profiles to open per search term. Start small, around 50 rows.
5. Click Start, then download the dataset as JSON, CSV or Excel.

Run it with nothing to look up and you get one labelled sample row, which is not charged.

💰 How much does it cost to scrape US import records?

$0.025 per 1,000 rows, plus $0.50 per 1,000 company pages opened on the Free plan. Paid plans pay a little less on both prices. On the free plan, the $5 Apify gives you each month covers about 200,000 rows in search mode, where no company page is opened, and fewer in the other modes.

Two prices because the two things are not alike. One company page can produce 45 partner rows, and pricing all of it per row would charge you more for the same work. Nothing is billed for the sample row, for diagnostic rows, for a company page that did not come back, or for one that does not exist.

📥 What you give it

{
  "searchQueries": ["solar panels"],
  "startUrls": ["https://www.importyeti.com/company/nike-usa"],
  "resultType": "partners",
  "maxItems": 200,
  "maxProfilesPerQuery": 3
}

Field	Default	What it is
searchQueries	none	A brand, an importer name, a supplier name or a product. One per line.
searchFor	any	Which kind of page the terms find: any for both, company for US importers only, supplier for the factories and shippers abroad. ImportYeti narrows the search itself. Pasted links are read as they are.
startUrls	none	ImportYeti company, supplier or search pages pasted from the site. Works alongside the terms above.
resultType	partners	What a row should be. Also shipments, profiles, and search for matches only.
maxProfilesPerQuery	3	How many company pages to open per search term, up to 50. Ignored in search mode.
maxItems	200	Total rows for the whole run, up to 20,000.
includeUnnamedPartners	false	Manifests are sometimes filed with the counterparty blank. Off means those trading-partner rows are skipped, so you are not charged for a row with no name on it. Shipment rows are always kept, because the bill of lading still has its number, date and goods.
proxyConfiguration	none	Optional, under Advanced. Only if you want the run to go out through a network of your own.

📤 What you get back

A real partners row, from a supplier page, run on 14 September 2026:

{
  "profileType": "supplier",
  "profileName": "Magnus Green Solar Panels",
  "profileUrl": "https://www.importyeti.com/supplier/magnus-green-solar-panels",
  "profileAddress": "Manufacturing Llc National Industries Park Plot Tp010505 Jebel Ali South Dubai United Arab Emirates",
  "profileCountry": "United Arab Emirates",
  "profileCountryCode": "AE",
  "profileTotalShipments": 46,
  "databaseUpdated": "2026-10-09",
  "rowType": "partner",
  "counterpartRole": "buyer",
  "counterpartName": "Unique Solar",
  "counterpartUrl": "https://www.importyeti.com/company/unique-solar",
  "counterpartAddress": "539 W Commerce St, # 7680, Dallas, Tx 75208, Us",
  "counterpartCountry": "United States of America",
  "counterpartCountryCode": "US",
  "counterpartLocation": "Dallas",
  "shipments": 41,
  "shipmentsLast12Months": 0,
  "weightKg": 1237689,
  "teu": 146,
  "productDescription": "Solar Panels, Solar Modules Xemirates, Solar Modules Solar Modules, Solar Panels Xxcontact United Arab Emirates, Solar Modules",
  "hsCode": "8541.43",
  "hsCodes": ["8541.43", "2202.10", "7317.00", "6101.10"],
  "topProductCategory": "Electric motors/Appliances",
  "originPort": "Jebel Ali",
  "originPortCountry": "United Arab Emirates",
  "destinationPort": "Savannah, Ga.",
  "destinationPortCountry": "United States of America",
  "destinationPortRegion": "Georgia",
  "lastShipmentDate": "2025-04-01",
  "firstShipmentDate": "2023-10-01",
  "isRelatedParty": false,
  "counterpartTopBuyers": [
    { "name": "Magnus Green Solar Panels Manufactu", "shipments": 42 },
    { "name": "Magnus Green Solar Panels", "shipments": 41 },
    { "name": "Asun Solar", "shipments": 12 }
  ],
  "searchQuery": "solar panels",
  "scrapedAt": "2026-09-14T05:44:19.208Z"
}

Field	How to read it
hsCode, hsCodes	The Harmonized System code that counterparty declares most, and the other codes on the relationship. 8541.43 is solar cells, 6402.99 is footwear.
originPort, destinationPort	The busiest lane on that company leaving the counterparty's country. ImportYeti publishes lanes per company, not per shipment. null when it lists no lane out of that country, rather than a guess.
weightKg, teu	Total across the relationship, not per shipment.
isRelatedParty	Whether the two sides are declared as related, which usually means a subsidiary or an in-house factory.
databaseUpdated	The date ImportYeti prints for its own data refresh.

🧾 Reading the output

Row	How to spot it	Billed
A result	It has a rowType, and no ok or charged key	yes
The sample row	_sample: true, ok: true and charged: false	no
A diagnostic	_diagnostic: true, ok: false, charged: false and an errorCode	no

Result rows carry no charged field at all. The flag is only on the sample and diagnostic rows, to mark them as not real results.

Code	What it means
BAD_URL	A pasted link that is not an ImportYeti company, supplier or search page.
BAD_INPUT	A searchFor value that is not any, company or supplier. Nothing is searched.
NO_RESULTS	ImportYeti's index matched nothing for that term.
NO_ROWS	The company has a page and shipment totals, but no itemised table on it.
NOT_FOUND	ImportYeti has no page at that address.
RATE_LIMITED	That company page did not come back on this run.
SEARCH_BLOCKED, SEARCH_BAD_BODY, SEARCH_FAILED	The search step did not come back usable.
PROFILE_FAILED	A company page failed for a reason none of the above covers.
TIME_LIMIT	The run got close to its time limit and stopped on its own. The rows delivered before that are in the dataset and charged as usual. Give the run more time, or ask for fewer rows, to get the rest.

A run ends as failed only when the time limit stopped it before any row came back.

💡 What people use it for

• Finding who actually manufactures for a brand, then pulling that factory's other customers out of counterpartTopBuyers.
• Supplier due diligence, using firstShipmentDate, lastShipmentDate and shipmentsLast12Months to see whether a relationship is live or historic.
• Lead lists of US importers in a product category, by searching the product rather than a company.
• Watching shipments mode on a schedule and diffing on billOfLading for new arrivals.

From a brand to its factory's other customers, in three runs:

1. Run this on the brand with resultType set to partners and keep the counterpartUrl of the supplier you care about.
2. Paste that link back into ImportYeti URLs here: the table runs the other way, and every row is one of that factory's buyers.
3. Look each buyer's counterpartName up on its own site before you approach it.

🚧 What it does not do

• Sea freight into the US only. No air, no rail, no trucking, no exports.
• Partners and recent bills of lading, not full history. A company with hundreds of thousands of shipments on record still shows its largest relationships and its most recent bills.
• Ports are per lane, not per shipment. null means ImportYeti lists no lane out of that country, which is more useful than a guessed port.
• Email and phone are usually withheld. ImportYeti masks them, so those fields are filled only on the pages that show them, which is not often.
• Names come as filed. Manifests are typed by hand, so Wal Mart and Nike Usa are what you get. Match on counterpartUrl, not on the name.
• partners, shipments and profiles write at the end. Every company page is read first and the rows arrive together. Near its time limit, a run stops reading in time to write what it has, plus a free TIME_LIMIT row. Keep maxItems sensible and run several times rather than once, very large.
• A very large run can come back short. A company page that does not come back on the run becomes an uncharged RATE_LIMITED row, so you pay only for what arrived.
• It is not an official ImportYeti tool. Dami's Studio is independent and is not affiliated with or endorsed by ImportYeti, or by any other company named on this page.

🧭 Which business data scraper do you need?

If you want	Use
Who imports what into the US, and from which factory	This one
US industrial suppliers by product, with phone, size and certifications	Thomasnet Suppliers Scraper
Export products, MOQ and suppliers on Alibaba.com	Alibaba.com Scraper
A 1688 seller's rating, five sub-scores and audits	1688 Supplier Ratings Scraper
Company registry filings, officers and financials in Europe	NorthData Scraper

❓ Questions people ask

How do I find a brand's suppliers?

Put the brand in Company or product terms and leave the mode on Trading partners. Every row is one supplier, with country, shipment count, HS code and its own ImportYeti page.

How do I find a factory's customers?

Paste a supplier URL into ImportYeti URLs, or type the factory's name into Company or product terms and set Search for to Foreign suppliers only. The table runs the other way and counterpartRole comes back as buyer.

Do I need an ImportYeti account?

No. This reads public pages and nothing behind a login.

Why did I only get 45 suppliers for a big importer?

That is the length of the table on that page. Raise Profiles to open per search term, because large importers file under several names and each name has its own page and its own table.

Which mode is cheapest?

search, because it never opens a company page. It gives you the matching companies and their URLs, which you can then feed back in.

Can I call it from code or connect it to an AI assistant?

Yes. The API tab has ready-made code for Python, JavaScript and the command line. For Claude, ChatGPT or another MCP client, connect https://mcp.apify.com/?tools=fetch-actor-details,dami_studio/importyeti-scraper. Either way the run happens on your Apify account at the same price.

Is scraping US import records legal?

This reads pages ImportYeti serves publicly. Apify's write-up on the legality of web scraping is a good starting point, and we are not lawyers.

🆘 If something breaks

Open the Issues tab on the actor page. Send the term or URL you used and the run ID; the errorCode on the diagnostic row usually names the problem on its own.