ThomasNet 关键词搜索 API
POST
接口健康状态
- 24h 健康值
- 正常
- 健康 / 正常
- 可用
- 少量可用
- 基本不可用
正常
24 小时趋势
30 天趋势
关键词搜索:返回列表,默认 20 条、单次最多 200 条;主要字段 id、url、name、text、address、email。
请求发到 POST https://api.everyinfra.com/api/v1/social,platform 填 thomasnet,action 填 search。 单价 $1.39 / 千次(每次 $0.001389),失败和空结果都不收费。 同步返回;慢任务可在请求体加 "mode": "async",先拿 job_id 再轮询。
AI 提示词
#请帮我用 EveryInfra 的「ThomasNet 关键词搜索」接口(thomasnet/search)写一个数据采集脚本。
接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 thomasnet,action 填 search,参数放在 params 里。
- 必填参数:
- keyword:search 的工业产品、材料或制造服务关键词,例如 injection molding;搜索北美供应商,不是零售商品明细。
- 可选参数:
- area:供应商所在地范围,默认 NA(北美);不要直接套用国家 ISO 代码或城市名。
- limit:这次调用最多返回的条数,整数,1–200;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 422。(默认 20)
- 返回一组记录,每条记录的主要字段:id、url、name、text、address、email、emails、phone、annual_sales(年营业额区间)、employees_count(员工数)、brands(代理或自有品牌)、categories(所属工业品类);一共 16 个字段,完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=thomasnet。
- 示例请求体:
{
"platform": "thomasnet",
"action": "search",
"params": {
"keyword": "stainless steel tubing"
}
}
- 计费:$1.39 / 千次;失败和空结果不扣费。
- 一次要采几十上百个时,在请求体加 "mode": "async":先拿到 job_id,再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时,按错误信息里的候选参数和允许值修正;返回 429 或 503 时,按 Retry-After 等待后重试。
写代码前,先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式,再把方案和大概花费讲给我确认。请求参数
#| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
Authorization | header | string | 是 | - | Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。 |
platform | body | string | 是 | thomasnet | 平台标识,固定值。 |
action | body | string | 是 | search | 能力标识,固定值。 |
keyword | body.params | string | 是 | - | search 的工业产品、材料或制造服务关键词,例如 injection molding;搜索北美供应商,不是零售商品明细。 |
area | body.params | string | 否 | - | 供应商所在地范围,默认 NA(北美);不要直接套用国家 ISO 代码或城市名。 |
limit | body.params | integer (1–200) | 否 | 20 | 这次调用最多返回的条数,整数,1–200;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 422。 |
代码示例
#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"
}
}'OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key,复制出去的代码不含你的 Key。
这里检索工业供应商或产品类别,不是消费电商商品评价。
响应示例
#2026年10月25日 02:28(北京时间)用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回,已隐去名字、账号、头像、主页链接、联系方式等个人信息,列表只保留前 2 条;id、billing、quota 每次调用都不同,只给结构。
json
{ "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": { … }}
返回字段
#业务数据在 results 里;下表是每条记录可能包含的字段,平台没有提供的值不会被编造。
| 字段 | 含义 |
|---|---|
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)。 |
错误与计费
#- 401
- 缺少 Key 或 Key 无效。
- 402
- 余额不足,先充值。
- 422
- 参数名或取值不对,按错误信息给的候选改;不扣费。
- 429
- 超过每分钟请求上限,按 Retry-After 等待后再试。
- 503
- 暂时无法完成,预扣的费用退回;结果未知时先核对,不要直接重发。
- 200 空结果
- 没有数据,不扣费。
官方资料参照
#只用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。
- Thomasnet:Verified Supplier 徽章不是页面认领状态 ↗
Thomasnet 对 Verified Supplier 徽章另设公司、联系信息及产品服务核验要求。本接口的 is_claimed 仅表示认领状态,不能替代该徽章,也不证明 EveryInfra 完成供应商尽调。
核对于 2026-09-04