importyeti.com APIimportyeti.com ↗
Search 70M+ U.S. customs sea shipment records via the ImportYeti API. Find suppliers by keyword, get shipment counts, addresses, and company metadata.
curl -X GET 'https://api.parse.bot/scraper/32968e51-b2f5-4f00-a016-542305e29fcd/search_suppliers?query=electronics&max_pages=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for suppliers and companies by keyword. Paginates through result pages based on max_pages parameter. Returns supplier names, country codes, addresses, shipment counts, and related metadata.
| Param | Type | Description |
|---|---|---|
| page | integer | Starting page number |
| query | string | Search keyword |
| max_pages | integer | Maximum number of pages to fetch. 0 fetches all available pages. |
{
"type": "object",
"fields": {
"query": "search keyword used",
"results": "array of supplier objects with name, country_code, type, address, total_shipments, most_recent_shipment, top_suppliers, top_customers, and url",
"total_pages": "total number of result pages available",
"results_count": "number of supplier results returned"
},
"sample": {
"data": {
"query": "sleeping pod",
"results": [
{
"url": "https://www.importyeti.com/company/american-sleeping-pod",
"name": "American Sleeping Pod",
"type": "company",
"address": "984 Spruce St, Berkeley, Ca 94707, Us",
"country_code": "US",
"top_customers": null,
"top_suppliers": null,
"total_shipments": 1,
"most_recent_shipment": "01/04/2023"
}
],
"total_pages": 6,
"results_count": 10
},
"status": "success"
}
}About the importyeti.com API
The ImportYeti API exposes two endpoints — search_suppliers and autocomplete — giving programmatic access to over 70 million U.S. customs sea shipment records. A single query returns an array of supplier objects including name, country code, address, total shipment volume, most recent shipment date, and top supplier relationships. It covers both broad industry searches and precise company lookups.
What the API Returns
The search_suppliers endpoint accepts a query string and returns a paginated list of supplier and company records sourced from U.S. customs sea shipment data. Each result object includes name, country_code, type, address, total_shipments, most_recent_shipment, top_suppliers, and top_custom fields. The response also surfaces total_pages and results_count so you can plan pagination ahead of time.
Pagination Control
The max_pages parameter on search_suppliers lets you cap how many pages are fetched in a single call. Setting it to 0 fetches all available pages, which is useful for exhaustive supplier discovery but will consume more credits. The optional page parameter sets the starting page, making it straightforward to implement offset-based iteration in a pipeline.
Autocomplete Endpoint
The autocomplete endpoint takes a required query string and returns a suggestions array where each item has a suggestion (the matched name) and a type field such as 'company'. This is suited for building search-ahead interfaces or resolving ambiguous company name strings before passing them to search_suppliers for full record retrieval.
Data Scope and Freshness
Coverage is limited to U.S. customs sea freight import records. The most_recent_shipment field in each supplier result gives a signal of how recently a company appeared in the customs data, but the API does not expose individual shipment-level records — only aggregated per-company metadata.
- Identify overseas suppliers for a product category by querying keywords and sorting by
total_shipments - Validate whether a prospective vendor has an active U.S. import presence using
most_recent_shipment - Build a supplier discovery tool with a live search-ahead powered by the
autocompleteendpoint - Map
top_suppliersrelationships to understand second-tier supply chain dependencies - Enrich a CRM or procurement database with address and country-of-origin data from
search_suppliersresults - Monitor competitor sourcing activity by tracking shipment counts for known company names over time
- Filter and shortlist import partners by
country_codefor region-specific sourcing strategies
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ImportYeti have an official developer API?+
What does the `search_suppliers` endpoint return beyond a company name?+
country_code, type, address, total_shipments, most_recent_shipment, top_suppliers, and top_custom. These fields together give a snapshot of a company's import activity and its key supplier relationships.Does the API return individual shipment records, such as bill-of-lading details or cargo descriptions?+
Is coverage limited to sea freight, or does it include air and land imports?+
How does pagination work when fetching large result sets?+
search_suppliers endpoint accepts a page parameter to set the starting page and a max_pages parameter to cap the number of pages returned. The response includes total_pages so you can calculate how many calls a full crawl requires. Setting max_pages to 0 retrieves all pages in one call.