Construit avec l'API Ask

Utilisation de l'API Ask

Vous devez se connecter ou s'inscrire pour utiliser l'API BuiltWith.

Introduction

L'API Ask de BuiltWith convertit les questions en langage naturel en recherches dans les listes BuiltWith et renvoie les sites Web correspondants possédant les mêmes attributs de base que l'API Lists.

Une recherche classique renvoie toujours un échantillon. Ajoutez COMMIT=true pour créer et exécuter un rapport Ask complet, renvoyé dans l'ordre séquentiel avec pagination jusqu'à NEXTOFFSET.

La méthode d'accès générale est la suivante :
https://api.builtwith.com/ask1/api.[xml|json|txt|csv|tsv]?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain

Invite de l'agent IA
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.
Authentification

Vous devez fournir votre clé API dans chaque requête Ask API.

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

Exemples

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

Les requêtes peuvent également utiliser des mots séparés par des tirets
https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento-websites-in-Spain

Créer et exécuter un rapport Ask complet
https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain&COMMIT=true

Récupérez la prochaine page validée avec la valeur NextOffset renvoyée.
https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain&NEXTOFFSET=[NextOffset]

Inclure les métadonnées
https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain&COMMIT=true&META=yes

Référence
Paramètres
Les paramètres GET suivants peuvent être fournis pour les recherches via l'API Ask.
NomExemplesRequis
KEY00000000-0000-0000-0000-000000000000
Voici votre clé API.
Oui
QUERYMagento websites in Spain
Requête en langage naturel. Les espaces peuvent être encodés en %20 ou fournis sous forme de tirets.
Oui
COMMITtrue
Génère un rapport Ask API et renvoie la première page complète de résultats.
Non
NEXTOFFSETQWrd7gVNwFQCWb
Récupère la page suivante validée. Utilise la valeur exacte de NextOffset dans la réponse précédente. Si NextOffset vaut END, il n'y a plus de résultats.
Non
METAyes
Renvoie les métadonnées avec les résultats, notamment les noms, titres, liens vers les réseaux sociaux, adresses, adresses e-mail, numéros de téléphone et classements de trafic, le cas échéant.
Non
Réponses
Format: Ask1(Explanation,NextOffset,Results[R12])
NomExempleDescription
ExplanationMatched websites using Magento with a Spain location signal.Une brève explication de la manière dont la requête en langage naturel a été interprétée.
NextOffsetQWrd7gVNwFQCWbAncre de séquence chiffrée pour la page suivante. Les exemples de recherche renvoient END.
Results[R12]Objets de résultat expliqués ci-dessous.Sites Web correspondant à votre requête Ask.
Résultats
Les objets de résultat de l'API Ask fournissent les attributs de l'API Lists, sans LOS.
NomExempleDescription
Dexample.comUn site Web qui correspond à la requête.
FD1495580400La technologie des secondes d'époque a été détectée pour la première fois.
LD1495580400La technologie Epoch Seconds a été détectée pour la dernière fois.
S323Dépenses mensuelles moyennes en technologies (en dollars américains).
SKU1021Des produits uniques disponibles sur la partie e-commerce du site.
R5000Chiffre d'affaires estimé pour les sites de commerce électronique.
F5000Abonnés sur les réseaux sociaux.
E100Nombre d'employés.
A657Page Rank Top 100m Classement du trafic.
Q565Classement du trafic Tranco Top 1m.
M854Majestic Top 1m Link Rank.
U5460Classement du trafic Umbrella Top 1m.
CountryESCode pays ISO 3166-1 alpha-2.
METAMéta-objet.Fourni lorsque le paramètre META=yes est utilisé.
Méta
Les métadonnées suivent l'objet de métadonnées de l'API Lists lorsque META=yes est fourni.
Exemples de code

Exemples de requêtes à l'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"
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.