Mit der Live-Feed-API erstellt

Einführung

Die BuiltWith WebSocket Live Feed API bietet Echtzeit-Benachrichtigungen zur Technologieerkennung über WebSocket-Verbindungen. Abonnieren Sie Technologiekanäle und erhalten Sie sofortige Updates, wenn Websites neue Technologien einführen oder ändern.

Verbindung zum WebSocket-Endpunkt herstellen:
wss://sync.builtwith.com/wss/new?KEY=00000000-0000-0000-0000-000000000000

Oder verbinden Sie sich mit einem Technologiekanal und abonnieren Sie ihn automatisch.:
wss://sync.builtwith.com/wss/channel/Shopify?KEY=00000000-0000-0000-0000-000000000000

Hauptmerkmale:
  • Technologieerkennungsbenachrichtigungen in Echtzeit
  • Abonnieren Sie bestimmte Technologien (z. B. Shopify, WordPress) oder den Kanal „Neu“ für völlig neue Websites.
  • Test-/Vorschau-Nutzer erhalten redigierte Domainnamen, um den Feed zu testen.
  • Unterstützung für automatische Wiederverbindung
Plananforderungen:
  • Sie benötigen einen aktiven Tarif, um die Live Feed API nutzen zu können.
  • Basisversion: Bis zu 2 Technologie-Abonnements pro API-Schlüssel
  • Vorteil: Bis zu 50 Technologie-Abonnements pro API-Schlüssel
  • Test- und abgelaufene Konten erhalten verschleierte Daten.
Authentifizierung

Für WebSocket-Verbindungen wird Ihr API-Schlüssel als Abfrageparameter benötigt.

ParameterBeschreibungErforderlich
KEY00000000-0000-0000-0000-000000000000
Ihr BuiltWith-API-Schlüssel (GUID-Format)
Ja
SUBSCRIBEShopify oder new
Optional: Automatisches Abonnieren eines Kanals beim Verbindungsaufbau (wird mit dem Endpunkt /wss/channel/{tech} verwendet)
NEIN
Ansichtsmodi:
  • Voller Zugriff: Aktive zahlende Abonnenten erhalten vollständige Domainnamen.
  • Zensiert/Vorschau: Testnutzer und Nutzer abgelaufener Abonnements erhalten anonymisierte Domains (z. B. wird aus „great.com“ „grxxt.cxm“).
