Nimbryxo Studio

ImportYeti US Importer & Global Supplier Search

Search ImportYeti by company name or product keyword to find US importers or their overseas suppliers, with country, address, lifetime shipment count, most recent shipment date, trademarks, and profile link.

Input schema

Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.

FieldTypeRequiredDescription
modestringrequiredWhat to search for.
querystringrequiredCompany name or product keyword to search for.
maxItemsintegeroptionalMaximum number of results to return.
Show all input fields
FieldTypeRequiredDescription
modestringrequiredWhat to search for.
querystringrequiredCompany name or product keyword to search for.
maxItemsintegeroptionalMaximum number of results to return.
proxyConfigurationobjectoptionalProxy settings. ImportYeti enforces a 25-request-per-IP limit, so proxy is required on Apify cloud to avoid rate-limiting.

Download the published input schema

View complete JSON
{
  "description": "Search US importers and global suppliers using ImportYeti.com's public trade database.",
  "properties": {
    "maxItems": {
      "default": 20,
      "description": "Maximum number of results to return.",
      "maximum": 500,
      "minimum": 1,
      "prefill": 20,
      "title": "Max Items",
      "type": "integer"
    },
    "mode": {
      "default": "searchImporters",
      "description": "What to search for.",
      "editor": "select",
      "enum": [
        "searchImporters",
        "searchSuppliers"
      ],
      "enumTitles": [
        "Search US Importers (by company name or product)",
        "Search Global Suppliers (by company name)"
      ],
      "prefill": "searchImporters",
      "title": "Mode",
      "type": "string"
    },
    "proxyConfiguration": {
      "description": "Proxy settings. ImportYeti enforces a 25-request-per-IP limit, so proxy is required on Apify cloud to avoid rate-limiting.",
      "editor": "proxy",
      "prefill": {
        "useApifyProxy": true
      },
      "title": "Proxy Configuration",
      "type": "object"
    },
    "query": {
      "default": "electronics",
      "description": "Company name or product keyword to search for.",
      "editor": "textfield",
      "prefill": "electronics",
      "title": "Search Query",
      "type": "string"
    }
  },
  "required": [
    "mode",
    "query"
  ],
  "schemaVersion": 1,
  "title": "ImportYeti US Trade & Supplier Data Scraper Input",
  "type": "object"
}

Output schema

Published result links and storage locations. This schema is not an exhaustive contract for every field in a dataset record.

FieldTypeRequiredDescription
resultsstringoptionalDataset containing all scraped ImportYeti importer and supplier records.

Download the published output schema

View complete JSON
{
  "actorOutputSchemaVersion": 1,
  "description": "One record per matched US importer or overseas supplier, with country, address, shipment counts, recency, and trademarks.",
  "properties": {
    "results": {
      "description": "Dataset containing all scraped ImportYeti importer and supplier records.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "ImportYeti Companies",
      "type": "string"
    }
  },
  "title": "ImportYeti US Importer & Global Supplier Search Output"
}

Dataset schema

Published dataset views and any declared field definitions. A view can select only a subset of the returned record fields.

Download the published dataset schema

View complete JSON
{
  "actorSpecification": 1,
  "fields": {},
  "views": {
    "overview": {
      "display": {
        "columns": [
          {
            "field": "companyName",
            "label": "Company"
          },
          {
            "field": "type",
            "label": "Type"
          },
          {
            "field": "country",
            "label": "Country"
          },
          {
            "field": "totalShipments",
            "label": "Total Shipments"
          },
          {
            "field": "mostRecentShipment",
            "label": "Most Recent Shipment"
          }
        ],
        "component": "table"
      },
      "title": "Results",
      "transformation": {
        "fields": [
          "companyName",
          "type",
          "country",
          "address",
          "totalShipments",
          "mostRecentShipment",
          "companyUrl",
          "trademarks"
        ]
      }
    }
  }
}

Key-value schema

Published key-value store definitions, when provided by this build.

This definition is not present in the default published build. See the published README for available documentation.

Published README

Read the full published documentation

Search ImportYeti — a public index built on US customs bill-of-lading records — for US importers by company name or product keyword, or for overseas suppliers by company name. Each match comes back with country, address, lifetime shipment count, most recent shipment date, alternate name and address counts, registered trademarks, and a link to its ImportYeti profile. No account required.

