WebTrackly API v1

ドメインインテリジェンスデータのためのRESTful API

サインイン APIプラン

認証

すべてのAPIリクエストには、AuthorizationヘッダーにBearerトークンが必要です。APIキーは、APIプランに登録後、APIダッシュボードから取得できます。

Authorization: Bearer YOUR_API_KEY

クイックスタート

curl "https://webtrackly.com/api/v1/packages/?type=technology&q=wordpress" \
     -H "Authorization: Bearer YOUR_API_KEY"

ベースURL: https://webtrackly.com/api/v1/

形式: JSON

メソッド: GET

ページネーション: ?page=1 (20 件/ページ)

レスポンス形式

一覧系エンドポイントはページネーションされた結果を返します。レート制限情報はレスポンスヘッダーに含まれます。

{
  "results": [...],
  "count": 1511,
  "page": 1,
  "pages": 76,
  "has_next": true
}

レスポンスヘッダー

ヘッダー	説明
X-RateLimit-Limit	月間呼び出し上限
X-RateLimit-Remaining	今月の残り呼び出し回数
X-RateLimit-Used	今月の使用済み呼び出し回数

パッケージ

GET /api/v1/packages/

すべてのドメインパッケージ(ゾーンファイルおよび技術データ)を一覧表示します。フィルタリングと検索に対応。

パラメータ	型	説明
type	string	タイプで絞り込み: zone、technology、detailed
zone	string	ゾーンのTLDで絞り込み(例: com、net)
technology	string	技術名で絞り込み
q	string	名前で検索
page	int	ページ番号(デフォルト: 1)

GET /api/v1/packages/{slug}/

特定のパッケージの詳細情報(サンプルドメインを含む)を取得します。

{
  "slug": "com-zone",
  "name": ".com Zone File",
  "package_type": "zone",
  "zone": "com",
  "domain_count": 150000000,
  "price": "49.00",
  "updated_at": "2026-03-08",
  "sample_domains": ["example.com", "test.com", ...]
}

データセット

GET /api/v1/datasets/

すべてのプレミアムデータセットを一覧表示します。検索に対応。

パラメータ	型	説明
q	string	名前または説明で検索
page	int	ページ番号(デフォルト: 1)

GET /api/v1/datasets/{slug}/

データセットの詳細(サンプルデータを含む)を取得します。

{
  "slug": "ecommerce-domains-2026",
  "name": "E-commerce Domains 2026",
  "description": "...",
  "record_count": 500000,
  "price": "99.00",
  "sample": [...]
}

アカウント

GET /api/v1/account/

APIサブスクリプション情報、使用状況、APIキー一覧を取得します。

{
  "subscription": {
    "plan": "API Professional",
    "status": "active",
    "calls_limit": 100000,
    "calls_used": 1523,
    "calls_remaining": 98477,
    "expires_at": "2026-04-08"
  },
  "keys": [
    {"key": "wt_live_abc...xyz", "name": "Production", "is_active": true}
  ]
}

レート制限

API呼び出しは月単位でカウントされます。上限はご利用のAPIサブスクリプションプランによって異なります。

プラン	呼び出し/月	価格
API Starter	10,000	$29/月
API Professional	100,000	$99/月
API Enterprise	1,000,000	$299/月

大量データの一括抽出を防ぐため、結果は1ページあたり最大20件でページネーションされます。プランを見る

エラー

コード	説明
401	APIキーが未指定または無効です
403	APIキーが無効化されているか、サブスクリプションの有効期限が切れています
404	リソースが見つかりません
429	月間API呼び出し上限を超過しました

{"error": "Rate limit exceeded", "limit": 10000, "used": 10000}

コード例

Python

import requests

API_KEY = "YOUR_API_KEY"
BASE = "https://webtrackly.com/api/v1"
headers = {"Authorization": f"Bearer {API_KEY}"}

# Search technology packages
r = requests.get(f"{BASE}/packages/", headers=headers,
                 params={"type": "technology", "q": "wordpress"})
for pkg in r.json()["results"]:
    print(f"{pkg['name']}: {pkg['domain_count']} domains")

# Check usage
r = requests.get(f"{BASE}/account/", headers=headers)
info = r.json()["subscription"]
print(f"Used {info['calls_used']}/{info['calls_limit']}")

JavaScript

const API_KEY = 'YOUR_API_KEY';
const BASE = 'https://webtrackly.com/api/v1';
const headers = { 'Authorization': `Bearer ${API_KEY}` };

// Search packages
const res = await fetch(`${BASE}/packages/?type=zone&q=com`, { headers });
const data = await res.json();
data.results.forEach(pkg =>
    console.log(`${pkg.name}: ${pkg.domain_count} domains`)
);

// Check rate limits from headers
console.log('Remaining:', res.headers.get('X-RateLimit-Remaining'));

PHP

$apiKey = 'YOUR_API_KEY';
$base = 'https://webtrackly.com/api/v1';

$ch = curl_init("$base/packages/?type=technology&q=wordpress");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer $apiKey"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

foreach ($result['results'] as $pkg) {
    echo "- {$pkg['name']}: {$pkg['domain_count']} domains\n";
}

cURL

# List zone packages
curl "https://webtrackly.com/api/v1/packages/?type=zone" \
     -H "Authorization: Bearer YOUR_API_KEY"

# Get package details
curl "https://webtrackly.com/api/v1/packages/com-zone/" \
     -H "Authorization: Bearer YOUR_API_KEY"

# Check account usage
curl "https://webtrackly.com/api/v1/account/" \
     -H "Authorization: Bearer YOUR_API_KEY"