API-Guthabennutzung

Sie müssen Login oder Melden Sie sich an um die BuiltWith-API zu verwenden. Nach der Anmeldung wird hier Ihr aktueller API-Schlüssel angezeigt.

Einführung

Die BuiltWith Trust API bietet Ihnen einen Überblick über die Domain einer Website und ermöglicht Ihnen so, deren Vertrauenswürdigkeit einzuschätzen. Wir verwenden Attribute wie Technologieaufwand, Zeit, Beziehungen zu anderen Websites, aktuelle Reaktionen, Schlüsselwörter und nicht offengelegte Methoden, um die Vertrauenswürdigkeit einer Domain zu bestimmen.

Die allgemeine Zugriffsmethode ist wie folgt:
https://api.builtwith.com/trustv1/api.[xml|json]?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=[DOMAIN]

Authentifizierung

Sie müssen bei jeder Suche Ihren API-Schlüssel angeben. Unsere Endpunkte sind ausschließlich HTTPS-fähig und bieten Schlüsselverschlüsselung. Geben Sie Ihren API-Schlüssel niemals preis.

Ihr API-Schlüssel ist
00000000-0000-0000-0000-000000000000

Beispiel für die Domänenabfrage

XML Domain abrufen
https://api.builtwith.com/trustv1/api.xml?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=hotelscombined.com

JSON Domain abrufen
https://api.builtwith.com/trustv1/api.json?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=builtwith.com

JSON Erhalten Sie zusätzliche Live-Suche
https://api.builtwith.com/trustv1/api.json?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=builtwith.com&LIVE=yes

Bewährte Methoden

Wenn Sie eine Liste neu registrierter Domänen bereitstellen, verwenden Sie immer die &LIVE=true oOption, da unsere DB immer verdächtig zurückgibt. Wenn Sie eine große Liste durcharbeiten, geben Sie &LIVE=true nur wenn der Status als „needLive“ (2 in JSON) zurückgegeben wird – dies erhöht die Durchsatzleistung.

Codebeispiele

Hier sind Implementierungsbeispiele in verschiedenen Programmiersprachen zum Stellen von API-Anfragen:

var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Get,
    RequestUri = new Uri("https://api.builtwith.com/trustv1/api.json" +
   "?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=wayfair.com.com&LIVE=yes&WORDS=gold,diamonds"),
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}
import requests
url = "https://api.builtwith.com/trustv1/api.json"
params = {
    'KEY': '00000000-0000-0000-0000-000000000000',
    'LOOKUP': 'wayfair.com.com',
    'LIVE': 'yes',
    'WORDS': 'gold,diamonds'
}
response = requests.get(url, params=params)
print(response.json())
<?php
$url = "https://api.builtwith.com/trustv1/api.json";
$params = array(
    'KEY' => '00000000-0000-0000-0000-000000000000',
    'LOOKUP' => 'wayfair.com.com',
    'LIVE' => 'yes',
    'WORDS' => 'gold,diamonds'
);
$url_with_params = $url . '?' . http_build_query($params);
$response = file_get_contents($url_with_params);
$data = json_decode($response, true);
print_r($data);
?>
const https = require('https');
const url = 'https://api.builtwith.com/trustv1/api.json?KEY='+
  '00000000-0000-0000-0000-000000000000&LOOKUP=wayfair.com.com&LIVE=yes&WORDS=gold,diamonds';
