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

1. 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.
2. The scraper normalizes each input to a canonical ImportYeti URL and fetches the location page through a US residential proxy.
3. 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