# ImportYeti Trade Data Scraper

> ImportYeti Trade Data Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Searches ImportYeti for US import/export shipment records, returning company profiles with trade partners, HS codes, routes, carriers, and bills of lading.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/importyeti?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/importyeti-trade-data-scraper-d562a0c8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2gawt06GHyfVaRE8j1Ef5

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability importyeti-trade-data-scraper-d562a0c8 -d '<json body>'
```

Example prompt: Search ImportYeti for US importers of 'outdoor furniture' that have had at least 50 shipments, return up to 20 results including their trade partners and HS codes, and only include companies with a shipment in the last 12 months.

## When to prefer this

Choose this endpoint when you need structured US trade/import data — shipment counts, trade partners, HS codes, carriers, or bills of lading — scraped from ImportYeti's public records. It is pay-per-call with no charge for failed or empty runs, making it cost-effective for exploratory supply chain research. Prefer it over general web scrapers when you specifically need ImportYeti's curated shipment database rather than raw web content.

## Known failure modes

- Query returns zero results if the company or product is too obscure or misspelled
- Public search pages may expose fewer results than the requested maxResults limit
- minShipments or mostRecentShipment filters may exclude most results for niche queries
- includeDetails=true increases latency significantly for large result sets
- Address searches may return fewer supplier-type results than importer results
- Service returns empty payload (not charged) if no matching profiles are found

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

A JSON array of company/supplier profiles, each containing the entity name, type (importer or supplier), address, country code, top customers, top suppliers, total shipment count, and most recent shipment date. When includeDetails is enabled, also returns trade partners, HS codes, shipping routes, carriers, and bills of lading. The response includes a total count and a product tag ('importyeti').

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "type": {
   "enum": [
    "any",
    "company",
    "supplier"
   ],
   "type": "string",
   "default": "any",
   "description": "Return importers, suppliers, or both. Address search can have fewer supplier results."
  },
  "query": {
   "type": "string",
   "description": "Company, supplier, product, or address phrase to search."
  },
  "maxResults": {
   "type": "integer",
   "default": 100,
   "maximum": 1000,
   "minimum": 1,
   "description": "Maximum distinct profiles to return. Public search pages can expose fewer than this limit."
  },
  "searchType": {
   "enum": [
    "search",
    "addresses"
   ],
   "type": "string",
   "default": "search",
   "description": "Search entity names and products, or addresses and locations."
  },
  "minShipments": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Keep profiles with at least this many total shipments. Applied to every result."
  },
  "includeDetails": {
   "type": "boolean",
   "default": true,
   "description": "Open each public profile for trade partners, HS codes, routes, carriers, and bills of lading. Disable for a faster search summary."
  },
  "mostRecentShipment": {
   "enum": [
    "any",
    "6mo",
    "12mo"
   ],
   "type": "string",
   "default": "any",
   "description": "Keep profiles whose latest shipment falls within the selected period."
  },
  "includeRelatedNames": {
   "type": "boolean",
   "default": false,
   "description": "Also match alternative business names and trademarks where search makes them available."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "name": null,
    "type": null,
    "address": null,
    "countryCode": null,
    "topCustomers": null,
    "topSuppliers": null,
    "totalShipments": null,
    "mostRecentShipment": null
   }
  ],
  "product": "importyeti"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/importyeti-trade-data-scraper-d562a0c8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)