Utilizzo del credito API

Devi login O iscrizione per utilizzare l'API BuiltWith. Dopo aver effettuato l'accesso, la tua chiave API effettiva verrà mostrata qui.

Introduzione

L'API BuiltWith Trust fornisce una panoramica del dominio di un sito web, consentendoti di valutare il suo livello di affidabilità. Utilizziamo attributi come l'investimento in tecnologia, il tempo, le relazioni con altri siti, la risposta attuale, le parole chiave e i metodi non divulgati per determinare l'affidabilità di un dominio.

Il metodo di accesso generale è il seguente:
https://api.builtwith.com/trustv2/api.[xml|json]?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=[DOMAIN]

La risposta è costruita attorno a un unico elemento spiegabile Assessment.TrustLevel (Affidabile, Neutrale, Attenzione, Verifica consigliata, Contenuto riservato, Alto rischio o Non verificato) con linguaggio semplice Assessment.Reasons dietro di esso, più un ContentSafety blocco che segnala gioco d'azzardo, contenuti per adulti, sospette truffe e contenuti segnaposto live (lorem ipsum) - quindi non è necessario decodificare nulla da numeri grezzi o valori booleani per essere compreso da un essere umano o da un agente di intelligenza artificiale.

🤖 Richiesta dell'agente AI
Reference https://api.builtwith.com/llms.txt and
https://raw.githubusercontent.com/builtwith/builtwith-ai-sdk/refs/heads/main/README.md
Add builtwith AI api to my app as a client. Make a call to the trust API for the domain hotelscombined.com
Autenticazione

È necessario fornire la chiave API in ogni ricerca. I nostri endpoint sono solo HTTPS e forniscono la crittografia delle chiavi. Non esporre mai la tua chiave API.

La tua chiave API è
00000000-0000-0000-0000-000000000000

Puoi fornire la tua chiave come parametro di stringa di query o come intestazione HTTP:

  • Stringa di query: ?KEY=00000000-0000-0000-0000-000000000000
  • Intestazione HTTP: Authorization: API 00000000-0000-0000-0000-000000000000
Ottieni un esempio di dominio

XML Ottieni dominio
https://api.builtwith.com/trustv2/api.xml?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=hotelscombined.com

JSON Ottieni dominio
https://api.builtwith.com/trustv2/api.json?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=builtwith.com

JSON Ottieni una ricerca live aggiuntiva
https://api.builtwith.com/trustv2/api.json?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=builtwith.com&LIVE=yes

Buone pratiche

Se stai fornendo un elenco di domini appena registrati, usa sempre &LIVE=true opzione poiché il nostro DB restituirà sempre Non verificato per un dominio di cui non ha traccia. Se stai lavorando su un lungo elenco fornisci &LIVE=true solo se Assessment.TrustLevel restituisce 'Unverified' o 'VerificationRecommended' - questo mantiene elevata la velocità di elaborazione.

Esempi di codice

Ecco alcuni esempi di implementazione in diversi linguaggi di programmazione per effettuare richieste API:

var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Get,
    RequestUri = new Uri("https://api.builtwith.com/trustv2/api.json" +
   "?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=wayfair.com&LIVE=yes"),
};
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/trustv2/api.json"
params = {
    'KEY': '00000000-0000-0000-0000-000000000000',
    'LOOKUP': 'wayfair.com',
    'LIVE': 'yes'
}
response = requests.get(url, params=params)
print(response.json())
<?php
$url = "https://api.builtwith.com/trustv2/api.json";
$params = array(
    'KEY' => '00000000-0000-0000-0000-000000000000',
    'LOOKUP' => 'wayfair.com',
    'LIVE' => 'yes'
);
$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/trustv2/api.json?KEY='+
  '00000000-0000-0000-0000-000000000000&LOOKUP=wayfair.com&LIVE=yes';
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/trustv2/api.json" +
"?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=wayfair.com&LIVE=yes";
        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/trustv2/api.json')
