# ImportYeti Trade Data Scraper (x402)

> ImportYeti Trade Data Scraper (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Searches ImportYeti for structured US import/export trade data including importers, suppliers, shipment counts, trade partners, HS codes, and bills of lading, with pay-per-call USDC pricing.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/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-x402-bdf605a0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vwywrFo8lOEDj882lnwxy

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-x402-bdf605a0 -d '<json body>'
```

Example prompt: Search ImportYeti for US importers of 'bamboo furniture' — return up to 50 company profiles, include full trade details like partners, HS codes, and carriers, and only show companies with at least 10 shipments whose most recent shipment was within the last 12 months.

## When to prefer this

Use this endpoint when you need structured US trade/import data from ImportYeti — particularly for supply chain research, supplier discovery, competitive intelligence, or sourcing — and want pay-per-call pricing with no charge for failed or empty results. Prefer over manual web scraping or general search when you need structured fields like shipment counts, HS codes, trade partners, and carrier information directly from ImportYeti's database.

## Known failure modes

- Empty results when the query matches no ImportYeti profiles — not charged
- Search pages expose fewer results than maxResults due to public page limits
- Address search may return fewer supplier profiles than name-based search
- mostRecentShipment filter may exclude many results if trade data is stale
- Rate limits or payment failures on the x402 protocol layer may block the request

## How this service works

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

## Output

A JSON object containing a count of matched profiles and an array of items, each with company name, entity type (importer/supplier), address, country code, total shipments, most recent shipment date, top customers, and top suppliers. When includeDetails is true, each profile also includes HS codes, trade routes, carriers, and bills of lading.

## 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-x402-bdf605a0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)