Utilisation du crédit API

Vous devez se connecter ou s'inscrire pour utiliser l'API BuiltWith. Après vous être connecté, votre clé API actuelle sera affichée ici.

Introduction

L'API BuiltWith Trust vous offre une vue d'ensemble du domaine d'un site web, vous permettant ainsi de déterminer son degré de confiance. Nous utilisons des attributs tels que les dépenses technologiques, le temps, les relations avec d'autres sites, la réponse actuelle, les mots-clés et des méthodes non divulguées pour déterminer la fiabilité d'un domaine.

La méthode d'accès générale est la suivante:
https://api.builtwith.com/trustv1/api.[xml|json]?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=[DOMAIN]

Authentification

Vous devez fournir votre clé API à chaque recherche. Nos points de terminaison sont exclusivement HTTPS, ce qui assure le chiffrement des clés. N'exposez jamais votre clé API.

Votre clé API est
00000000-0000-0000-0000-000000000000

Obtenir un exemple de domaine

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

JSON Obtenir un domaine
https://api.builtwith.com/trustv1/api.json?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=builtwith.com

JSON Obtenez une recherche en direct supplémentaire
https://api.builtwith.com/trustv1/api.json?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=builtwith.com&LIVE=yes

Bonnes pratiques

Si vous fournissez une liste de domaines nouvellement enregistrés, utilisez toujours le &LIVE=true ooption, car notre base de données renverra toujours des résultats suspects. Si vous travaillez sur une longue liste, veuillez fournir &LIVE=true seulement si le statut revient à « needLive » (2 en json) - cela augmentera les performances de débit.

Exemples de code

Voici des exemples d’implémentation dans différents langages de programmation pour effectuer des requêtes API :

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"
Référence
Paramètres de la requête GET
NomExemplesRequis
KEY00000000-0000-0000-0000-000000000000
Ceci est votre clé, utilisez-la pour les recherches.
Oui
LOOKUPcnn.com
hotelscombined.com
Trust API prend en charge les sous-domaines et les pages internes, mais uniquement en utilisant la fonction de recherche LIVE de Trust API.
Oui
LIVEyes
Effectue une recherche en direct du site web concerné. Cela ralentit la réponse. Un résultat avec le statut « needLive » nécessite l'option LIVE pour déterminer si le site web est suspect ou non. Les recherches en direct ralentissent la réponse de l'API ; vous devriez envisager d'appeler cette option si le statut de la réponse de recherche non LIVE est « needLive ».
Non
Objet de réponse
Result - Le résultat est l'objet racine renvoyé par la recherche
NomExempleDescription
Domainhotelscombined.comLe domaine/sous-domaine/URL qui a été recherché.
Statusoksuspect (1 dans json) - le site Web est suspect en raison de l'un des attributs que nous avons trouvés
ok (0 en json) - nous pensons que ce site Web est correct
needLive (2 en json) - rechercher à nouveau ce site avec &LIVE=yes paramètre pour une réponse plus détaillée.
LiveRecordLiveRecord explained belowRésultat d'une recherche en direct sur le domaine.
DBRecordDBRecord expliqué ci-dessous.Résultat de notre base de données.
DBRecord
DBRecord - Ceci contient les résultats d'une recherche dans notre base de données pour le domaine.
NomExempleDescription
EarliestRecord1436584145epoch secondes temps pour l'enregistrement technologique le plus ancien pour le domaine - vérifié DBIndexed est vrai en premier.
LatestUpdate1543584145secondes d'époque depuis que nous avons mis à jour une technologie - vérifié que DBIndexed est vrai en premier.
PremiumTechs5La quantité de technologies premium que nous avons trouvées sur le site Web.
LiveTechsfalsevrai si le site Web dispose de technologies actuellement en ligne suivies.
AffiliateLinksfalseSi le site dispose actuellement de systèmes de publicité de programme d'affiliation.
PaymentOptionstrueSi le site dispose d'un fournisseur de paiement ou mentionne un système de paiement.
EcommercetrueSi le site dispose d'une technologie de commerce électronique ou de liens de panier/achat.
ParkedfalseSi le site utilise des technologies garées ou mentionne le stationnement.
Spend80Dépenses mensuelles moyennes sur l'ensemble du domaine.
EstablishedtrueSi le site Web a plus d'un an d'après notre indexation technologique.
DBIndexedtrueSi ce site Web est dans notre base de données - si c'est faux, le site est suspect.
LiveRecord
LiveRecord - Ceci contient les résultats d'une recherche en direct sur le domaine.
NomExempleDescription
LookupErrorThe remote name could not be resolvedUne erreur s'est produite lors de la tentative de recherche du site Web.
WebsiteErrorWebsite Lookup FailedSimilaire à LookupError, sauf qu'il peut s'agir d'une réponse HTML vide.
Spend0Dépense mensuelle moyenne des technologies de page Web trouvées.
ParkedfalseSi le site utilise des technologies garées ou mentionne le stationnement.
AffiliateLinkstrueSi le site propose de la publicité d'affiliation.
PaymentOptionstrueSi le site dispose d'un fournisseur de paiement ou mentionne un système de paiement.
EcommercetrueSi le site dispose d'une technologie de commerce électronique ou de liens de panier/achat.
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.