实时信息 API

介绍

BuiltWith WebSocket Live Feed API 通过 WebSocket 连接提供实时技术检测通知。订阅技术频道,即可在网站采用或更改技术时立即收到更新。

连接到 WebSocket 端点:
wss://sync.builtwith.com/wss/new?KEY=00000000-0000-0000-0000-000000000000

或者连接并自动订阅某个科技频道:
wss://sync.builtwith.com/wss/channel/Shopify?KEY=00000000-0000-0000-0000-000000000000

主要特点:
  • 实时技术检测通知
  • 订阅特定技术(例如 Shopify、WordPress)或“全新”频道,获取全新网站资讯。
  • 试用/预览用户将收到经过编辑的域名以体验信息流。
  • 自动重连支持
计划要求:
  • 您需要有效的套餐才能使用实时信息流 API
  • 基本版:每个 API 密钥最多可订阅 2 项技术服务
  • 专业版:每个 API 密钥最多可订阅 50 项技术。
  • 试用账户和过期账户会收到混淆数据。
验证

WebSocket 连接需要将您的 API 密钥作为查询参数。

范围描述必需的
KEY00000000-0000-0000-0000-000000000000
您的 BuiltWith API 密钥(GUID 格式)
是的
SUBSCRIBEShopify 或者 new
可选:连接时自动订阅频道(与 /wss/channel/{tech} 端点一起使用)
查看模式:
  • 完全访问权限: 活跃付费用户可获得完整的域名
  • 已编辑/预览: 试用用户和订阅过期用户将获得经过编辑的域名(例如,“great.com”变为“grxxt.cxm”)。
WebSocket 端点
端点描述
wss://sync.builtwith.com/wss/new连接到实时源。连接后,发送订阅命令即可加入频道。
wss://sync.builtwith.com/wss/channel/{tech}连接并自动订阅特定技术频道(例如,/wss/channel/Shopify)
客户端命令
连接成功后,请发送以下 JSON 命令来管理您的订阅。
命令描述
{"action":"subscribe","channel":"Shopify"}订阅一个技术频道。使用诸如“Shopify”、“WordPress”之类的技术名称,或者使用诸如“new”、“new-historical”和“premium”之类的域名规则频道。
{"action":"subscribe","channel":"new"}订阅按“新”规则分类的域名:该域名是在此管道中新创建的,并且所有检测到的技术都是在过去 1 天内首次检测到的。
{"action":"subscribe","channel":"new-historical"}订阅按“新历史”规则分类的域名:该域名是在此管道中新创建的,并且所有检测到的技术的首次检测时间都大于或等于 1 天。
{"action":"subscribe","channel":"premium"}订阅符合“高级”规则的域名:域名是新创建的,至少有一项优先级 > 0 的技术,并且所有检测到的技术都是在过去 1 天内首次检测到的。
{"action":"unsubscribe","channel":"Shopify"}取消订阅频道。
{"action":"list_subscriptions"}列出您当前订阅的频道。
通道类型
渠道描述
new规则通道。该域是管道中的新域,所有技术都是最近首次检测到的(1 天内)。
new-historical规则通道。域是管道中的新域,所有技术都是历史上首次检测到的(小于或等于 1 天)。
premium规则通道。域是新的,至少有一项优先级 > 0 的技术,并且所有技术都是最近首次检测到的(1 天内)。
{technology_name}按名称订阅特定技术(例如,“Shopify”、“WordPress”、“Google Analytics”)。使用“-”代替空格。
消息格式
服务器消息
从 WebSocket 服务器接收的消息
连接已确认
{
  "type": "connected",
  "message": "Connected successfully...",
  "available_commands": ["subscribe", "unsubscribe", "list_subscriptions"],
  "view_mode": "full"
}
订阅已确认
{
  "type": "subscribed",
  "channel": "Shopify",
  "channel_id": "a1b2c3d4-..."
}
技术检测信息
{
  "type": "message",
  "channel": "Shopify",
  "channel_id": "a1b2c3d4-...",
  "data": {
    "channel_name": "Shopify",
    "website_domain": "example.com",
    "epoch_secs": 1770508800
  }
}
状态变更(订阅级别已更改)
{
  "type": "status_change",
  "view_mode": "full",
  "message": "Your subscription has been upgraded. You now have full data access."
}
错误信息
{
  "type": "error",
  "message": "Technology 'unknown-tech' not found"
}
消息字段
场地描述
type消息类型:已连接、已订阅、已取消订阅、消息、状态更改、错误、信息
channel友好的频道名称(例如,“Shopify”、“new”)
channel_id内部通道 ID(技术 GUID 或“新”)
data检测有效载荷包含 channel_name、website_domain 和 epoch_secs
website_domain技术检测所在领域(为试用用户已隐去相关信息)
epoch_secs检测任务被加入队列时的 Unix 时间戳(秒)
view_mode付费用户可查看“完整版”,试用用户可查看“已编辑(试用/预览)”版
特殊域名

我们维护两个列表,供您在查找域名时使用。“忽略”列表和“BuiltWith 后缀”列表。

忽略列表
T这是我们内部不予索引的域名列表。这些域名要么被屏蔽,要么包含太多误导性技术,要么包含太多包含用户生成内容的子域名。

BuiltWith 后缀列表
这是基于 公共后缀列表 但对于拥有子域名的公司来说,还包括许多额外的条目,这些子域名应被视为顶级域名。 此列表为我们提供了内部网站的更好可见性,例如,它将 northernbeaches.nsw.gov.au 置于 nsw.gov.au 之上。

忽略域 (XML, JSON or TXT)
https://api.builtwith.com/ignoresv1/api.json
后缀域 (XML, JSON or TXT)
https://api.builtwith.com/suffixv1/api.json
错误代码

请注意,这种格式的错误消息无法保证,您的实现也应该将非 200 响应代码视为错误。 如果错误与服务器相关,则 Lookup 属性将为 null(json)或未提供(xml)。 查看所有潜在的格式正确的错误代码.

使用条款

我们的 标准条款 涵盖我们所有 API 的使用。

一般来说,您可以使用 API 以多种方式增强您的产品。唯一的限制是您不能按原样转售数据,也不能向builtwith.com及其相关服务提供重复的功能。