Запросить использование API

Вам нужно авторизоваться или зарегистрироваться для использования BuiltWith API.

Введение

API BuiltWith Ask преобразует вопросы на естественном языке в запросы к спискам BuiltWith и возвращает соответствующие веб-сайты с теми же основными атрибутами, что и API Lists.

Обычный поиск всегда возвращает образец. Добавьте COMMIT=true, чтобы создать и запустить полный отчет по запросу, который будет возвращаться в последовательном порядке с постраничной навигацией до NEXTOFFSET.

Общий метод доступа следующий:
https://api.builtwith.com/ask1/api.[xml|json|txt|csv|tsv]?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain

Подсказка от ИИ-агента
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.
Аутентификация

При каждом обращении к API Ask необходимо указывать свой API-ключ.

Ваш ключ API
00000000-0000-0000-0000-000000000000.

Примеры

Пример поиска в формате JSON
https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain

В запросах также можно использовать слова, разделённые дефисом.
https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento-websites-in-Spain

Создайте и запустите полный отчет по запросу.
https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain&COMMIT=true

Получите следующую зафиксированную страницу с возвращаемым значением NextOffset.
https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain&NEXTOFFSET=[NextOffset]

Включить метаданные
https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain&COMMIT=true&META=yes

Ссылка
Параметры
Для запросов к API Ask можно указывать следующие GET-параметры.
ИмяПримерыНеобходимый
KEY00000000-0000-0000-0000-000000000000
Это ваш API-ключ.
Да
QUERYMagento websites in Spain
Запрос на естественном языке. Пробелы могут быть закодированы как %20 или указа��ы в виде дефисов.
Да
COMMITtrue
Создает отчет по запросу через API Ask и возвращает первую полную страницу результатов.
Нет
NEXTOFFSETQWrd7gVNwFQCWb
Получает следующую зафиксированную страницу. Используйте точное значение из NextOffset в предыдущем ответе. Если NextOffset равно END, результатов больше нет.
Нет
METAyes
В результатах поиска отображаются метаданные, включая имена, должности, ссылки на социальные сети, адреса, электронные адреса, номера телефонов и рейтинги посещаемости (если таковые имеются).
Нет
Ответы
Формат: Ask1(Explanation,NextOffset,Results[R12])
ИмяПримерОписание
ExplanationMatched websites using Magento with a Spain location signal.Краткое объяснение того, как был интерпретирован запрос на естественном языке.
NextOffsetQWrd7gVNwFQCWbЗашифрованный якорный объект последовательности для следующей страницы. Примеры запросов возвращают END.
Results[R12]Объекты результатов поясняются ниже.Веб-сайты, соответствующие вашему запросу.
Результаты
Объекты результатов запроса API предоставляют атрибуты API списков, без учета LOS.
ИмяПримерОписание
Dexample.comВеб-сайт, соответствующий запросу.
FD1495580400Впервые обнаружена технология секунд эпохи.
LD1495580400В последний раз была обнаружена технология секунд эпохи.
S323Средние ежемесячные расходы на технологии в долларах США.
SKU1021Уникальные товары представлены в разделе электронной коммерции сайта.
R5000Предполагаемый доход от продаж для сайтов электронной коммерции.
F5000Подписчики в социальных сетях.
E100Количество сотрудников.
A657Page Rank. Лучший рейтинг трафика среди 100 м.
Q565Tranco занимает первое место по трафику среди 1 млн человек.
M854Majestic Top 1m Link Rank.
U5460Рейтинг Umbrella Top 1m Traffic.
CountryESКод страны ISO 3166-1 alpha-2.
METAМетаобъект.Поставляется при использовании параметра META=yes.
Мета
Если указано значение META=yes, метаданные следуют за объектом метаданных Lists API.
Примеры кода

Примеры запросов к 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"
Специальные домены

Мы ведём два списка, которые пригодятся вам при поиске доменов: списки игнорирования и списки BuiltWith Suffix.

Список игнорирования
TЭто наш внутренний список доменов, которые мы не индексируем. Они либо заблокированы, либо содержат слишком много вводящих в заблуждение технологий, либо слишком много поддоменов с пользовательским контентом.

BuiltWith Список суффиксов
Это основано на Список публичных суффиксов но включает множество дополнительных записей для компаний с поддоменами, которые следует считать доменами верхнего уровня. Этот список обеспечивает лучшую видимость внутренних веб-сайтов, например, он выводит northernbeaches.nsw.gov.au на верхний уровень по сравнению с nsw.gov.au.

Игнорировать домены (XML, JSON or TXT)
https://api.builtwith.com/ignoresv1/api.json
Суффиксные домены (XML, JSON or TXT)
https://api.builtwith.com/suffixv1/api.json
Коды ошибок

Обратите внимание, что отправка сообщений об ошибках в этом формате не может быть гарантирована, ваша реализация должна также рассматривать коды ответа, отличные от 200, как ошибки. Свойство Lookup будет иметь значение null (json) или не будет предоставлено (xml), если ошибка связана с сервером. Просмотреть все возможные правильно сформированные коды ошибок.

Условия эксплуатации

Наш стандартные условия распространяется на использование всех наших API.

В целом, вы можете использовать API для улучшения своего продукта различными способами. Единственное ограничение — вы не можете перепродавать данные в их исходном виде или предоставлять дублирующий функционал builtwith.com и связанным с ним сервисам.