# Thomasnet Search
## Overview
| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/thomasnet/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 3 credits per call |
| **Documentation** | https://www.piloterr.com/library/thomasnet-search |
## Description
Search Thomasnet suppliers from a search or category URL and get company listings, filters, name suggestions, and pagination.
## Authentication
- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register
## Example Request
```bash
curl --location --request GET 'https://api.piloterr.com/v2/thomasnet/search' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_API_KEY'
```
## Example Response
### Search suppliers for keyword dz
```json
{
"filters": [
{
"id": "Any Glass",
"count": 1,
"label": "Any Glass",
"section": "Materials"
},
{
"id": "Any Plastic",
"count": 1,
"label": "Any Plastic",
"section": "Materials"
},
{
"id": "Any Rubber (Elastomer)",
"count": 1,
"label": "Any Rubber (Elastomer)",
"section": "Materials"
},
{
"id": "Any Stainless Steel",
"count": 1,
"label": "Any Stainless Steel",
"section": "Materials"
},
{
"id": "C",
"count": 1,
"label": "Custom Manufacturer",
"section": "Company Type"
}
],
"results": [
{
"url": "https://www.thomasnet.com/company/terriss-consolidated-industries-inc-574321/profile",
"name": "Terriss Consolidated Industries, Inc.",
"rank": "53.83929",
"tier": "NONE",
"type": "M",
"videos": null,
"address": {
"zip": "07712",
"city": "Asbury Park",
"zip4": null,
"state": "NJ",
"county": null,
"country": "USA",
"address1": "807 Summerfield Ave.",
"address2": null,
"address3": null,
"latitude": 40.24707252,
"longitude": -74.0496745,
"state_name": "New Jersey"
},
"heading": null,
"website": "https://www.terriss.com/",
"distance": null,
"headings": [
{
"heading_id": "88501200",
"natural_name": "Tubes"
}
],
"logo_url": null,
"pdm_text": "Manufacturer & stocking distributor of Pyrex® glass, screw top & round bottom culture tubes. Available in 13 mm x 100 mm to 25 mm x 200 mm size with 10 ml dz to 75 ml dz capacity, black phenolic plastic cap & PTFE liner.",
"products": null,
"tgrams_id": "574321",
"is_claimed": false,
"logo_title": "Terriss Consolidated Industries, Inc. Company Logo",
"description": "Manufacturer & stocking distributor of biodegradable products, scientific instruments & laboratory supplies & stainless steel products. Products include lubricants, label dispensers, magnetic stirrers, microscopes, stoppers, brushes, test kits, thermometers, torque testers, voltage regulators, culture tubes, vacuum testers, turbidity meters, viscometers & hydrometers. Agitators, containers, dippers, enclosures, funnels, gaskets, mixers, fittings, pumps, scoops, scrapers, tubes, valves, tanks & waste receptacles are also available. Applications include food, beverage, chemical, pharmaceutical, water & wastewater industries.",
"annual_sales": "$1 - 4.9 Mil",
"capabilities": [
{
"type": "MATERIAL",
"names": [
"Any Glass",
"Any Plastic",
"Any Rubber (Elastomer)",
"Any Stainless Steel",
"Garbage and Trash",
"Plastic",
"Rod",
"Stainless Steel",
"Test Tubes"
]
}
],
"catalog_type": null,
"year_founded": "1895",
"is_advertiser": false,
"primary_phone": "(732) 988-0909",
"heading_brands": [
{
"name": "Schott"
}
],
"is_top_responder": null,
"number_employees": "10-49",
"other_activities": [
"C",
"D",
"S"
],
"xometry_verified": false,
"is_multi_location": false,
"main_location_name": null,
"main_location_tgrams_id": null
},
{
"url": "https://www.thomasnet.com/company/zepole-supply-co-20088400/profile",
"name": "Zepole Supply Co.",
"rank": "51.568188",
"tier": "NONE",
"type": "D",
"videos": null,
"address": {
"zip": "60440",
"city": "Bolingbrook",
"zip4": null,
"state": "IL",
"county": null,
"country": "USA",
"address1": "506 E. North Frontage Rd",
"address2": null,
"address3": null,
"latitude": 41.69832555,
"longitude": -88.0778819,
"state_name": "Illinois"
},
"heading": null,
"website": "https://zepole.com/",
"distance": null,
"headings": [
{
"heading_id": "31172406",
"natural_name": "Table Forks"
}
],
"logo_url": null,
"pdm_text": "Flatware distributor providing a full line of products for the restaurant industry. Stainless steel forks are offered in four different styles including Barcelona, Delta, Dominion and Windsor. Barcelona forks are provided in dessert / salad and Euro size type table forks and are constructed of 18/0 stainless and offered in 3 dz./bx. packaging. Delta style forks are available in dinner and salad fork type and provided in a 3 dz./cs. package. Dominion and Windsor style forks are provided in a packaging of 50 dz./cs., and are constructed of 18/0 chrome with a medium weight in dinner or salad type table forks.",
"products": null,
"tgrams_id": "20088400",
"is_claimed": false,
"logo_title": "Zepole Supply Co. Company Logo",
"description": "A distributor of shelves and shelving units for the baking industry. These units are constructed of chrome plated wire shelves and are available in 18 inches and 24 inches wide configurations. Both sizes are available in units measuring from 36 inches to 72 inches high. These units have a weight capacity of 600 to 800 lb. per shelf or 2000 lb. per assembled unit. Chrome plated posts for shelving units can be found here as well, constructed of 16 gauge round steel tubing.",
"annual_sales": "Under $1 Mil",
"capabilities": null,
"catalog_type": null,
"year_founded": "2007",
"is_advertiser": false,
"primary_phone": "(630) 783-1239",
"heading_brands": null,
"is_top_responder": null,
"number_employees": "1-9",
"other_activities": null,
"xometry_verified": false,
"is_multi_location": false,
"main_location_name": null,
"main_location_tgrams_id": null
}
],
"pagination": {
"current": 1,
"per_page": 2,
"total_pages": 1,
"has_next_page": false,
"total_results": 2
},
"search_term": "dz",
"company_name_matches": [
{
"url": "https://www.thomasnet.com/company/dz-technologies-inc-30478368/profile",
"name": "DZ Technologies, Inc.",
"tier": "NONE",
"type": "S",
"social": null,
"address": {
"zip": "75379",
"city": "Dallas",
"zip4": null,
"state": "TX",
"county": null,
"country": "USA",
"address1": "P.O. Box 796593",
"address2": null,
"address3": null,
"latitude": 32.78380685,
"longitude": -96.801006,
"state_name": "Texas"
},
"heading": null,
"website": null,
"headings": null,
"logo_url": null,
"premiums": null,
"personnel": null,
"tgrams_id": "30478368",
"is_claimed": false,
"logo_title": "DZ Technologies, Inc. Company Logo",
"description": "Turnkey electronic hardware & software design services for systems & board level products. Industries include telecommunications, petroleum, traffic, transportation & medical.",
"annual_sales": "Under $1 Mil",
"catalog_type": null,
"year_founded": "2003",
"is_advertiser": false,
"primary_phone": "(214) 557-2436",
"location_types": [
{
"id": 999,
"name": "No Location Type Found"
}
],
"is_top_responder": null,
"number_employees": "1-9",
"other_activities": null,
"xometry_verified": false,
"is_multi_location": false,
"main_location_name": null,
"is_affiliation_page": false,
"description_by_company": null,
"main_location_tgrams_id": null
},
{
"url": "https://www.thomasnet.com/company/dz-flooring-30204802/profile",
"name": "DZ Flooring",
"tier": "NONE",
"type": "S",
"social": null,
"address": {
"zip": "60641",
"city": "Chicago",
"zip4": null,
"state": "IL",
"county": null,
"country": "USA",
"address1": "2929 N. Luna",
"address2": null,
"address3": null,
"latitude": 41.94615613,
"longitude": -87.7470686,
"state_name": "Illinois"
},
"heading": null,
"website": "Http://www.dzflooring.com",
"headings": null,
"logo_url": null,
"premiums": null,
"personnel": null,
"tgrams_id": "30204802",
"is_claimed": false,
"logo_title": "DZ Flooring Company Logo",
"description": "Flooring Contractor, Commercial & Residential Applications. Hardwood Flooring Install, Inspection, & Finishing. Also Painting, Ceramic Flooring, & Brick Paving.",
"annual_sales": "Under $1 Mil",
"catalog_type": null,
"year_founded": null,
"is_advertiser": false,
"primary_phone": "(773) 968-4649",
"location_types": [
{
"id": 999,
"name": "No Location Type Found"
}
],
"is_top_responder": null,
"number_employees": "1-9",
"other_activities": null,
"xometry_verified": false,
"is_multi_location": false,
"main_location_name": null,
"is_affiliation_page": false,
"description_by_company": null,
"main_location_tgrams_id": null
}
]
}
```
## Documentation
## Overview
Get supplier listings from any Thomasnet search or product category page. Each result includes the company name, address, phone, website, product categories, capabilities, employee count, revenue range, and a link to the full profile. Filters, pagination, and company name suggestions are included when Thomasnet displays them.
Copy the URL from your browser after searching on thomasnet.com. Piloterr returns the supplier cards as structured JSON ready for your application.
## Quickstart
```
GET https://api.piloterr.com/v2/thomasnet/search?query=https://www.thomasnet.com/suppliers/search?searchterm=Table+Forks
```
## Supported URL formats
| Format | Example |
|---|---|
| Keyword search | `https://www.thomasnet.com/suppliers/search?searchterm=Table+Forks` |
| Product category | `https://www.thomasnet.com/suppliers/table-forks-31172406` |
| Paginated search | `https://www.thomasnet.com/suppliers/search?searchterm=dz&page_number=2` |
| Older search page | `https://www.thomasnet.com/compsearch.html?searchterm=stainless+steel` |
## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Full Thomasnet search URL |
## Response fields
| Field | Type | Description |
|---|---|---|
| `results` | array | List of suppliers on the page |
| `results[].url` | string | Link to the company profile |
| `results[].name` | string | Company name |
| `results[].tgrams_id` | string | Thomasnet company ID |
| `results[].type` | string | Company type (Manufacturer, Distributor, Service, etc.) |
| `results[].primary_phone` | string \| null | Main phone number |
| `results[].website` | string \| null | Company website |
| `results[].address` | object | Address with city, state, ZIP, and coordinates |
| `results[].headings` | array | Product or service categories shown on the card |
| `results[].description` | string \| null | Company summary |
| `results[].annual_sales` | string \| null | Revenue range |
| `results[].number_employees` | string \| null | Employee count range |
| `results[].year_founded` | string \| null | Year founded |
| `results[].capabilities` | array \| null | Materials and capabilities |
| `pagination.current` | integer | Current page number |
| `pagination.next` | integer \| null | Next page number |
| `pagination.total_pages` | integer | Total pages |
| `pagination.total_results` | integer | Total matching suppliers |
| `pagination.per_page` | integer | Suppliers on this page |
| `pagination.has_next_page` | boolean | Whether another page exists |
| `search_term` | string \| null | Keyword used for the search |
| `filters` | array \| null | Filters available on the page |
| `company_name_matches` | array \| null | Companies matching the search name |
## Notes
- Covers **thomasnet.com**, the North American industrial supplier directory.
- `company_name_matches` may appear when you search by company name.
- Pass `results[].url` to **Thomasnet Company** for the full profile, products, and business details.
- Costs **3 credits** per call.
## Main use cases
- Build supplier lead lists by product or keyword
- Compare manufacturers and distributors by location and size
- Feed procurement or sales tools with Thomasnet listings
- Browse search results page by page