# ImportYeti HS code: `POST /v1/importyeti/hs-code`

Cost: 3 credits (3 (an unknown code and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/importyeti-hs-code

US import shipments recorded under one HS code (2, 4 or 6 digits).

Returns the code's description, total shipments, weight and TEU, the
date range covered, the top origin countries, the top importers and
suppliers with their shipment counts, the US tariff lines under the code
and the most recent shipments. An unknown code is a 404 and is not
charged.

Request body (JSON):

- `code` (string; required; min length 2, max length 12): HS code: 2 digits (chapter), 4 (heading) or 6 (subheading). Dots and spaces are allowed, e.g. 8473.30.

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)
