라이브 피드 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'으로 변경됨).
웹소켓 엔드포인트
엔드포인트설명
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일 이내에 FirstDetected되었습니다.
{"action":"subscribe","channel":"new-historical"}'신규-이력' 규칙으로 분류된 도메인을 구독하세요. 해당 도메인은 이 파이프라인에서 새로 생성되었으며, 감지된 모든 기술의 FirstDetected 시간이 1일 이상입니다.
{"action":"subscribe","channel":"premium"}'프리미엄' 규칙으로 분류된 도메인을 구독하세요. 해당 도메인은 새로 생성되었고, 우선순위가 0보다 큰 기술이 하나 이상 있으며, 감지된 모든 기술이 지난 1일 이내에 FirstDetected된 상태입니다.
{"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', '새로운')
channel_id내부 채널 ID(기술 GUID 또는 '새로운')
data채널 이름, 웹사이트 도메인 및 에포크 초를 포함하는 탐지 페이로드
website_domain기술이 감지된 영역(체험판 사용자의 정보는 삭제됨)
epoch_secs탐지 요청이 대기열에 추가된 시점의 유닉�� 에포크 타임스탬프(초)
view_mode유료 구독자는 '전체' 버전을, 체험판 사용자는 '일부 내용 삭제됨(체험/미리보기)' 버전을 이용할 수 있습니다.
특수 도메인

도메인을 검색할 때 유용한 두 가지 목록이 있습니다. Ignore 목록과 BuiltWith Suffix 목록입니다.

무시 목록
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 및 관련 서비스에 중복된 기능을 제공할 수 없습니다.