WebSocket-Endpunkte
EndpunktBeschreibung
wss://sync.builtwith.com/wss/newStelle eine Verbindung zum Live-Feed her. Sende nach der Verbindung Abonnementbefehle, um Kanälen beizutreten.
wss://sync.builtwith.com/wss/channel/{tech}Verbinden Sie sich mit einem bestimmten Technologiekanal und abonnieren Sie diesen automatisch (z. B. /wss/channel/Shopify).
Client-Befehle
Senden Sie diese JSON-Befehle nach der Verbindungsherstellung, um Ihre Abonnements zu verwalten.
BefehlBeschreibung
{"action":"subscribe","channel":"Shopify"}Abonnieren Sie einen Technologiekanal. Verwenden Sie Technologienamen wie „Shopify“, „WordPress“ oder Domänenregelkanäle wie „neu“, „neu-historisch“ und „Premium“.
{"action":"subscribe","channel":"new"}Abonnieren Sie Domains, die nach der Regel „neu“ klassifiziert sind: Die Domain wurde neu in dieser Pipeline erstellt und alle erkannten Technologien wurden innerhalb des letzten Tages erstmals erkannt.
{"action":"subscribe","channel":"new-historical"}Abonnieren Sie Domains, die nach der Regel „neu-historisch“ klassifiziert sind: Die Domain wurde in dieser Pipeline neu erstellt und alle erkannten Technologien wurden vor maximal einem Tag erstmals erkannt.
{"action":"subscribe","channel":"premium"}Abonnieren Sie Domains, die nach der „Premium“-Regel klassifiziert sind: Die Domain ist neu erstellt, verfügt über mindestens eine Technologie mit Priorität > 0 und alle erkannten Technologien wurden innerhalb des letzten Tages erstmals erkannt.
{"action":"unsubscribe","channel":"Shopify"}Kanal abbestellen.
{"action":"list_subscriptions"}Listen Sie Ihre aktuellen Kanalabonnements auf.
Kanaltypen
KanalBeschreibung
newRegelkanal. Die Domäne ist neu in der Pipeline und alle Technologien wurden erst kürzlich (innerhalb eines Tages) erkannt.
new-historicalRegelkanal. Die Domäne ist neu in der Pipeline und alle Technologien werden historisch zuerst erkannt (älter als oder gleich 1 Tag).
premiumRegelkanal. Die Domäne ist neu, verfügt über mindestens eine Technologie mit Priorität > 0, und alle Technologien wurden erst kürzlich (innerhalb eines Tages) entdeckt.
{technology_name}Abonnieren Sie eine bestimmte Technologie anhand ihres Namens (z. B. „Shopify“, „WordPress“, „Google Analytics“). Verwenden Sie Bindestriche anstelle von Leerzeichen.
Nachrichtenformate
Servermeldungen
Vom WebSocket-Server empfangene Nachrichten
Verbindung bestätigt
{
  "type": "connected",
  "message": "Connected successfully...",
  "available_commands": ["subscribe", "unsubscribe", "list_subscriptions"],
  "view_mode": "full"
}
Abonnement bestätigt
{
  "type": "subscribed",
  "channel": "Shopify",
  "channel_id": "a1b2c3d4-..."
}
Technologie-Erkennungsnachricht
{
  "type": "message",
  "channel": "Shopify",
  "channel_id": "a1b2c3d4-...",
  "data": {
    "channel_name": "Shopify",
    "website_domain": "example.com",
    "epoch_secs": 1770508800
  }
}
Statusänderung (Abonnementstufe geändert)
{
  "type": "status_change",
  "view_mode": "full",
  "message": "Your subscription has been upgraded. You now have full data access."
}
Fehlermeldung
{
  "type": "error",
  "message": "Technology 'unknown-tech' not found"
}
Nachrichtenfelder
FeldBeschreibung
typeNachrichtentyp: verbunden, abonniert, abgemeldet, Nachricht, Statusänderung, Fehler, Info
channelDer benutzerfreundliche Kanalname (z. B. „Shopify“, „neu“)
channel_idDie interne Kanal-ID (Technologie-GUID oder „neu“)
dataDie Erkennungsnutzlast mit Kanalname, Website-Domain und Epochen-Sekunden
website_domainDer Bereich, in dem die Technologie erkannt wurde (für Testnutzer geschwärzt)
epoch_secsUnix-Epochenzeitstempel (Sekunden) für den Zeitpunkt, zu dem die Erkennung in die Warteschlange gestellt wurde
view_mode„Vollversion“ für zahlende Abonnenten, „zensiert (Test-/Vorschauversion)“ für Testnutzer
Spezielle Domänen

Wir führen für Sie zwei Listen, die Sie bei der Suche nach Domänen verwenden können: Ignorierlisten und BuiltWith-Suffixlisten.

Ignorierliste
TDies ist unsere eigene interne Liste von Domänen, die wir nicht indizieren. Sie sind entweder blockiert, enthalten zu viele irreführende Technologien oder zu viele Subdomänen mit benutzergenerierten Inhalten.

BuiltWith Suffixliste
Dies basiert auf der Öffentliche Suffixliste enthält aber viele zusätzliche Einträge für Unternehmen mit Subdomänen, die als Top-Level-Domänen betrachtet werden sollten. Diese Liste bietet uns eine bessere Sichtbarkeit für interne Websites, beispielsweise bringt sie northernbeaches.nsw.gov.au auf die oberste Ebene über nsw.gov.au.

Domänen ignorieren (XML, JSON or TXT)
https://api.builtwith.com/ignoresv1/api.json
Suffixdomänen (XML, JSON or TXT)
https://api.builtwith.com/suffixv1/api.json
Fehlercodes

Beachten Sie, dass Fehlermeldungen in diesem Format nicht garantiert werden können. Ihre Implementierung sollte auch Antwortcodes ungleich 200 als Fehler betrachten. Die Lookup-Eigenschaft ist null (JSON) oder wird nicht bereitgestellt (XML), wenn der Fehler serverbezogen ist. Alle potenziellen wohlgeformten Fehlercodes anzeigen.

Nutzungsbedingungen

Unser Allgemeine Geschäftsbedingungen decken die Verwendung aller unserer APIs ab.

Sie können die API grundsätzlich nutzen, um Ihr Produkt auf vielfältige Weise zu verbessern. Die einzige Einschränkung besteht darin, dass Sie die Daten nicht unverändert weiterverkaufen oder doppelte Funktionen für builtwith.com und die zugehörigen Dienste bereitstellen dürfen.