API de transmisión en vivo incorporada

Introducción

La API de transmisión en vivo de BuiltWith WebSocket proporciona notificaciones de detección de tecnología en tiempo real mediante conexiones WebSocket. Suscríbase a canales de tecnología y reciba actualizaciones instantáneas cuando los sitios web adopten o cambien tecnologías.

Conectarse al punto final de WebSocket:
wss://sync.builtwith.com/wss/new?KEY=00000000-0000-0000-0000-000000000000

O conéctate y suscríbete automáticamente a un canal de tecnología:
wss://sync.builtwith.com/wss/channel/Shopify?KEY=00000000-0000-0000-0000-000000000000

Características principales:

Notificaciones de detección de tecnología en tiempo real
Suscríbete a tecnologías específicas (por ejemplo, Shopify, WordPress) o al canal "nuevo" para sitios web completamente nuevos
Los usuarios de prueba o vista previa reciben nombres de dominio redactados para experimentar el feed
Soporte de reconexión automática

Requisitos del plan:

Necesita un plan activo para utilizar la API de Live Feed
Básico: hasta 2 suscripciones tecnológicas por clave API
Pro: hasta 50 suscripciones tecnológicas por clave API
Las cuentas de prueba y vencidas reciben datos ofuscados

Ver planes

Autenticación

Las conexiones WebSocket requieren su clave API como parámetro de consulta.

Parámetro	Descripción	Requerido
`KEY`	`00000000-0000-0000-0000-000000000000` Su clave API de BuiltWith (formato GUID)	Sí
`SUBSCRIBE`	`Shopify` o `new` Opcional: Suscribirse automáticamente a un canal al conectarse (se usa con el punto final /wss/channel/{tech})	No

Modos de visualización:

Acceso completo: Los suscriptores pagos activos reciben nombres de dominio completos
Redactado/Vista previa: Los usuarios de prueba y las suscripciones vencidas reciben dominios redactados (por ejemplo, 'great.com' se convierte en 'grxxt.cxm')

Puntos finales de WebSocket

Punto final	Descripción
`wss://sync.builtwith.com/wss/new`	Conéctate a la transmisión en vivo. Después de conectarte, envía comandos de suscripción para unirte a los canales.
`wss://sync.builtwith.com/wss/channel/{tech}`	Conectarse y suscribirse automáticamente a un canal tecnológico específico (por ejemplo, /wss/channel/Shopify)

Comandos del cliente

Envíe estos comandos JSON después de conectarse para administrar sus suscripciones

Dominio	Descripción
`{"action":"subscribe","channel":"Shopify"}`	Suscríbete a un canal de tecnología. Usa nombres de tecnología como "Shopify" o "WordPress", o usa canales de reglas de dominio como "nuevo", "nuevo histórico" y "premium".
`{"action":"subscribe","channel":"new"}`	Suscríbase a los dominios clasificados por la regla 'nueva': el dominio se creó recientemente en este canal y todas las tecnologías detectadas se detectaron por primera vez en el último día.
`{"action":"subscribe","channel":"new-historical"}`	Suscríbete a dominios clasificados por la regla 'nuevo-histórico': el dominio se crea recientemente en este pipeline y todas las tecnologías detectadas tienen FirstDetected con una antigüedad igual o mayor a 1 día.
`{"action":"subscribe","channel":"premium"}`	Suscríbete a dominios clasificados por la regla 'premium': el dominio es de reciente creación, tiene al menos una tecnología con prioridad > 0 y todas las tecnologías detectadas se detectaron por primera vez en el último día.
`{"action":"unsubscribe","channel":"Shopify"}`	Darse de baja de un canal.
`{"action":"list_subscriptions"}`	Enumere sus suscripciones de canales actuales.

Tipos de canales

Canal	Descripción
`new`	Canal de reglas. El dominio es nuevo en el pipeline y todas las tecnologías se detectaron por primera vez recientemente (en el plazo de un día).
`new-historical`	Canal de reglas. El dominio es nuevo en el pipeline y todas las tecnologías se detectan históricamente primero (con una antigüedad igual o superior a 1 día).
`premium`	Canal de reglas. El dominio es nuevo, tiene al menos una tecnología con prioridad > 0 y todas las tecnologías se detectaron por primera vez recientemente (en el último día).
`{technology_name}`	Suscríbete a una tecnología específica por nombre (p. ej., "Shopify", "WordPress", "Google Analytics"). Usa nombres con - para reemplazar espacios.

Formatos de mensajes

Mensajes del servidor

Mensajes recibidos del servidor WebSocket

Conexión confirmada

{
  "type": "connected",
  "message": "Connected successfully...",
  "available_commands": ["subscribe", "unsubscribe", "list_subscriptions"],
  "view_mode": "full"
}

Suscripción confirmada

{
  "type": "subscribed",
  "channel": "Shopify",
  "channel_id": "a1b2c3d4-..."
}

Mensaje de detección de tecnología

{
  "type": "message",
  "channel": "Shopify",
  "channel_id": "a1b2c3d4-...",
  "data": {
    "channel_name": "Shopify",
    "website_domain": "example.com",
    "epoch_secs": 1770508800
  }
}

Cambio de estado (nivel de suscripción modificado)

{
  "type": "status_change",
  "view_mode": "full",
  "message": "Your subscription has been upgraded. You now have full data access."
}

Mensaje de error

{
  "type": "error",
  "message": "Technology 'unknown-tech' not found"
}

Campos de mensaje

Campo	Descripción
`type`	Tipo de mensaje: conectado, suscrito, cancelado, mensaje, cambio de estado, error, información
`channel`	El nombre del canal amigable (por ejemplo, 'Shopify', 'nuevo')
`channel_id`	El ID del canal interno (GUID de tecnología o 'nuevo')
`data`	La carga útil de detección con channel_name, website_domain y epoch_secs
`website_domain`	El dominio donde se detectó la tecnología (redactado para usuarios de prueba)
`epoch_secs`	Marca de tiempo de época de Unix (segundos) para cuando se puso en cola la detección
`view_mode`	'completo' para suscriptores pagos, 'redactado (prueba/vista previa)' para usuarios de prueba

Dominios especiales

Mantenemos dos listas útiles para la búsqueda de dominios: listas de ignorados y listas de sufijos incorporados.

Lista de ignorados
TEsta es nuestra lista interna de dominios que no indexamos. Están bloqueados, contienen demasiadas tecnologías engañosas o demasiados subdominios con contenido generado por el usuario.

BuiltWith Lista de sufijos
Esto se basa en la Lista de sufijos públicos pero incluye muchas entradas adicionales para empresas con subdominios que deberían considerarse dominios de nivel superior. Esta lista nos proporciona una mejor visibilidad para los sitios web internos, por ejemplo, lleva a northernbeaches.nsw.gov.au al nivel superior sobre nsw.gov.au.

Ignorar dominios (XML, JSON or TXT)

https://api.builtwith.com/ignoresv1/api.json

Dominios de sufijo (XML, JSON or TXT)

https://api.builtwith.com/suffixv1/api.json

Códigos de error

Tenga en cuenta que no se pueden garantizar los mensajes de error en este formato; su implementación también debe considerar los códigos de respuesta distintos de 200 como errores. La propiedad Lookup será nula (json) o no se proporcionará (xml) si el error está relacionado con el servidor. Ver todos los posibles códigos de error bien formados.

Condiciones de uso

Nuestro términos estándar cubrir el uso de todas nuestras API.

En general, puede usar la API para mejorar su producto de diversas maneras. La única limitación es que no puede revender los datos tal cual ni proporcionar funcionalidad duplicada a builtwith.com y sus servicios asociados.