組み込みリレーションシップ API

APIクレジットの使用

必要がある ログイン または サインアップ BuiltWith APIを使用する. ログインすると、実際の API キーがここに表示されます。

導入

どのサイトが何によってどのくらいの期間リンクされているかを示す、Web サイト間の関係に関する XML および JSON 結果を取得します。

リレーションシップ API では、500 のリレーションシップごとに 1 つの API クレジットが使用されます。

一般的なアクセス方法は次のとおりです -
https://api.builtwith.com/rv4/api.[xml|json|csv]?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=[DOMAIN]

認証

各検索でAPIキーをご提供いただく必要があります。エンドポイントはHTTPSのみで、キーの暗号化が行われます。 API キーを決して公開しないでください。

APIキーは
00000000-0000-0000-0000-000000000000

ドメイン取得例

JSON 単一ドメインを取得
https://api.builtwith.com/rv4/api.json?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=builtwith.com

XML 単一ドメインを取得
https://api.builtwith.com/rv4/api.xml?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=hotelscombined.com

CSV 単一ドメインを取得
https://api.builtwith.com/rv4/api.csv?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=builtwith.com

TSV 単一ドメインを取得
https://api.builtwith.com/rv4/api.Tsv?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=builtwith.com

参照
パラメータ
ルックアップには以下のGETパラメータを指定できます
名前必須
KEY00000000-0000-0000-0000-000000000000
これはキーです。検索に使用してください。
はい
LOOKUPcnn.com
news.ycombinator.com
ドメインとサブドメインは、Relationship API で機能します(内部ページではありません)
マルチルックアップオプション
RAW ドメイン検索を行う場合、一度に最大 16 個のドメインを CSV として解析できます。 例えば cnn.com,about.com,builtwith.com - これによりスループットが劇的に向上します。
はい
OFFSET500
関係結果のページのオフセット。 next_offset レスポンスにはオフセットがあり、 more_results 真実になります。
いいえ
IPyes
ウェブサイトの IP データを読み込むと、結果の量が大幅に増加します。
いいえ
APIメタ
名前説明
results24この検索の関係結果の合計数
max_per_page500検索ごとに返される結果の最大数。
next_skip1500more_results が true の場合に、次の結果ページの OFFSET パラメータとして指定する数値。
more_resultstrueさらに多くの結果がある場合、これは当てはまります。
回答
形式: Relationships[Relationship->Identifiers[Identifer]]
関係
結果は、ルックアップを識別する最上位レベルの応答です。
名前説明
Domainhotelscombined.com検索されたドメイン。
Identifiers識別子については以下で説明します。以下に説明します。
識別子
識別子は、ドメインおよびそれを持つ他のドメインで見つかる一意のコードです。
名前説明
Typegoogle-analytics識別子の種類 すべてのタイプを見る
Value454517識別子の値 - 通常は IP アドレスやアカウント ID などの識別子のコードです。
First1368860400000この識別子を最初に検出した日付(エポック ミリ秒)。
Last1398860400000この識別子を最後に検出した日付(エポック ミリ秒)。
Matches試合については以下で説明します。以下に説明します。
マッチ
一致するのは、この識別子を持つ他のドメインです。
名前説明
Domaincom-hotel.com一致するドメイン名。
First1398860400000一致したドメインでこれを最初に検出した日付(エポック ミリ秒)。
Last1418860400000一致したドメインでこれを最後に検出した日付(エポック ミリ秒)。
Overlaptrueこのドメインがルックアップドメインと同時に識別子を使用した場合。
APIライブラリ
コード例

API リクエストを行うためのさまざまなプログラミング言語での実装例を次に示します。

var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Get,
    RequestUri = new Uri("https://api.builtwith.com/rv4/api.json" +
                        "?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=wayfair.com"),
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}
import requests
url = "https://api.builtwith.com/rv4/api.json"
params = {
    'KEY': '00000000-0000-0000-0000-000000000000',
    'LOOKUP': 'wayfair.com'
}
response = requests.get(url, params=params)
print(response.json())
<?php
$url = "https://api.builtwith.com/rv4/api.json";
$params = array(
    'KEY' => '00000000-0000-0000-0000-000000000000',
    'LOOKUP' => 'wayfair.com'
);
$url_with_params = $url . '?' . http_build_query($params);
$response = file_get_contents($url_with_params);
$data = json_decode($response, true);
print_r($data);
?>
const https = require('https');
const url = 'https://api.builtwith.com/rv4/api.json?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=wayfair.com';
https.get(url, (res) => {
    let data = '';
    res.on('data', (chunk) => {
        data += chunk;
    });
    res.on('end', () => {
        console.log(JSON.parse(data));
    });
}).on('error', (err) => {
    console.log('Error: ' + err.message);
});
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
public class BuiltWithAPI {
    public static void main(String[] args) throws Exception {
        String url = "https://api.builtwith.com/rv4/api.json" +
                    "?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=wayfair.com";
        URL obj = new URL(url);
        HttpURLConnection con = (HttpURLConnection) obj.openConnection();
        con.setRequestMethod("GET");
        BufferedReader in = new BufferedReader(
            new InputStreamReader(con.getInputStream()));
        String inputLine;
        StringBuffer response = new StringBuffer();
        while ((inputLine = in.readLine()) != null) {
            response.append(inputLine);
        }
        in.close();
        System.out.println(response.toString());
    }
}
require 'net/http'
require 'uri'
require 'json'
uri = URI('https://api.builtwith.com/rv4/api.json')
uri.query = URI.encode_www_form({
    'KEY' => '00000000-0000-0000-0000-000000000000',
    'LOOKUP' => 'wayfair.com'
})
response = Net::HTTP.get_response(uri)
data = JSON.parse(response.body)
puts data
package main
import (
    "fmt"
    "io/ioutil"
    "net/http"
)
func main() {
    url := "https://api.builtwith.com/rv4/api.json?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=wayfair.com"
    resp, err := http.Get(url)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }
    fmt.Println(string(body))
}
curl -X GET
"https://api.builtwith.com/rv4/api.json?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=wayfair.com"
特別ドメイン

ドメイン検索の際に使用する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 および関連サービスに重複した機能を提供したりできないことです。