ImportYeti Country Directory Scraper

Scrape ImportYeti's country directory to discover top suppliers and US importers by geography. Returns ranked entity tables, recent shipment records, and aggregate trade stats — from the national level (China, Vietnam, United States) down to individual states, cities, and counties.

ImportYeti Directory Scraper Features

Targets countries by slug — china, vietnam, united-states-of-america — or by full ImportYeti URL
Picks supplier directory (foreign shippers) or company directory (US importers), depending on which side of the trade you care about
Returns the ranked Top Suppliers/Companies table with badges (Top, New, Fast Growing) and primary HS categories
Extracts up to 50 recent shipment records per location with bill-of-lading numbers, weights, container counts, and product descriptions
Emits a per-location summary record with aggregate stats — total shipments, total weight, TEU
Drills into sub-geographies (states, cities, counties) when you supply full ImportYeti URLs
Routes through US residential proxies. ImportYeti is behind Cloudflare and datacenter IPs don't pass cleanly.

Who Uses ImportYeti Data?

Sourcing teams — find ranked foreign suppliers by country before reaching out to a single agent
B2B sales — prospect US importers in a target geography with shipment-volume signals attached
Trade analysts — pull aggregate country-level stats to model bilateral trade flows
Competitive intelligence — watch which suppliers a competitor's importers are sourcing from
Compliance teams — build watch lists tied to specific geographies and HS categories

How ImportYeti Directory Scraper Works

Provide country slugs (china, vietnam) and pick a directory type — supplier (foreign shippers to the US) or company (US importers). Optionally supply full sub-geography URLs to drill into specific states or cities.
The scraper normalizes each input to a canonical ImportYeti URL and fetches the location page through a US residential proxy.
For each location, the scraper extracts three record types: the Top Entities table (up to 10 rows), recent shipment rows (up to 50), and an aggregate summary. Toggle includeEntities and includeSummary to keep just what you need.

Input

Country-level supplier directory

{
  "countries": ["china", "vietnam", "thailand"],
  "locationType": "supplier",
  "includeEntities": true,
  "includeSummary": true,
  "maxItems": 200
}

US importer directory

{
  "countries": ["united-states-of-america"],
  "locationType": "company",
  "maxItems": 100
}

Drill into sub-geographies

{
  "countries": ["china"],
  "subGeographies": [
    "https://www.importyeti.com/location/supplier/china/city/1808925-hangzhou-shi",
    "https://www.importyeti.com/location/supplier/china/city/1809858-shenzhen"
  ],
  "locationType": "supplier",
  "maxItems": 100
}

Field	Type	Default	Description
`countries`	string[]	`["china"]`	Country slugs or full ImportYeti location URLs.
`locationType`	string	`supplier`	`supplier` (foreign shippers to the US) or `company` (US importers).
`subGeographies`	string[]	—	Optional full URLs for states, cities, or counties to drill into.
`includeEntities`	boolean	`true`	Include the ranked Top Suppliers/Companies table (up to 10 rows per location).
`includeSummary`	boolean	`true`	Emit one summary record per location with aggregate stats.
`maxItems`	integer	`50`	Maximum total records across all locations and record types. `0` for no cap.

ImportYeti Directory Scraper Output Fields

The scraper emits three record types distinguished by the record_type field. Most fields are populated only for the record type they belong to.

Entity record (`record_type: "entity"`)

{
  "record_type": "entity",
  "location_type": "supplier",
  "country": "China",
  "country_slug": "china",
  "entity_name": "Shenzhen Acme Trading Co Ltd",
  "entity_slug": "shenzhen-acme-trading-co-ltd",
  "entity_url": "https://www.importyeti.com/company/shenzhen-acme-trading-co-ltd",
  "entity_total_shipments": 4821,
  "entity_top_hs_categories": "Plastics Furnitures Toys",
  "entity_badge": "Top",
  "source_url": "https://www.importyeti.com/location/supplier/china/country",
  "scraped_at": "2026-05-26T19:00:00.000Z"
}

Shipment record (`record_type: "shipment"`)

