# ThomasNet 关键词搜索 API (thomasnet.search)

- Canonical page: [https://everyinfra.com/thomasnet-api/search](https://everyinfra.com/thomasnet-api/search?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "thomasnet", "action": "search", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 200 per call
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=thomasnet&action=search

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | search 的工业产品、材料或制造服务关键词，例如 injection molding；搜索北美供应商，不是零售商品明细。 |
| area | not declared | no | not declared | 供应商所在地范围，默认 NA（北美）；不要直接套用国家 ISO 代码或城市名。 |
| limit | integer (1–200) | no | 20 | 这次调用最多返回的条数，整数，1–200；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。 |
| url | 该记录在原平台上的可访问链接。 |
| name | 名称。用于账号/商品/商家类能力，指该对象本身的名字。 |
| text | 正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。 |
| address | 详细地址，原文透传。 |
| email | 联系邮箱，原文透传。 |
| emails | 联系邮箱列表（一条记录可能有多个），原文透传、去重。 |
| phone | 联系电话，原文透传，未做号码格式归一。 |
| annual_sales | 年营业额区间。 |
| employees_count | 员工数。 |
| brands | 代理或自有品牌。 |
| categories | 所属工业品类。 |
| location_types | 场所类型（工厂/分销/服务点）。 |
| is_claimed | 商家是否已认领该页面。已认领的信息更新更及时。 |
| is_multi_location | 是否多地经营。 |
| image_url | 图片链接。多图能力可能返回 image_urls 数组。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "thomasnet",
  "action": "search",
  "params": {
    "keyword": "stainless steel tubing"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "thomasnet",
        "action": "search",
        "params": {
            "keyword": "stainless steel tubing",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-10-24T18:28:34Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "thomasnet",
  "action": "search",
  "results": [
    {
      "id": "30101759",
      "url": "https://www.twmetals.com/",
      "name": "TW Metals",
      "text": "Distributor of standard and custom metal pipes, tubes, rods, bars, and sheet products. Made from stainless steel, aluminum, nickel, titanium, and carbon alloy. Abrasive sawing, laser cutting, and sheet shearing services are also provided. Suitable for pumps, valves, seals, restau…",
      "address": {
        "address1": "235 Tubeway Dr.",
        "city": "Carol Stream",
        "state": "IL",
        "stateName": "Illinois",
        "zip": "60188",
        "country": "USA",
        "latitude": 41.91532739,
        "longitude": -88.128386
      },
      "phone": "•••",
      "annual_sales": "$250 Mil. and over",
      "employees_count": 1000,
      "employees_count_display": "1000+",
      "categories": [
        {
          "headingId": "1124809",
          "name": "Alloy Bars & Tubes",
          "familyName": "Tubes",
          "description": "Distributor of alloy bars & tubes. Various materials include nickel, stainless steel, aluminum, titanium and carbon. Various capabilities include sawing, cutting, heat treating, anodizing, forming, machining, honing, slitting, painting and grinding. Aerospace, commercial transpor…",
          "url": null
        },
        {
          "headingId": "1124809",
          "name": "Alloy Bars & Tubes",
          "familyName": "Aluminum",
          "description": "Distributor of alloy bars & tubes. Various materials include nickel, stainless steel, aluminum, titanium and carbon. Various capabilities include sawing, cutting, heat treating, anodizing, forming, machining, honing, slitting, painting and grinding. Aerospace, commercial transpor…",
          "url": null
        },
        {
          "headingId": "1124809",
          "name": "Alloy Bars & Tubes",
          "familyName": "Titanium",
          "description": "Distributor of alloy bars & tubes. Various materials include nickel, stainless steel, aluminum, titanium and carbon. Various capabilities include sawing, cutting, heat treating, anodizing, forming, machining, honing, slitting, painting and grinding. Aerospace, commercial transpor…",
          "url": null
        }
      ],
      "location_types": [
        {
          "id": 999,
          "name": "No Location Type Found"
        }
      ],
      "is_claimed": false,
      "is_multi_location": true,
      "image_url": "https://cdn.thomasnet.com/ccp/30101759/206782.jpg",
      "platform": "thomasnet"
    },
    {
      "id": "30719802",
      "url": "https://www.wallacemetals.com/",
      "name": "Wallace Metal Products",
      "text": "Distributor of metals. Products include aluminum, stainless steel, carbon steel and copper. 3003-H14, 5052-H32, 6061-T6, bright finish 3003-H22, mill finish 6061-T6, 2011-T3, 2024-T4 and 6063-T52 grade aluminum alloys are available. Stainless steel grades include 304, 304L, 316, …",
      "address": {
        "address1": "R.J. Casey Industrial Park Columbus & Preble Ave",
        "city": "Pittsburgh",
        "state": "PA",
        "stateName": "Pennsylvania",
        "zip": "15233",
        "country": "USA",
        "latitude": 40.46078646,
        "longitude": -80.032585
      },
      "phone": "•••",
      "annual_sales": "$1 - 4.9 Mil",
      "employees_count": "10-49",
      "categories": [
        {
          "headingId": "97006775",
          "name": "6061 Aluminum Plate",
          "familyName": "Aluminum",
          "description": "Distributor of 6061 aluminum plate. 6061-T6 grade plates and mill finish6061-T6 grade tread plates are available. Capabilities include sheet shearing and sawing.",
          "url": null
        },
        {
          "headingId": "1124809",
          "name": "Alloy Bars & Tubes",
          "familyName": "Tubes",
          "description": "Distributor of alloy bars and tubes. Products include stainless steel, carbon steel, copper alloys and aluminum alloys. Stainless steel welded and seamless tubing, stainless steel T-304 grade welded ornamental tubing, carbon steel A-36 grade square and rectangular structural tubi…",
          "url": null
        },
        {
          "headingId": "1124809",
          "name": "Alloy Bars & Tubes",
          "familyName": "Aluminum",
          "description": "Distributor of alloy bars and tubes. Products include stainless steel, carbon steel, copper alloys and aluminum alloys. Stainless steel welded and seamless tubing, stainless steel T-304 grade welded ornamental tubing, carbon steel A-36 grade square and rectangular structural tubi…",
          "url": null
        }
      ],
      "location_types": [
        {
          "id": 999,
          "name": "No Location Type Found"
        }
      ],
      "is_claimed": false,
      "is_multi_location": false,
      "image_url": "https://cdn.thomasnet.com/ritekit/wallacemetals.com.svg",
      "platform": "thomasnet"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=thomasnet
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
