内置询问API

询问 API 使用情况

你需要 登录 或者 报名 使用 BuiltWith API。

介绍

BuiltWith Ask API 将自然语言问题转换为 BuiltWith 列表查找,并返回与 Lists API 具有相同核心属性的匹配网站。

常规查找始终返回一个样本。添加 COMMIT=true 可创建并运行完整的 Ask 报告,报告将按顺序返回,并按 NEXTOFFSET 分页。

一般访问方法如下 -
https://api.builtwith.com/ask1/api.[xml|json|txt|csv|tsv]?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain

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.
验证

每次使用 Ask API 查询时,都必须提供您的 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

创建并运行完整的 Ask 报告
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

参考
参数
以下 GET 参数可用于 Ask API 查询
姓名示例必需的
KEY00000000-0000-0000-0000-000000000000
这是您的API密钥。
是的
QUERYMagento websites in Spain
自然语言查询。空格可以编码为 %20 或用短横线表示。
是的
COMMITtrue
创建一个 Ask API 报告,并返回第一页完整的结果。
NEXTOFFSETQWrd7gVNwFQCWb
获取下一个已提交的页面。使用上一个响应中 NextOffset 的精确值。如果 NextOffset 为 END,则表示没有更多结果。
METAyes
结果中包含元数据,包括姓名、职称、社交链接、地址、电子邮件、电话号码和流量排名(如有)。
回应
格式: Ask1(Explanation,NextOffset,Results[R12])
姓名例子描述
ExplanationMatched websites using Magento with a Spain location signal.简要说明如何解释自然语言查询。
NextOffsetQWrd7gVNwFQCWb下一页的加密序列锚点。示例查找返回 END。
Results[R12]结果对象解释如下。与您的 Ask 查询匹配的网站。
结果
Ask API 结果对象提供 Lists API 属性,但不包含 LOS。
姓名例子描述
Dexample.com与查询相匹配的网站。
FD1495580400纪元秒技术首次被发现。
LD1495580400最后检测到的是纪元秒技术。
S323每月科技支出平均值(美元)。
SKU1021在网站的电子商务部分可以找到独特的商品。
R5000电子商务网站的预计销售收入。
F5000社交媒体粉丝。
E100员工人数。
A657页面排名前 100 米的流量排名。
Q565Tranco 前 100 万流量排名。
M854雄伟的前 100 万链接排名。
U5460伞前 100 万流量排名。
CountryESISO 3166-1 alpha-2 国家代码。
META元对象。当使用 META=yes 参数时提供。
当提供 META=yes 时,元数据遵循 Lists API 元数据对象。
代码示例

Ask API 请求示例:

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 后缀”列表。

忽略列表
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及其相关服务提供重复的功能。