https.get(url, (res) => {
    let data = '';
    res.on('data', (chunk) => {
        data += chunk;
    });
    res.on('end', () => {
        console.log(JSON.parse(data));
    });
}).on('error', (err) => {
    console.log('Error: ' + err.message);
});
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
public class BuiltWithAPI {
    public static void main(String[] args) throws Exception {
        String url = "https://api.builtwith.com/trustv1/api.json" +
"?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=wayfair.com.com&LIVE=yes&WORDS=gold,diamonds";
        URL obj = new URL(url);
        HttpURLConnection con = (HttpURLConnection) obj.openConnection();
        con.setRequestMethod("GET");
        BufferedReader in = new BufferedReader(
            new InputStreamReader(con.getInputStream()));
        String inputLine;
        StringBuffer response = new StringBuffer();
        while ((inputLine = in.readLine()) != null) {
            response.append(inputLine);
        }
        in.close();
        System.out.println(response.toString());
    }
}
require 'net/http'
require 'uri'
require 'json'
uri = URI('https://api.builtwith.com/trustv1/api.json')
uri.query = URI.encode_www_form({
    'KEY' => '00000000-0000-0000-0000-000000000000',
    'LOOKUP' => 'wayfair.com.com',
    'LIVE' => 'yes',
    'WORDS' => 'gold,diamonds'
})
response = Net::HTTP.get_response(uri)
data = JSON.parse(response.body)
puts data
package main
import (
    "fmt"
    "io/ioutil"
    "net/http"
)
func main() {
    url := "https://api.builtwith.com/trustv1/api.json?"+
"KEY=00000000-0000-0000-0000-000000000000&LOOKUP=wayfair.com.com&LIVE=yes&WORDS=gold,diamonds"
    resp, err := http.Get(url)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }
    fmt.Println(string(body))
}
curl -X GET
"https://api.builtwith.com/trustv1/api.json?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=wayfair.com.com&LIVE=yes&WORDS=gold,diamonds"
Referenz
GET-Anforderungsparameter
NameBeispieleErforderlich
KEY00000000-0000-0000-0000-000000000000
Dies ist Ihr Schlüssel. Verwenden Sie ihn für Nachschlagevorgänge.
Ja
LOOKUPcnn.com
hotelscombined.com
Trust API unterstützt Subdomains und interne Seiten, verwendet jedoch nur die LIVE-Lookup-Funktion von Trust API.
Ja
LIVEyes
Führt eine Live-Suche der betreffenden Website durch. Dies verlangsamt die Antwort. Ein Ergebnis mit dem Status „needLive“ erfordert die Option „LIVE“, um festzustellen, ob die Website verdächtig ist oder nicht. Live-Suchen verlangsamen die Antwort der API. Sie sollten diese Option aufrufen, wenn der Antwortstatus der Nicht-LIVE-Suche „needLive“ lautet.
NEIN
Antwortobjekt
Result - Das Ergebnis ist das Stammobjekt, das von der Suche zurückgegeben wird.
NameBeispiel Beschreibung
Domainhotelscombined.comDie gesuchte Domäne/Subdomäne/URL.
Statusokverdächtig (1 in JSON) – die Website ist aufgrund eines der von uns gefundenen Attribute verdächtig
ok (0 in JSON) – wir denken, diese Website ist ok
needLive (2 in json) – diese Site erneut suchen mit &LIVE=yes Parameter für eine ausführlichere Antwort.
LiveRecordLiveRecord explained belowErgebnis einer Live-Suche nach der Domäne.
DBRecordDBRecord wird unten erklärt.Ergebnis aus unserer Datenbank.
DBRecord
DBRecord - Dies enthält die Ergebnisse einer Suche in unserer Datenbank für die Domäne.
NameBeispielBeschreibung
EarliestRecord1436584145Epochensekundenzeit für den frühesten Technologiedatensatz für die Domäne – zuerst wird geprüft, ob DBIndexed wahr ist.
LatestUpdate1543584145Epoche in Sekunden, seit wir eine Technologie aktualisiert haben – zuerst wird geprüft, ob DBIndexed wahr ist.
PremiumTechs5Die Menge an Premium-Technikern, die wir auf der Website gefunden haben.
LiveTechsfalse„true“, wenn auf der Website aktuell aktive Technologien verfolgt werden.
AffiliateLinksfalseWenn auf der Site derzeit Werbesysteme für Partnerprogramme vorhanden sind.
PaymentOptionstrueWenn die Site über einen Zahlungsanbieter verfügt, wird ein Zahlungssystem erwähnt.
EcommercetrueWenn die Site über eine E-Commerce-Technologie oder Warenkorb-/Kauflinks verfügt.
ParkedfalseWenn die Site geparkte Technologien verwendet oder geparkte Technologien erwähnt.
Spend80Durchschnittliche monatliche Ausgaben für die gesamte Domäne.
EstablishedtrueWenn die Website nach unserer Technologieindexierung älter als 1 Jahr ist.
DBIndexedtrueWenn diese Website in unserer Datenbank ist – wenn „false“, ist die Site verdächtig.
LiveRecord
LiveRecord - Dies enthält die Ergebnisse einer Live-Suche nach der Domäne.
NameBeispielBeschreibung
LookupErrorThe remote name could not be resolvedBeim Versuch, die Website aufzurufen, ist ein Fehler aufgetreten.
WebsiteErrorWebsite Lookup FailedÄhnlich wie LookupError, außer dass es sich um eine leere HTML-Antwort handeln kann.
Spend0Durchschnittliche monatliche Ausgaben für die gefundenen Webseitentechnologien.
ParkedfalseWenn die Site geparkte Technologien verwendet oder geparkte Technologien erwähnt.
AffiliateLinkstrueWenn die Site Affiliate-Werbung hat.
PaymentOptionstrueWenn die Site über einen Zahlungsanbieter verfügt, wird ein Zahlungssystem erwähnt.
EcommercetrueWenn die Site über eine E-Commerce-Technologie oder Warenkorb-/Kauflinks verfügt.
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.