What this actor does

  • Searches in two modes: searchImporters for US buyers, searchSuppliers for overseas sellers
  • Matches the same query field against both company names and product keywords
  • Walks through result pages automatically until maxItems is reached or matches run out
  • Keeps collecting across ImportYeti's per-IP usage cap when a proxy is configured, picking back up instead of stopping short
  • Omits any field ImportYeti has no data for — no nulls or placeholders in the output

Output per company

  • companyName — company as listed on ImportYeti
  • type — record type reported upstream (importer / supplier)
  • country — ISO country code
  • address — primary registered address
  • totalShipments — lifetime shipment records attributed to the company
  • mostRecentShipment — date of the latest shipment on file
  • otherAddressesCount — additional known addresses for the same company
  • otherNamesCount — additional known trading names
  • trademarks — registered trademarks linked to the company (capped at 20)
  • companyUrl — ImportYeti profile page
  • scrapedAt

Input

Field Type Default Description
mode string searchImporters searchImporters / searchSuppliers
query string electronics Company name or product keyword
maxItems int 20 Hard cap (1–500)
proxyConfiguration object {"useApifyProxy": true} Proxy settings — strongly recommended, see FAQ

Example: US importers of a product

{
  "mode": "searchImporters",
  "query": "electronics",
  "maxItems": 50,
  "proxyConfiguration": { "useApifyProxy": true }
}

Example: a specific buyer's import footprint

{
  "mode": "searchImporters",
  "query": "Home Depot",
  "maxItems": 25,
  "proxyConfiguration": { "useApifyProxy": true }
}

Example: global suppliers by name

{
  "mode": "searchSuppliers",
  "query": "Foshan furniture",
  "maxItems": 100,
  "proxyConfiguration": { "useApifyProxy": true }
}

Example: wide sweep for lead generation

{
  "mode": "searchImporters",
  "query": "lithium battery",
  "maxItems": 500,
  "proxyConfiguration": { "useApifyProxy": true }
}

Use cases

  • Sourcing teams — find overseas suppliers that already ship the product category you buy
  • B2B lead generation — build lists of US importers active in a given product niche
  • Competitive intelligence — see how many shipments a competitor receives and how recently
  • Supply-chain risk — map which countries a company's inbound freight originates from
  • Trade finance & credit — use shipment volume and recency as an activity signal on a counterparty
  • Brand protection — spot importers bringing in goods under trademarks linked to your brand

FAQ

Where does this data come from? US Customs bill-of-lading filings, which are public records for ocean freight entering the United States. ImportYeti indexes and publishes them.

Is this affiliated with ImportYeti? No. This is a third-party actor that reads ImportYeti's public search results; it is not endorsed by or affiliated with ImportYeti.

Do I need an ImportYeti account? No. The search results this actor returns are the ones ImportYeti serves publicly.

Why should I enable proxy? ImportYeti limits anonymous searching to roughly 25 requests per IP address before asking for a login. On Apify cloud many actors share exit IPs, so without a proxy a run can be cut short. With {"useApifyProxy": true} the actor rotates through IPs and picks up where it left off. The free Apify Proxy AUTO group is sufficient — no residential proxy needed.

What happens if the limit is hit anyway? The run ends with a status message explaining the cap rather than failing, and any records already collected stay in the dataset.

Does this cover air freight or exports? No. Bill-of-lading data is ocean freight into the US, so air cargo and US exports are out of scope.

Why do some companies show a huge otherNamesCount? Large importers file under many trading names and subsidiaries. The count tells you how many aliases ImportYeti has consolidated under that profile.

How current are the shipment dates? Customs data is published with a lag of a few weeks, so mostRecentShipment typically trails today's date even for very active importers.

Why are trademarks capped at 20? Big brand owners hold hundreds. The first 20 keep records readable; the full list is on the linked companyUrl profile.

Python quickstart

Use a schema-derived input and the Python standard library to start a run. An Apify account and token are required for execution.

Open the step-by-step Python guide →

Source build zGCDYPDjBF7che80a. Documentation is regenerated from the default published build; private drafts are not included.