WebTrackly API v1

RESTful API cho dữ liệu phân tích tên miền

Đăng nhập Các gói API

Xác thực

Mọi yêu cầu API đều cần Bearer token trong header Authorization. Lấy khóa API của bạn từ Bảng điều khiển API sau khi đăng ký một gói API.

Authorization: Bearer YOUR_API_KEY

Bắt đầu nhanh

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

URL gốc: https://webtrackly.com/api/v1/

Định dạng: JSON

Phương thức: GET

Phân trang: ?page=1 (20 mỗi trang)

Định dạng phản hồi

Các endpoint danh sách trả về kết quả được phân trang. Thông tin giới hạn tốc độ được kèm trong header phản hồi.

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

Header phản hồi

Header	Mô tả
X-RateLimit-Limit	Giới hạn lượt gọi hằng tháng
X-RateLimit-Remaining	Số lượt gọi còn lại trong tháng
X-RateLimit-Used	Số lượt gọi đã dùng trong tháng

Gói dữ liệu

GET /api/v1/packages/

Liệt kê tất cả gói dữ liệu tên miền (tệp zone và dữ liệu công nghệ). Hỗ trợ lọc và tìm kiếm.

Tham số	Kiểu	Mô tả
type	string	Lọc theo loại: zone, technology, detailed
zone	string	Lọc theo TLD của zone (ví dụ: com, net)
technology	string	Lọc theo tên công nghệ
q	string	Tìm kiếm theo tên
page	int	Số trang (mặc định: 1)

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

Lấy thông tin chi tiết về một gói dữ liệu cụ thể, bao gồm các tên miền mẫu.

{
  "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", ...]
}

Bộ dữ liệu

GET /api/v1/datasets/

Liệt kê tất cả bộ dữ liệu cao cấp. Hỗ trợ tìm kiếm.

Tham số	Kiểu	Mô tả
q	string	Tìm kiếm theo tên hoặc mô tả
page	int	Số trang (mặc định: 1)

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

Lấy chi tiết bộ dữ liệu, bao gồm dữ liệu mẫu.

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

Tài khoản

GET /api/v1/account/

Lấy thông tin gói đăng ký API, số liệu sử dụng và danh sách khóa API của bạn.

{
  "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}
  ]
}

Giới hạn tốc độ

Lượt gọi API được tính theo tháng. Giới hạn phụ thuộc vào gói đăng ký API của bạn.

Gói dịch vụ	Lượt gọi/tháng	Giá
API Starter	10,000	$29/tháng
API Professional	100,000	$99/tháng
API Enterprise	1,000,000	$299/tháng

Kết quả được phân trang với tối đa 20 mục mỗi trang để ngăn trích xuất dữ liệu hàng loạt. Xem các gói

Lỗi

Mã	Mô tả
401	Thiếu hoặc sai khóa API
403	Khóa API bị vô hiệu hóa hoặc gói đăng ký đã hết hạn
404	Không tìm thấy tài nguyên
429	Đã vượt giới hạn lượt gọi API hằng tháng

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

Ví dụ mã

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"