ライブフィードAPI搭載

導入

BuiltWith WebSocketライブフィード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 つのテクノロジーサブスクリプション
Pro: API キーごとに最大 50 のテクノロジーサブスクリプション
試用版および期限切れのアカウントは難読化されたデータを受け取ります

プランを見る

認証

WebSocket 接続では、クエリパラメータとして API キーが必要です。

パラメータ	説明	必須
`KEY`	`00000000-0000-0000-0000-000000000000` BuiltWith API キー (GUID 形式)	はい
`SUBSCRIBE`	`Shopify` または `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」などのテクノロジー関連の名前、または「新着」「新着-historical」「プレミアム」などのドメインルールチャンネルをご利用ください。
`{"action":"subscribe","channel":"new"}`	「新規」ルールによって分類されたドメインをサブスクライブします。ドメインはこのパイプラインで新しく作成され、検出されたすべてのテクノロジーは過去 1 日以内に FirstDetected されています。
`{"action":"subscribe","channel":"new-historical"}`	「new-historical」ルールによって分類されるドメインをサブスクライブします。ドメインはこのパイプラインで新しく作成され、検出されたすべてのテクノロジーの FirstDetected は 1 日以上古いものになります。
`{"action":"subscribe","channel":"premium"}`	「プレミアム」ルールによって分類されるドメインをサブスクライブします。ドメインは新しく作成され、優先度が 0 を超えるテクノロジが少なくとも 1 つあり、検出されたテクノロジはすべて過去 1 日以内に FirstDetected されています。
`{"action":"unsubscribe","channel":"Shopify"}`	チャンネルの登録を解除します。
`{"action":"list_subscriptions"}`	現在のチャンネル登録を一覧表示します。

チャネルタイプ

チャネル	説明
`new`	ルールチャネル。ドメインはパイプラインに新しく追加され、すべてのテクノロジが最近（1 日以内）初めて検出されました。
`new-historical`	ルールチャネル。ドメインはパイプラインに新しく追加され、すべてのテクノロジは歴史的に初めて検出されます (1 日以上前)。
`premium`	ルールチャネル。ドメインは新規であり、優先度が 0 を超えるテクノロジが少なくとも 1 つ含まれており、すべてのテクノロジが最近（1 日以内）に初めて検出されています。
`{technology_name}`	特定のテクノロジーを名前で登録します（例：「Shopify」、「WordPress」、「Googleアナリティクス」）。スペースを「-」で置き換えるには、名前に「-」を付けます。

メッセージ形式

サーバーメッセージ

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`	有料会員の場合は「完全版」、試用版ユーザーの場合は「編集済み（試用版/プレビュー）」

特別ドメイン

ドメイン検索の際に使用する2つのリストを用意しています。無視リストとBuiltWithサフィックスリストです。

無視リスト
Tこれは、インデックスに登録しないドメインの社内リストです。これらのドメインはブロックされているか、誤解を招く技術が多すぎるか、ユーザー生成コンテンツを含むサブドメインが多すぎるため、インデックスに登録しません。

BuiltWith サフィックスリスト
これは、パブリックサフィックスリストただし、トップレベルドメインと見なされるサブドメインを持つ企業の追加エントリが多数含まれています。このリストにより、内部 Web サイトの可視性が向上します。たとえば、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 および関連サービスに重複した機能を提供したりできないことです。