# ImportYeti search: `POST /v1/importyeti/search`

Cost: 2 credits (2 per page (an empty page and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/importyeti-search

One page (10) of companies and suppliers found in US customs
bills of lading.

Each result carries the name, whether it is a company (US importer) or a
supplier (foreign shipper), country, address, total shipments, most
recent shipment date and the profile link to pass to
/v1/importyeti/profile. Search by name or by address; filter to companies
or suppliers. An empty page is not charged.

Request body (JSON):

- `q` (string; required; min length 1, max length 200): Company or supplier name, or part of an address when search_by is address. Only the first 50 characters are matched.
- `search_by` (string; optional; default name; one of name, address): Match q against names (default) or against registered addresses.
- `type` (string | null; optional; one of company, supplier): Keep only companies (US importers, consignees) or only suppliers (foreign shippers). Both when omitted.
- `page` (integer; optional; default 1; min 1, max 14): Results page, 10 per page (1-14).

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
