Mit der Ask-API erstellt

Ask-API-Nutzung

Sie müssen Login oder Melden Sie sich an um die BuiltWith-API zu verwenden.

Einführung

Die BuiltWith Ask API wandelt Fragen in natürlicher Sprache in BuiltWith-Listenabfragen um und gibt passende Websites mit denselben Kernattributen wie die Lists API zurück.

Eine normale Suche liefert immer ein Beispiel. Fügen Sie COMMIT=true hinzu, um einen vollständigen Ask-Bericht zu erstellen und auszuführen, der in sequenzieller Reihenfolge mit Paginierung bis NEXTOFFSET zurückgegeben wird.

Die allgemeine Zugriffsmethode ist wie folgt:
https://api.builtwith.com/ask1/api.[xml|json|txt|csv|tsv]?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain

KI-Agenten-Aufforderung
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.
Authentifizierung

Sie müssen Ihren API-Schlüssel bei jeder Ask API-Abfrage angeben.

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

Beispiele

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

Suchanfragen können auch durch Bindestriche getrennte Wörter verwenden.
https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento-websites-in-Spain

Erstellen und Ausführen eines vollständigen Ask-Berichts
https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain&COMMIT=true

Die nächste Seite, die mit dem zurückgegebenen NextOffset-Wert gespeichert wird, abrufen
https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain&NEXTOFFSET=[NextOffset]

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

Referenz
Parameter
Für Ask-API-Abfragen können die folgenden GET-Parameter angegeben werden.
NameBeispieleErforderlich
KEY00000000-0000-0000-0000-000000000000
Dies ist Ihr API-Schlüssel.
Ja
QUERYMagento websites in Spain
Anfrage in natürlicher Sprache. Leerzeichen können als %20 kodiert oder als Bindestriche angegeben werden.
Ja
COMMITtrue
Erstellt einen Ask-API-Bericht und gibt die erste vollständige Ergebnisseite zurück.
NEIN
NEXTOFFSETQWrd7gVNwFQCWb
Ruft die nächste gespeicherte Seite ab. Verwendet den exakten Wert von NextOffset aus der vorherigen Antwort. Wenn NextOffset END ist, gibt es keine weiteren Ergebnisse.
NEIN
METAyes
Liefert Metadaten zusammen mit den Ergebnissen zurück, darunter Namen, Titel, Social-Media-Links, Adressen, E-Mail-Adressen, Telefonnummern und, sofern verfügbar, Traffic-Rankings.
NEIN
Antworten
Format: Ask1(Explanation,NextOffset,Results[R12])
NameBeispielBeschreibung
ExplanationMatched websites using Magento with a Spain location signal.Eine kurze Erläuterung, wie die Anfrage in natürlicher Sprache interpretiert wurde.
NextOffsetQWrd7gVNwFQCWbVerschlüsselter Sequenzanker für die nächste Seite. Beispielhafte Abfragen liefern END.
Results[R12]Ergebnisobjekte werden unten erläutert.Websites, die Ihrer Ask-Anfrage entsprechen.
Ergebnisse
Die Ergebnisobjekte der Ask-API stellen die Attribute der Lists-API ohne LOS bereit.
NameBeispielBeschreibung
Dexample.comEine Website, die der Abfrage entspricht.
FD1495580400Die Epochensekundentechnologie wurde erstmals entdeckt.
LD1495580400Zuletzt wurde die Epoch-Seconds-Technologie erkannt.
S323Durchschnittliche monatliche Technologieausgaben in US-Dollar.
SKU1021Einzigartige Produkte finden Sie im E-Commerce-Bereich der Website.
R5000Geschätzter Umsatz für E-Commerce-Sites.
F5000Follower in sozialen Medien.
E100Mitarbeiterzahl.
A657PageRank: Top 100 m Traffic-Rank.
Q565Tranco Top 1 Mio. Verkehrsrang.
M854Majestätischer Top-1-Millionen-Link-Rang.
U5460Umbrella Top 1 Mio. Verkehrsrang.
CountryESISO 3166-1 Alpha-2 Ländercode.
METAMetaobjekt.Wird bereitgestellt, wenn der Parameter META=yes verwendet wird.
Meta
Die Metadaten folgen dem Metadatenobjekt der Lists API, wenn META=yes angegeben ist.
Codebeispiele

Beispiele für das Erstellen von Ask-API-Anfragen:

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"
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.