API Live Feed integrato

Introduzione

L'API BuiltWith WebSocket Live Feed fornisce notifiche di rilevamento tecnologico in tempo reale tramite connessioni WebSocket. Iscriviti ai canali tecnologici e ricevi aggiornamenti immediati quando i siti web adottano o modificano tecnologie.

Connettiti all'endpoint WebSocket:
wss://sync.builtwith.com/wss/new?KEY=00000000-0000-0000-0000-000000000000

Oppure connettiti e iscriviti automaticamente a un canale tecnologico:
wss://sync.builtwith.com/wss/channel/Shopify?KEY=00000000-0000-0000-0000-000000000000

Caratteristiche principali:

Notifiche di rilevamento della tecnologia in tempo reale
Iscriviti a tecnologie specifiche (ad esempio, Shopify, WordPress) o al canale "nuovo" per siti web completamente nuovi
Gli utenti di prova/anteprima ricevono nomi di dominio redatti per provare il feed
Supporto per la riconnessione automatica

Requisiti del piano:

Per utilizzare l'API Live Feed è necessario un piano attivo
Base: fino a 2 abbonamenti tecnologici per chiave API
Pro: fino a 50 abbonamenti tecnologici per chiave API
Gli account di prova e scaduti ricevono dati offuscati

Visualizza i piani

Autenticazione

Le connessioni WebSocket richiedono la chiave API come parametro di query.

Parametro	Descrizione	Necessario
`KEY`	`00000000-0000-0000-0000-000000000000` La tua chiave API BuiltWith (formato GUID)	SÌ
`SUBSCRIBE`	`Shopify` O `new` Facoltativo: iscrizione automatica a un canale alla connessione (utilizzata con l'endpoint /wss/channel/{tech})	NO

Modalità di visualizzazione:

Accesso completo: Gli abbonati attivi a pagamento ricevono nomi di dominio completi
Redatto/Anteprima: Gli utenti di prova e gli abbonamenti scaduti ricevono domini redatti (ad esempio, 'great.com' diventa 'grxxt.cxm')

Endpoint WebSocket

Punto finale	Descrizione
`wss://sync.builtwith.com/wss/new`	Connettiti al feed live. Dopo esserti connesso, invia i comandi di iscrizione per unirti ai canali.
`wss://sync.builtwith.com/wss/channel/{tech}`	Connettiti e iscriviti automaticamente a un canale tecnologico specifico (ad esempio, /wss/channel/Shopify)

Comandi client

Invia questi comandi JSON dopo la connessione per gestire i tuoi abbonamenti

Comando	Descrizione
`{"action":"subscribe","channel":"Shopify"}`	Iscriviti a un canale tecnologico. Usa nomi tecnologici come "Shopify", "WordPress" o canali con regole di dominio come "nuovo", "nuovo-storico" e "premium".
`{"action":"subscribe","channel":"new"}`	Iscriviti ai domini classificati in base alla regola "nuovo": il dominio è stato appena creato in questa pipeline e tutte le tecnologie rilevate sono state FirstDetected nell'ultimo giorno.
`{"action":"subscribe","channel":"new-historical"}`	Iscriviti ai domini classificati in base alla regola "new-historical": il dominio è stato appena creato in questa pipeline e tutte le tecnologie rilevate hanno FirstDetected più vecchio o uguale a 1 giorno.
`{"action":"subscribe","channel":"premium"}`	Iscriviti ai domini classificati in base alla regola "premium": il dominio è stato appena creato, ha almeno una tecnologia con priorità > 0 e tutte le tecnologie rilevate hanno FirstDetected nell'ultimo giorno.
`{"action":"unsubscribe","channel":"Shopify"}`	Annullare l'iscrizione a un canale.
`{"action":"list_subscriptions"}`	Elenca i tuoi attuali abbonamenti ai canali.

Tipi di canale

Canale	Descrizione
`new`	Canale delle regole. Il dominio è nuovo nella pipeline e tutte le tecnologie sono state rilevate di recente (entro 1 giorno).
`new-historical`	Canale delle regole. Il dominio è nuovo nella pipeline e tutte le tecnologie sono state rilevate per prime in base alla cronologia (più vecchie o uguali a 1 giorno).
`premium`	Canale della regola. Il dominio è nuovo, ha almeno una tecnologia con priorità > 0 e tutte le tecnologie sono state rilevate di recente (entro 1 giorno).
`{technology_name}`	Abbonati a una tecnologia specifica per nome (ad esempio, "Shopify", "WordPress", "Google Analytics"). Utilizza i nomi con - per sostituire gli spazi.

Formati dei messaggi

Messaggi del server

Messaggi ricevuti dal server WebSocket

Connessione confermata

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

Iscrizione confermata

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

Messaggio di rilevamento della tecnologia

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

Modifica dello stato (livello di abbonamento modificato)

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

Messaggio di errore

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

Campi del messaggio

Campo	Descrizione
`type`	Tipo di messaggio: connesso, iscritto, cancellato, messaggio, modifica_stato, errore, informazioni
`channel`	Il nome descrittivo del canale (ad esempio, "Shopify", "nuovo")
`channel_id`	ID del canale interno (GUID tecnologico o "nuovo")
`data`	Il payload di rilevamento con channel_name, website_domain ed epoch_secs
`website_domain`	Il dominio in cui è stata rilevata la tecnologia (redatto per gli utenti di prova)
`epoch_secs`	Timestamp dell'epoca Unix (secondi) per quando il rilevamento è stato messo in coda
`view_mode`	"completo" per gli abbonati paganti, "redatto (prova/anteprima)" per gli utenti di prova

Domini speciali

Manteniamo due elenchi utili per la ricerca di domini: gli elenchi "Ignora" e gli elenchi "BuiltWith Suffix".

Elenco ignorati
TQuesto è il nostro elenco interno di domini che non indicizziamo. Sono bloccati, contengono troppe tecnologie fuorvianti o troppi sottodomini con contenuti generati dagli utenti.

BuiltWith Elenco dei suffissi
Questo si basa sul Elenco dei suffissi pubblici ma include molte voci aggiuntive per le aziende con sottodomini che dovrebbero essere considerati domini di primo livello. Questo elenco ci garantisce una migliore visibilità per i siti web interni, ad esempio porta northernbeaches.nsw.gov.au al primo posto rispetto a nsw.gov.au.

Ignora domini (XML, JSON or TXT)

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

Domini suffissi (XML, JSON or TXT)

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

Codici di errore

Si noti che i messaggi di errore in questo formato non possono essere garantiti; l'implementazione dovrebbe considerare anche i codici di risposta diversi da 200 come errori. La proprietà Lookup sarà null (json) o non fornita (xml) se l'errore è correlato al server. Visualizza tutti i potenziali codici di errore ben formati.

Termini di utilizzo

Nostro termini standard coprono l'utilizzo di tutte le nostre API.

In generale, puoi utilizzare l'API per migliorare il tuo prodotto in molti modi. L'unica limitazione è che non puoi rivendere i dati così come sono o fornire funzionalità duplicate a builtwith.com e ai suoi servizi associati.