WebTrackly API v1

डोमेन इंटेलिजेंस डेटा के लिए RESTful 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/माह

बल्क डेटा निष्कर्षण रोकने के लिए परिणाम पेजिनेटेड होते हैं, प्रति पृष्ठ अधिकतम 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"