ImportYeti 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.
What is the ImportYeti 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.
curl -X GET 'https://api.parse.bot/scraper/32968e51-b2f5-4f00-a016-542305e29fcd/search_suppliers?page=1&query=electronics&max_pages=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace importyeti-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: ImportYeti SDK — search suppliers and autocomplete names."""
from parse_apis.importyeti_supplier_search_api import ImportYeti, QueryRequired
client = ImportYeti()
# Search for suppliers matching a keyword, capped at 5 results.
for supplier in client.suppliers.search(query="sleeping pod", max_pages=1, limit=5):
print(supplier.name, supplier.country_code, supplier.total_shipments)
# Autocomplete: get suggestions for a partial query.
suggestion = client.suggestions.list(query="samsung", limit=1).first()
if suggestion:
print(suggestion.suggestion, suggestion.type)
# Typed error handling: catch invalid-input error on autocomplete.
try:
client.suggestions.list(query="", limit=1).first()
except QueryRequired as exc:
print(f"Query required: {exc}")
print("exercised: suppliers.search / suggestions.list / QueryRequired error")
Search for suppliers and companies by keyword across ImportYeti's database of U.S. customs sea shipment records. Returns paginated results including supplier names, country codes, addresses, shipment counts, and business relationships. Each page returns up to 10 results. The total result set can span thousands of pages; use max_pages to cap fetching.
| Param | Type | Description |
|---|---|---|
| page | integer | Starting page number. |
| query | string | Search keyword for finding suppliers or companies. |
| 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": "electronics",
"results": [
{
"url": "https://www.importyeti.com/supplier/electronics",
"name": "Electronics",
"type": "supplier",
"address": "Vat 56B: 80/20832/102025 Shannon Industrial Estate V14 H020 Co Clare Ie",
"country_code": "NL",
"top_customers": null,
"top_suppliers": null,
"total_shipments": 538,
"most_recent_shipment": "09/06/2026"
}
],
"total_pages": 1000,
"results_count": 10
},
"status": "success"
}
}About the ImportYeti API
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.
The ImportYeti API is a managed, monitored endpoint for importyeti.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when importyeti.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official importyeti.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.