API Documentation

# Check if a domain is reported
curl "https://phishguards.com/api/v1/check?domain=suspicious-site.com"

# Submit a phishing report (public)
curl -X POST "https://phishguards.com/api/v1/report" \
  -H "Content-Type: application/json" \
  -d '{"domain":"malicious-site.com","reason":"phishing","notes":"Fake banking login page"}'

# Report to threat intel services (requires API key)
curl -X POST "https://phishguards.com/api/v1/report" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: psk_your_api_key_here" \
  -d '{"domain":"malicious-site.com","services":["netcraft","microsoft","phishtank"]}'

# Get phishing feed in text format
curl "https://phishguards.com/api/v1/feed?format=txt&limit=1000"

# Get statistics
curl "https://phishguards.com/api/v1/stats"

# Security scan
curl "https://phishguards.com/api/v1/scan?url=https://suspicious-site.com"

const API_BASE = 'https://phishguards.com/api/v1';
const API_KEY = 'psk_your_api_key_here';

// Check if a domain is reported
const checkDomain = async (domain) => {
  const res = await fetch(`${API_BASE}/check?domain=${encodeURIComponent(domain)}`);
  return await res.json();
};

// Submit a phishing report (public)
const submitReport = async (domain, notes = '') => {
  const res = await fetch(`${API_BASE}/report`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ domain, reason: 'phishing', notes }),
  });
  return await res.json();
};

// Report to threat intel services (requires API key)
const reportToServices = async (domain, services = []) => {
  const res = await fetch(`${API_BASE}/report`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': API_KEY,
    },
    body: JSON.stringify({ domain, services }),
  });
  return await res.json();
};

// Get phishing feed
const getFeed = async (format = 'json', limit = 1000) => {
  const res = await fetch(`${API_BASE}/feed?format=${format}&limit=${limit}`);
  return format === 'json' ? await res.json() : await res.text();
};

// Usage
const result = await checkDomain('suspicious-site.com');
console.log(result.found ? `Risk: ${result.risk_level}` : 'Domain not found');

const reportResult = await reportToServices('phishing-domain.com', ['netcraft', 'microsoft']);
console.log(`Reported to ${Object.keys(reportResult.results || {}).length} services`);

import requests

API_BASE = 'https://phishguards.com/api/v1'
API_KEY = 'psk_your_api_key_here'

def check_domain(domain: str) -> dict:
    """Check if a domain is reported as phishing."""
    response = requests.get(f"{API_BASE}/check", params={"domain": domain})
    return response.json()

def submit_report(domain: str, notes: str = None, reason: str = "phishing") -> dict:
    """Submit a new phishing report (public)."""
    response = requests.post(
        f"{API_BASE}/report",
        json={"domain": domain, "reason": reason, "notes": notes}
    )
    return response.json()

def report_to_services(domain: str, services: list = None) -> dict:
    """Report domain to threat intelligence services (requires API key)."""
    response = requests.post(
        f"{API_BASE}/report",
        headers={"Content-Type": "application/json", "X-API-Key": API_KEY},
        json={"domain": domain, "services": services}
    )
    return response.json()

def get_feed(format: str = "json", limit: int = 1000) -> dict:
    """Get phishing domain feed."""
    response = requests.get(f"{API_BASE}/feed", params={"format": format, "limit": limit})
    return response.json() if format == "json" else response.text

def get_stats() -> dict:
    """Get API statistics."""
    return requests.get(f"{API_BASE}/stats").json()

# Usage
result = check_domain("suspicious-site.com")
if result.get("found"):
    print(f"Domain found! Risk level: {result.get('risk_level')}")

report_result = report_to_services("phishing-domain.com", ["netcraft", "microsoft"])
print(f"Reported to {len(report_result.get('results', {}))} services")

<?php
$API_BASE = 'https://phishguards.com/api/v1';
$API_KEY = 'psk_your_api_key_here';

function checkDomain(string $domain, string $apiBase): array {
    $url = $apiBase . '/check?domain=' . urlencode($domain);
    $response = file_get_contents($url);
    return json_decode($response, true);
}

function submitReport(string $domain, string $notes = '', string $apiBase): array {
    $ch = curl_init($apiBase . '/report');
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
        CURLOPT_POSTFIELDS => json_encode(['domain' => $domain, 'reason' => 'phishing', 'notes' => $notes]),
    ]);
    $response = curl_exec($ch);
    curl_close($ch);
    return json_decode($response, true);
}

function reportToServices(string $domain, string $apiKey, array $services = [], string $apiBase): array {
    $ch = curl_init($apiBase . '/report');
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => ['Content-Type: application/json', "X-API-Key: $apiKey"],
        CURLOPT_POSTFIELDS => json_encode(['domain' => $domain, 'services' => $services]),
    ]);
    $response = curl_exec($ch);
    curl_close($ch);
    return json_decode($response, true);
}

// Usage
$result = checkDomain('suspicious-site.com', $API_BASE);
if ($result['found'] ?? false) {
    echo "Risk level: " . $result['risk_level'];
}

$reportResult = reportToServices('phishing-domain.com', $API_KEY, ['netcraft', 'microsoft'], $API_BASE);
echo "Reported to " . count($reportResult['results'] ?? []) . " services";