uri.query = URI.encode_www_form({
    'KEY' => '00000000-0000-0000-0000-000000000000',
    'LOOKUP' => 'wayfair.com',
    'LIVE' => 'yes'
})
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/trustv2/api.json?"+
"KEY=00000000-0000-0000-0000-000000000000&LOOKUP=wayfair.com&LIVE=yes"
    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/trustv2/api.json?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=wayfair.com&LIVE=yes"
Riferimento
Parametri della richiesta GET
NomeEsempiNecessario
KEY00000000-0000-0000-0000-000000000000
Questa è la tua chiave, usala per le ricerche.
LOOKUPcnn.com
hotelscombined.com
Trust API supporta sottodomini e pagine interne, ma solo tramite la funzionalità di ricerca LIVE di Trust API.
LIVEyes
Esegue una verifica in tempo reale del sito web in questione. Questo rallenta la risposta, ma popola il campo LiveVerification e ci permette di confermare un risultato di "Verificazione consigliata" o "Non verificato". Si consiglia di chiamare questa funzione solo quando la risposta non LIVE restituisce uno di questi due livelli di attendibilità, per mantenere alta la velocità di elaborazione.
NO
Oggetto di risposta
Result - Il risultato è l'oggetto radice restituito dalla ricerca. Ogni campo è autoesplicativo: i nomi descrivono esattamente il loro significato, i valori booleani si leggono come domande sì/no (È..., Ha...), e l'enumerazione TrustLevel e i flag ContentSafety vengono restituiti come stringhe/valori booleani leggibili anziché come codici numerici, in modo che la risposta possa essere compresa e utilizzata senza dover consultare questa pagina.
NomeEsempioDescrizione
Domainhotelscombined.comIl dominio/sottodominio/URL che è stato cercato.
AssessmentAssessment explained belowIl giudizio complessivo sull'affidabilità del dominio, spiegato in parole semplici, e le motivazioni che ci hanno spinto a giungere a tale conclusione.
ContentSafetyContentSafety explained belowSegnalazioni di contenuti relativi a giochi a distanza, contenuti per adulti, sospette truffe e segnaposto live (lorem ipsum).
BusinessProfileBusinessProfile explained belowCosa sa il nostro database sulla storia tecnologica di questo dominio.
LiveVerificationLiveVerification explained belowPresente solo quando la richiesta includeva &LIVE=yes. Risultato del controllo del sito effettuato in questo momento.
Assessment
Assessment - Il verdetto: un singolo TrustLevel, le motivazioni alla base e un riepilogo di una riga. Questo è il campo da leggere per primo: ContentSafety/BusinessProfile/LiveVerification sono i segnali grezzi da cui è stato ricavato, conservati nella risposta in modo da poterli analizzare in dettaglio o applicare la propria policy.
NomeEsempioDescrizione
TrustLevelTrustedTrusted - Storia tecnologica consolidata e/o investimenti significativi: un'attività reale e continuativa.
Neutral - Non è stato rilevato nulla di sospetto, ma nemmeno un segnale positivo evidente.
Caution - parcheggiato, con contenuti segnaposto o altri segnali che meritano un'occhiata più attenta.
VerificationRecommended - link di affiliazione registrati ma nessun controllo in tempo reale ancora effettuato - richiamare con &LIVE=yes.
RestrictedContent - Rilevata tecnologia relativa al gioco d'azzardo o a contenuti per adulti.
HighRisk - associato a una truffa nota.
Unverified - Nessun record per questo dominio ancora - riprova con &LIVE=yes per un controllo in tempo reale.
Summaryhotelscombined.com is assessed as Trusted: Domain has an established technology history spanning over a year.Una spiegazione del TrustLevel, pronta per essere visualizzata e composta da una sola frase: utile per essere inserita direttamente in un'interfaccia utente o nella risposta di un agente di intelligenza artificiale.
Reasons["Domain has an established technology history spanning over a year."]I segnali specifici che hanno determinato la decisione relativa al livello di affidabilità (TrustLevel), spiegati in parole semplici.
ContentSafety
ContentSafety - Abbiamo effettuato una verifica rispetto a tutte le tecnologie che abbiamo mai rilevato sul dominio, con una sola eccezione: PlaceholderContent segnala solo le tecnologie che fanno parte dello stack attualmente attivo del sito, quindi un dominio che nel frattempo è diventato un'attività commerciale reale non viene segnalato per sempre per vecchi contenuti segnaposto.
NomeEsempioDescrizione
GamblingfalseVero se il dominio utilizza tecnologie legate al gioco d'azzardo.
AdultContentfalseVero se il dominio utilizza tecnologie classificate come contenuti per adulti.
SuspectedScamfalseVero se il dominio utilizza una tecnologia che abbiamo identificato come una truffa nota.
PlaceholderContentfalseVero solo se il contenuto placeholder/lorem-ipsum fa parte dello stack tecnologico attualmente attivo del dominio (non si tratta di un rilevamento storico obsoleto).
BusinessProfile
BusinessProfile - Cosa sa il nostro database sulla cronologia tecnologica di questo dominio. Se IsIndexed è falso, tutti gli altri campi in questo blocco vengono lasciati al loro valore predefinito e devono essere ignorati.
NomeEsempioDescrizione
IsIndexedtrueVero se il dominio è presente nel nostro database. Se falso, considera il dominio non verificato anziché inaffidabile.
DomainAgeDays1642Giorni trascorsi dalla nostra prima registrazione tecnologica per questo dominio.
LastCrawledDaysAgo3Giorni trascorsi dall'ultima volta che abbiamo rilevato una modifica tecnologica su questo dominio.
PremiumTechnologyCount5Il numero di tecnologie premium (a pagamento, con maggiore affidabilità) attualmente rilevate sul sito.
HasActiveTechnologyStacktrueVero se il dominio attualmente dispone di tecnologie attivamente monitorate (e non solo di quelle storiche).
IsParkedDomainfalseVero se il dominio utilizza la tecnologia delle pagine parcheggiate o se comunque appare parcheggiato.
IsEcommerceSitetrueVero se il sito utilizza tecnologie di e-commerce (carrello, procedura di pagamento o simili).
HasPaymentProcessingtrueVero se il sito utilizza un fornitore o un processore di pagamenti.
HasAffiliateLinksfalseVero se il sito utilizza tecnologie di pubblicità basate su programmi di affiliazione.
IsEstablishedBusinesstrueVero quando DomainAgeDays supera un anno: un indicatore che "sembra un'attività consolidata, non qualcosa di appena avviato".
EstimatedMonthlySpendUSD80Stima della spesa media mensile per la tecnologia nell'intero settore, in dollari statunitensi.
LiveVerification
LiveVerification - Presente solo quando la richiesta includeva &LIVE=yes. Risultato della verifica del contenuto attivo del dominio, anziché basarsi sulla nostra cronologia indicizzata.
NomeEsempioDescrizione
LookupSucceededtrueRestituisce False se la ricerca in tempo reale non è riuscita (vedere LookupError): i campi rimanenti in questo blocco devono essere ignorati quando il valore è False.
LookupErrorThe remote name could not be resolvedL'errore si verifica quando si tenta di raggiungere il sito web in tempo reale, se LookupSucceeded è falso.
IsParkedDomainfalseVero se il sito attivo utilizza la tecnologia delle pagine parcheggiate o comunque appare come se fosse parcheggiato.
IsEcommerceSitetrueVero se il sito web attivo utilizza una tecnologia di e-commerce.
HasPaymentProcessingtrueVero se il sito web in questione utilizza un fornitore o un processore di pagamenti.
HasAffiliateLinkstrueVero se il sito web in questione utilizza tecnologie di pubblicità affiliata.
EstimatedMonthlySpendUSD0Stima della spesa tecnologica mensile basata sui contenuti attualmente presenti sulla pagina.
Librerie API
Node.js NPM

https://www.npmjs.com/package/builtwith-api
NPM pacchetto di Zach Caceres - https://github.com/zcaceres/builtwith-api

Microsoft .NET Nuget

https://www.nuget.org/packages/BuiltWith/
C# pacchetto di BuiltWith Pty Ltd - https://github.com/builtwith/BuiltWith-C-Client-API

Esempi di codice

https://github.com/builtwith/code-examples
Esempi di tutti gli endpoint API in più lingue

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.