ImportYeti Data API

Trade data docs built for developers

Look up who ships what with whom using real US and Mexico customs data. Clear guides, a full API reference, copyable examples, and a live try-it console.

Get started Browse API reference

Send a request, see what comes back

Every response carries the records plus what the call cost you. PowerQuery routes nest their rows under data.data and report the match total alongside them.

Request

curl -G "https://data.importyeti.com/v1.0/powerquery/us-import/bols" \
  -H "IYApiKey: YOUR_API_KEY" \
  -d product_description=furniture \
  -d page_size=5

const url = new URL(
  "https://data.importyeti.com/v1.0/powerquery/us-import/bols"
);
url.searchParams.set("product_description", "furniture");
url.searchParams.set("page_size", "5");

const res = await fetch(url, {
  headers: { IYApiKey: "YOUR_API_KEY" },
});

const { data } = await res.json();
console.log(data.data, data.totalCount);

import requests

r = requests.get(
    "https://data.importyeti.com/v1.0/powerquery/us-import/bols",
    params={"product_description": "furniture", "page_size": 5},
    headers={"IYApiKey": "YOUR_API_KEY"},
)

payload = r.json()["data"]
print(payload["data"], payload["totalCount"])

Response · trimmed to one record

GET /v1.0/powerquery/us-import/bols

{
  "requestCost": 0.5,
  "creditsRemaining": 9998.5,
  "data": {
    "data": [
      {
        "bol_number": "CCLLMILS17011590",
        "arrival_date": "08/21/2017",
        "company_name": "Poliform Usa Inc",
        "supplier_name": "Poliform Spa",
        "supplier_country": "Italy",
        "product_description": "Kitchen Furniture Bedroom Furniture",
        "hs_code": "940340",
        "entry_port": "Newark, Nj",
        "weight": 1327
      }
    ],
    "totalCount": 59583
  },
  "executionTime": "224ms"
}

The basics

Authenticate in one header

Send your key as IYApiKey or as a Bearer token. Same key works for REST and MCP.

Credits you can see

Every paid call returns requestCost and creditsRemaining so you always know what you spent.

PowerQuery search

Filter shipments across four datasets with booleans, wildcards, phrases, and ranges.

Popular starting points

Find a company's suppliersStart from a US company name and pull its overseas suppliers.Search shipments with PowerQueryFilter real shipment documents from US and Mexico customs data.Get a US company profileContacts, HS codes, and trading partners for a slug like ikea-supply.Connect via MCPUse ImportYeti data in Cursor, ChatGPT, Claude, and other AI assistants.