APIの使用方法について質問する

必要がある ログイン または サインアップ BuiltWith API を使用するには。

導入

BuiltWith Ask APIは、自然言語による質問をBuiltWithのリスト検索に変換し、Lists APIと同じコア属性を持つ一致するWebサイトを返します。

通常の検索では必ずサンプルが返されます。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

参照
パラメータ
Ask API のルックアップには、以下の GET パラメータを指定できます。
名前必須
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 API の結果オブジェクトは、LOS なしで Lists API の属性を提供します。
名前説明
Dexample.comクエリに一致する Web サイト。
FD1495580400エポックセカンドテクノロジーが初めて検出されました。
LD1495580400エポック秒テクノロジーが最後に検出されました。
S323月平均のテクノロジー関連支出額(米ドル)。
SKU1021サイトのECサイトで見つけることができるユニークな商品。
R5000電子商取引サイトの推定売上高。
F5000ソーシャルメディアのフォロワー。
E100従業員数
A657ページランク上位 100m トラフィック ランク。
Q565Tranco のトップ 100 万トラフィック ランク。
M854マジェスティックトップ100万リンクランク。
U5460アンブレラトップ100万トラフィックランク。
CountryESISO 3166-1 アルファ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"
特別ドメイン

ドメイン検索の際に使用する2つのリストを用意しています。無視リストとBuiltWithサフィックスリストです。

無視リスト
Tこれは、インデックスに登録しないドメインの社内リストです。これらのドメインはブロックされているか、誤解を招く技術が多すぎるか、ユーザー生成コンテンツを含むサブドメインが多すぎるため、インデックスに登録しません。

BuiltWith サフィックスリスト
これは、 パブリックサフィックスリスト ただし、トップレベルドメインと見なされるサブドメインを持つ企業の追加エントリが多数含まれています。 このリストにより、内部 Web サイトの可視性が向上します。たとえば、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 および関連サービスに重複した機能を提供したりできないことです。