{
  "record_type": "shipment",
  "location_type": "supplier",
  "country": "China",
  "country_slug": "china",
  "arrival_date": "04/12/2026",
  "bill_of_lading": "ABCD1234567890",
  "master_bill_of_lading": "MAEU9988776655",
  "supplier_name": "Ningbo Lighting Industries",
  "supplier_slug": "ningbo-lighting-industries",
  "supplier_url": "https://www.importyeti.com/company/ningbo-lighting-industries",
  "supplier_city": "Ningbo",
  "supplier_country": "China",
  "weight_kg": 18420.5,
  "quantity": 1240,
  "quantity_unit": "pkg",
  "container_count": 2,
  "product_description": "LED bulb 60W E27 — pallet x 124",
  "source_url": "https://www.importyeti.com/location/supplier/china/country",
  "scraped_at": "2026-05-26T19:00:00.000Z"
}

Summary record (`record_type: "location_summary"`)

{
  "record_type": "location_summary",
  "location_type": "supplier",
  "country": "China",
  "country_slug": "china",
  "total_shipments": 18420321,
  "total_weight": 95412300000,
  "total_teu": 2840192,
  "database_updated": "2026-05-20",
  "source_url": "https://www.importyeti.com/location/supplier/china/country",
  "scraped_at": "2026-05-26T19:00:00.000Z"
}

Field	Type	Description
`record_type`	string	`entity`, `shipment`, or `location_summary`
`location_type`	string	`supplier` or `company` directory
`country`, `country_slug`	string	Country name and slug
`sub_geography`, `sub_geography_type`	string	Sub-geography identifier and type (state, city, county) when drilling down
`entity_name`, `entity_slug`, `entity_url`	string	Entity identity (entity records)
`entity_total_shipments`	number	Total shipments for the entity
`entity_top_hs_categories`	string	Top HS product categories (e.g. "Plastics Furnitures Toys")
`entity_badge`	string	`Top`, `New`, `Fast Growing`, or empty
`arrival_date`, `bill_of_lading`, `master_bill_of_lading`	string	Shipment metadata (shipment records)
`supplier_name`, `supplier_slug`, `supplier_url`	string	Supplier identity on a shipment row
`supplier_city`, `supplier_country`	string	Supplier origin
`weight_kg`, `quantity`, `quantity_unit`, `container_count`	number, string	Shipment volume metrics
`product_description`	string	Free-text product description from the BOL
`total_shipments`, `total_weight`, `total_teu`	number	Location-level aggregate stats (summary records)
`database_updated`	string	ImportYeti database update date (summary records)
`source_url`	string	URL the record was scraped from
`scraped_at`	string	ISO 8601 scrape timestamp

FAQ

How do I scrape ImportYeti?

ImportYeti Directory Scraper accepts country slugs or full ImportYeti URLs and fetches the location pages directly. It returns the ranked supplier/importer table, recent shipments, and aggregate stats per location — set locationType to switch between the supplier and company directories.

Does ImportYeti Directory Scraper need proxies?

ImportYeti Directory Scraper requires US residential proxies. ImportYeti sits behind Cloudflare and routes that originate from datacenter IPs don't pass the TLS-fingerprint check cleanly. The actor uses residential egress by default.

What's the difference between supplier and company directories?

ImportYeti Directory Scraper's supplier mode returns foreign shippers exporting to the US — useful for sourcing. company mode returns US importers buying from abroad — useful for B2B prospecting. Both share the same record schema.

Can I drill into a specific city or state?

ImportYeti Directory Scraper accepts full ImportYeti URLs in the subGeographies field — /location/supplier/china/city/1808925-hangzhou-shi, /location/supplier/vietnam/state/1562822-ho-chi-minh-city, and the equivalent for company-side URLs. Records carry sub_geography and sub_geography_type fields so you can join them back to the location later.

How much does ImportYeti Directory Scraper cost to run?

ImportYeti Directory Scraper uses pay-per-event pricing at the default 1.0 coefficient. Each saved record bills as one event, so cost scales linearly with the number of entities, shipments, and summaries you collect. Residential proxy usage is included in the actor cost.

Need More Features?

Need full historical shipment records, deeper supplier profiles, or HS-code-anchored search? File an issue or get in touch.

Why Use ImportYeti Directory Scraper?

Three record types in one run — ranked entities, recent shipments, and location summaries from the same input, distinguishable by record_type
Geographic drill-down — country, state, city, and county pages share the same schema, so the same dataset query works at any zoom level
Cloudflare-clean — runs through US residential proxies with a fingerprint that ImportYeti accepts, so the run actually finishes

ImportYeti Country Directory - Suppliers & Importers