Construit avec l'API Live Feed

Introduction

L'API BuiltWith WebSocket Live Feed fournit des notifications en temps réel sur la détection des technologies via des connexions WebSocket. Abonnez-vous aux chaînes technologiques et recevez des mises à jour instantanées lorsque des sites web adoptent ou modifient des technologies.

Se connecter au point de terminaison WebSocket:
wss://sync.builtwith.com/wss/new?KEY=00000000-0000-0000-0000-000000000000

Ou connectez-vous et abonnez-vous automatiquement à une chaîne technologique:
wss://sync.builtwith.com/wss/channel/Shopify?KEY=00000000-0000-0000-0000-000000000000

Caractéristiques principales:

Notifications de détection technologique en temps réel
Abonnez-vous à des technologies spécifiques (par exemple, Shopify, WordPress) ou au canal « nouveau » pour des sites web entièrement nouveaux.
Les utilisateurs bénéficiant d'une période d'essai ou d'un aperçu reçoivent des noms de domaine masqués pour découvrir le flux.
Assistance à la reconnexion automatique

Exigences du plan:

Vous devez disposer d'un abonnement actif pour utiliser l'API Live Feed
Formule de base : jusqu’à 2 abonnements technologiques par clé API
Avantage : jusqu’à 50 abonnements technologiques par clé API
Les comptes d'essai et les comptes expirés reçoivent des données obscurcies

Voir les plans

Authentification

Les connexions WebSocket nécessitent votre clé API comme paramètre de requête.

Paramètre	Description	Requis
`KEY`	`00000000-0000-0000-0000-000000000000` Votre clé API BuiltWith (format GUID)	Oui
`SUBSCRIBE`	`Shopify` ou `new` Optionnel : abonnement automatique à un canal lors de la connexion (utilisé avec le point de terminaison /wss/channel/{tech})	Non

Modes d'affichage:

Accès complet: Les abonnés payants actifs reçoivent des noms de domaine complets
Version expurgée/Aperçu: Les utilisateurs en période d'essai et les abonnements expirés reçoivent des domaines expurgés (par exemple, « great.com » devient « grxxt.cxm »).

Points de terminaison WebSocket

Point final	Description
`wss://sync.builtwith.com/wss/new`	Connectez-vous au flux en direct. Une fois connecté, envoyez des commandes d'abonnement pour rejoindre les chaînes.
`wss://sync.builtwith.com/wss/channel/{tech}`	Connectez-vous et abonnez-vous automatiquement à une chaîne technologique spécifique (par exemple, /wss/channel/Shopify).

Commandes du client

Envoyez ces commandes JSON après vous être connecté pour gérer vos abonnements.

Commande	Description
`{"action":"subscribe","channel":"Shopify"}`	Abonnez-vous à une chaîne technologique. Utilisez des noms de technologies comme « Shopify », « WordPress », ou des chaînes basées sur des règles de domaine comme « new », « new-historical » et « premium ».
`{"action":"subscribe","channel":"new"}`	Abonnez-vous aux domaines classés selon la règle « nouveau » : le domaine a été créé récemment dans ce pipeline et toutes les technologies détectées ont été FirstDetected au cours des dernières 24 heures.
`{"action":"subscribe","channel":"new-historical"}`	Abonnez-vous aux domaines classés selon la règle « new-historical » : le domaine est nouvellement créé dans ce pipeline et toutes les technologies détectées ont une date de première détection (FirstDetected) supérieure ou égale à 1 jour.
`{"action":"subscribe","channel":"premium"}`	Abonnez-vous aux domaines classés selon la règle « premium » : le domaine est nouvellement créé, possède au moins une technologie avec une priorité > 0 et toutes les technologies détectées ont été FirstDetected au cours des dernières 1 journée.
`{"action":"unsubscribe","channel":"Shopify"}`	Se désabonner d'une chaîne.
`{"action":"list_subscriptions"}`	Veuillez indiquer vos abonnements actuels aux chaînes.

Types de canaux

Canal	Description
`new`	Canal de règles. Le domaine est nouveau dans le pipeline et toutes les technologies ont été détectées récemment (dans les 24 heures).
`new-historical`	Canal de règles. Le domaine est nouveau dans le pipeline et toutes les technologies sont historiquement détectées pour la première fois (plus ou moins d'un jour).
`premium`	Canal de règles. Le domaine est nouveau, possède au moins une technologie avec une priorité > 0 et toutes les technologies ont été détectées récemment (dans les 24 heures).
`{technology_name}`	Abonnez-vous à une technologie spécifique par son nom (par exemple, « Shopify », « WordPress », « Google Analytics »). Utilisez des tirets pour remplacer les espaces.

Formats de messages

Messages du serveur

Messages reçus du serveur WebSocket

Connexion confirmée

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

Abonnement confirmé

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

Message de détection technologique

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

Changement de statut (niveau d'abonnement modifié)

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

Message d'erreur

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

Champs de message

Champ	Description
`type`	Type de message : connecté, abonné, désabonné, message, changement de statut, erreur, information
`channel`	Le nom convivial du canal (par exemple, « Shopify », « nouveau »)
`channel_id`	L'identifiant du canal interne (GUID technologique ou « nouveau »)
`data`	La charge utile de détection avec channel_name, website_domain et epoch_secs
`website_domain`	Domaine dans lequel la technologie a été détectée (informations confidentielles pour les utilisateurs de la version d'essai)
`epoch_secs`	Horodatage Unix (secondes) du moment où la détection a été mise en file d'attente
`view_mode`	« Version complète » pour les abonnés payants, « Version expurgée (essai/aperçu) » pour les utilisateurs en période d'essai.

Domaines spéciaux

Nous tenons à votre disposition deux listes utiles pour la recherche de domaines : les listes « Ignorer » et les listes « Construire avec un suffixe ».

Liste d'ignorés
TVoici notre liste interne de domaines que nous n'indexons pas. Ils sont soit bloqués, soit contiennent trop de technologies trompeuses, soit trop de sous-domaines avec du contenu généré par les utilisateurs.

BuiltWith Liste des suffixes
Ceci est basé sur le Liste publique des suffixes mais comprend de nombreuses entrées supplémentaires pour les entreprises avec des sous-domaines qui doivent être considérés comme des domaines de premier niveau. Cette liste nous offre une meilleure visibilité pour les sites Web internes, par exemple, elle amène northernbeaches.nsw.gov.au au niveau supérieur par rapport à nsw.gov.au.

Ignorer les domaines (XML, JSON or TXT)

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

Domaines de suffixe (XML, JSON or TXT)

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

Codes d'erreur

Notez que les messages d'erreur dans ce format ne peuvent pas être garantis, votre implémentation doit également considérer les codes de réponse non 200 comme des erreurs. La propriété Lookup sera nulle (json) ou non fournie (xml) si l'erreur est liée au serveur. Afficher tous les codes d'erreur potentiels bien formés.

Conditions d'utilisation

Notre conditions générales couvrir l'utilisation de toutes nos API.

En général, vous pouvez utiliser l'API pour améliorer votre produit de nombreuses façons. La seule limitation est que vous ne pouvez pas revendre les données en l'état ni fournir des fonctionnalités dupliquées à builtwith.com et ses services associés.