Creazione con l'API Ask

Richiedi informazioni sull'utilizzo delle API

Devi login O iscrizione per utilizzare l'API BuiltWith.

Introduzione

L'API Ask di BuiltWith converte le domande in linguaggio naturale in ricerche negli elenchi di BuiltWith e restituisce siti web corrispondenti con gli stessi attributi principali dell'API Liste.

Una normale ricerca restituisce sempre un campione. Aggiungi COMMIT=true per creare ed eseguire un report Ask completo, restituito in ordine sequenziale con paginazione tramite NEXTOFFSET.

Il metodo di accesso generale è il seguente:
https://api.builtwith.com/ask1/api.[xml|json|txt|csv|tsv]?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain

Richiesta dell'agente AI
Reference https://api.builtwith.com/llms.txt
Add the BuiltWith Ask API to my app. Make a call to ask1/api.json for "Magento websites in Spain" and page committed results with NEXTOFFSET.
Autenticazione

È necessario fornire la propria chiave API in ogni ricerca API di Ask.

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

Esempi

Ricerca di esempio JSON
https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain

Le query possono anche utilizzare parole separate da trattino
https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento-websites-in-Spain

Crea ed esegui un report completo di Ask
https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain&COMMIT=true

Ottieni la pagina successiva confermata con il valore NextOffset restituito
https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain&NEXTOFFSET=[NextOffset]

Includi metadati
https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain&COMMIT=true&META=yes

Riferimento
Parametri
Per le ricerche tramite l'API Ask è possibile fornire i seguenti parametri GET.
NomeEsempiNecessario
KEY00000000-0000-0000-0000-000000000000
Questa è la tua chiave API.
QUERYMagento websites in Spain
Query in linguaggio naturale. Gli spazi possono essere codificati come %20 o forniti come trattini.
COMMITtrue
Crea un report tramite l'API Ask e restituisce la prima pagina completa dei risultati.
NO
NEXTOFFSETQWrd7gVNwFQCWb
Recupera la pagina successiva confermata. Utilizza il valore esatto di NextOffset nella risposta precedente. Se NextOffset è END, non ci sono altri risultati.
NO
METAyes
Restituisce i metadati insieme ai risultati, inclusi nomi, titoli, link ai social media, indirizzi, email, numeri di telefono e classifiche di traffico, ove disponibili.
NO
Risposte
Formato: Ask1(Explanation,NextOffset,Results[R12])
NomeEsempioDescrizione
ExplanationMatched websites using Magento with a Spain location signal.Una breve spiegazione di come è stata interpretata la query in linguaggio naturale.
NextOffsetQWrd7gVNwFQCWbSequenza di ancoraggio crittografata per la pagina successiva. Le ricerche di esempio restituiscono END.
Results[R12]Di seguito vengono spiegati gli oggetti risultato.Siti web corrispondenti alla tua query Ask.
Risultati
Gli oggetti risultato dell'API Ask forniscono gli attributi dell'API Lists, senza LOS.
NomeEsempioDescrizione
Dexample.comUn sito web che corrisponde alla query.
FD1495580400Fu individuata per la prima volta la tecnologia Epoch Seconds.
LD1495580400L'ultima tecnologia rilevata è Epoch Seconds.
S323Spesa media mensile in tecnologia (in dollari USA).
SKU1021Prodotti unici reperibili nella sezione e-commerce del sito.
R5000Ricavi stimati dalle vendite per i siti di e-commerce.
F5000Seguaci sui social.
E100Numero di dipendenti.
A657Classifica dei primi 100 milioni di traffico in Page Rank.
Q565Tranco nella classifica dei primi 1 milione di traffico.
M854Majestic Top 1m Link Rank.
U5460Umbrella nella classifica dei primi 1 milione di traffico.
CountryESCodice paese ISO 3166-1 alpha-2.
METAOggetto meta.Fornito quando viene utilizzato il parametro META=yes.
Meta
I metadati seguono l'oggetto metadati dell'API Lists quando viene specificato META=yes.
Esempi di codice

Esempi di come effettuare richieste all'API Ask:

var client = new HttpClient();
var url = "https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain";
var body = await client.GetStringAsync(url);
Console.WriteLine(body);
import requests
response = requests.get("https://api.builtwith.com/ask1/api.json", params={
    "KEY": "00000000-0000-0000-0000-000000000000",
    "QUERY": "Magento websites in Spain"
})
print(response.json())
const params = new URLSearchParams({
  KEY: '00000000-0000-0000-0000-000000000000',
  QUERY: 'Magento websites in Spain'
});
fetch('https://api.builtwith.com/ask1/api.json?' + params)
  .then(r => r.json())
  .then(console.log);
curl "https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain"
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.