# ThomasNet search: `POST /v1/thomasnet/search`

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

Suppliers on ThomasNet, in ThomasNet's own relevance order.

One page (32) by default: name, type with its label, tier, phone,
website, full address with coordinates, annual-sales range, employee
range, year founded, the matched heading and brands. Sponsored
placements are marked (`sponsored`, `sponsoredPosition`) and keep
their slots. ThomasNet walls page 2 and later behind registration
(a 503 here, never page 1 repeated); set max_results to collect
instead (at most 160 per call): the first page of each coverage
area, deduped, with exclude_ids skipping suppliers you already
hold. The call stops inside the edge timeout and returns
`truncated: true` with the suppliers it has; a larger run is the
same operation on `POST /v1/async/jobs`. An empty page is not
charged.

Request body (JSON):

- `query` (string; required; min length 1, max length 200): Product, service or company-name search term.
- `mode` (string; optional; default all; one of all, name): 'all' = products/services; 'name' = company names.
- `area` (string; optional; default NA): Coverage-area code: NA = all of North America, or a region code (NT, GT, CN, CS, DN, UN, NO, SO, EP, WP, IL, MI, ON, QC).
- `page` (integer; optional; default 1; min 1, max 500): Results page, 32 per page (with max_results, ignored). ThomasNet walls page 2 and later behind registration, so a page beyond 1 answers 503.
- `max_results` (integer | null; optional; min 1, max 160): Collect this many suppliers. Past the first 32 a collection renders each coverage area's first page (one render per 32 asked), deduped. It stops at the time budget and sets truncated when it could not finish.
- `exclude_ids` (array of string; optional; max items 1000): tgramsId values to skip (max_results only).

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)
