Search importers

Find US importers by name or by what they import, with 12-month container volumes, TEUs, estimated value, and top ports, origins, carriers, and commodities.

POST /trade_intel/companies/search

cURL

By name

curl --request POST \
  --url https://api.terminal49.com/v2/trade_intel/companies/search \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "home depot"
}
'

200

{
  "index": {
    "since_month": "2025-09",
    "until_month_exclusive": "2026-09",
    "months": 12,
    "min_containers": 5,
    "companies": 250000,
    "hs_codes": 1200,
    "facts_since_month": "2022-01",
    "facts_until_exclusive": "2026-11",
    "partial_month": "2026-10",
    "mode": "local",
    "facts_hash": "3f9c1a7e",
    "refreshed_since": "2026-10-01",
    "fact_rows": {
      "lane_month": 1200000,
      "company_month": 9800000,
      "commodity_month": 6400000,
      "hs_lane_month": 15000000
    },
    "volume_measure": "containers",
    "built_at": "2026-10-08T06:12:44Z"
  },
  "results": [
    {
      "company_name": "EXAMPLE OUTDOOR SUPPLY",
      "company_state": "GA",
      "containers": 1240,
      "containers_as_consignee": 1180,
      "containers_as_notify_party": 60,
      "teus": 2310.5,
      "estimated_value": 48200000,
      "reefer_share": 0,
      "first_month": "2025-09",
      "last_month": "2026-08",
      "top_ports": [
        {
          "name": "SAVANNAH",
          "containers": 900
        }
      ],
      "top_origins": [
        {
          "name": "VIETNAM",
          "containers": 700
        }
      ],
      "top_carriers": [
        {
          "name": "MAERSK LINE",
          "containers": 500
        }
      ],
      "top_commodities": [
        {
          "hs4": "9401",
          "description": "Seats (other than barber, dental, etc), and part",
          "estimated_value": 31000000,
          "containers": 800
        }
      ],
      "score": 0.97
    }
  ]
}

Authorizations

Authorization · string · header · required

Use a Terminal49 API key in the Authorization header with the Token prefix.

Authorization: Token YOUR_API_KEY

Body

application/json

Give name, imports, or both. With neither, lists the largest importers matching the filters.

name · string | null

Company name; partial or misspelled is fine (fuzzy match). Results are ranked by match quality, not size, so a close but small match can outrank a large importer.

Maximum string length: 200

Example:

"home depot"

imports · string | null

What the company imports, in plain words (semantic match).

Maximum string length: 200

Example:

"frozen shrimp"

state · string | null

US state code of the importer.

Maximum string length: 2

Example:

"FL"

port_of_discharge · string | null

Substring of a US port name.

Maximum string length: 200

Example:

"Long Beach"

origin_country · string | null

Substring of an origin country.

Maximum string length: 200

Example:

"Vietnam"

min_containers · integer | null

Minimum containers in the index window.

Required range: x >= 1

limit · integer · default: 10

Maximum results to return.

Required range: 1 <= x <= 50

Response

200

application/json

OK

index · object · required

Index window, freshness, and counts. Also returned as index by companies/search.

Show child attributes

results · object[] · required

Matches ordered by score.

Show child attributes