ImportYeti Country Directory - Suppliers & Importers

Scrape ImportYeti's country/location directory pages to discover top suppliers and US importers by geography. Returns ranked entity lists, recent shipment records, and aggregate trade stats — from national level (e.g. China, Vietnam) down to individual states, cities, and counties.

---

Features

• Retrieves the Top Suppliers / Companies table (up to 10 ranked entities per location) with badge metadata ("Top", "New", "Fast Growing"), total shipment counts, and HS category tags.
• Pulls up to 50 recent shipment rows per location — same structure as the ImportYeti BOL scraper: arrival date, house + master BOL numbers, supplier name/slug/URL, city, country, weight, quantity, containers, and product description.
• Emits an optional location summary record per page with aggregate stats: total shipment count, total TEU, total weight, and database updated date.
• Accepts bare country slugs (china, vietnam, united-states-of-america) or full ImportYeti location URLs. Covers both the supplier directory (foreign shippers to the US) and the company directory (US importers).
• Supports sub-geography drilling into states, cities, and counties via subGeographies (provide full ImportYeti URL with the numeric ID).
• Pay-per-event billing at $0.10 per run start plus $0.001 per record.
• Handles ImportYeti's Cloudflare edge via residential US proxy — no CAPTCHAs to babysit, no browsers to feed.

---

What Can You Do With This Data?

• Supplier discovery by geography — "Who are the top 10 suppliers in China for plastics?" Answer in one run.
• Country sourcing analysis — Compare recent shipment volume, weight, and TEU across multiple origin countries.
• Procurement research — Surface the most active shippers from a specific city or state for targeted sourcing outreach.
• Trade flow intelligence — Track which US companies are most actively importing from a given country or region.
• Tariff exposure mapping — Identify origin countries for HS code categories, then overlay Section 301 / Section 201 tariff rates.
• OSINT supply chain work — Build geographic supply chain maps from public US customs records (cited by Bellingcat).

---

How It Works

1. Supply country slugs in countries (e.g. ["china", "vietnam"]) and select locationType (supplier or company).
2. The scraper constructs ImportYeti location URLs (/location/supplier/china/country) and fetches each page through a residential US proxy.
3. Each page is parsed for: the ranked entity table, the 50-row shipment table, and the aggregate stats block.
4. Records stream into the Apify dataset as they're extracted. Use maxItems to cap total records across all locations.

To drill into a sub-geography (e.g. Hangzhou city or California state), pass the full ImportYeti URL in subGeographies:

https://www.importyeti.com/location/supplier/china/city/1808925-hangzhou-shi
https://www.importyeti.com/location/company/united-states-of-america/state/5-california

---

Input

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

Field	Type	Default	Description
countries	array of strings	["china"]	Country slugs or full ImportYeti location URLs. Slugs like china, vietnam, united-states-of-america, or full URLs all work.
locationType	string	supplier	supplier — foreign shippers to the US; company — US importers.
subGeographies	array of strings	[]	Optional full ImportYeti sub-geography URLs (states, cities, counties).
includeEntities	boolean	true	Extract the ranked Top Suppliers/Companies table (up to 10 rows per location).
includeSummary	boolean	true	Emit one location_summary record per location with aggregate stats.
maxItems	integer	50	Max total records across all locations. 0 for no cap.
proxyConfiguration	object	RESIDENTIAL US	Apify proxy config. Residential US is required — ImportYeti's CF edge blocks datacenter IPs.

---

Output

Three record types are emitted, all sharing a common set of location fields:

Field	Description
record_type	"entity", "shipment", or "location_summary"
location_type	"supplier" or "company"
country	Country display name (e.g. China)
country_slug	URL slug (e.g. china)
sub_geography	State/city ID if sub-geography, empty at country level
sub_geography_type	"state", "city", "county", etc. — empty at country level
source_url	The ImportYeti URL scraped
scraped_at	ISO 8601 timestamp

Entity records (record_type: "entity") add:

Field	Description
entity_name	Supplier or company name
entity_slug	ImportYeti slug
entity_url	ImportYeti profile URL
entity_total_shipments	Total shipment count for this entity
entity_top_hs_categories	HS product categories (e.g. Plastics Furnitures Toys)
entity_badge	"Top", "New", "Fast Growing", or empty

Shipment records (record_type: "shipment") add:

Field	Description
arrival_date	Arrival date (MM/DD/YYYY)
bill_of_lading	House BOL number
master_bill_of_lading	Master BOL number
supplier_name	Supplier name
supplier_slug	Supplier ImportYeti slug
supplier_url	Supplier profile URL
supplier_city	Supplier city
supplier_country	Supplier country
weight_kg	Weight in kilograms
quantity	Package count
quantity_unit	Unit (e.g. pkg)
container_count	Container count
product_description	Free-text product description

Summary records (record_type: "location_summary") add:

Field	Description
total_shipments	Total sea shipments for this location
total_weight	Total weight
total_teu	Total TEU
database_updated	Database update date

---

Part of the ImportYeti Intelligence Suite

This actor is designed to work alongside:

• ImportYeti Scraper — Enrich known companies and suppliers with full BOL history, HS codes, and supply-chain rollups.

Together they cover every free-tier entry point on ImportYeti: discover by geography (this actor) and enrich by company/supplier (BOL actor).