API Documentation

curl -X POST "https://webfilteringdatabase.com/api/moderate.php" \
     -H "Content-Type: application/json" \
     -d '{"api_key": "YOUR_API_KEY", "query": "example.com"}'

curl -X POST "https://webfilteringdatabase.com/api/moderate.php" \
     -H "Content-Type: application/json" \
     -d '{
       "api_key": "YOUR_API_KEY",
       "query": "facebook.com"
     }'

{
    "domain": "google.com",
    "web_filtering_category": "AI / LLM Tools|Advertising/Marketing|Business|CDN / Hosting / Infrastructure|Cloud Storage / File Hosting|Developer Tools / Code Hosting|Email and Messaging|Podcasts|Search Engines & Platforms|Streaming Media|Web-based Applications|Webinars/E-learning",
    "web_filtering_categories": [
        "AI / LLM Tools",
        "Advertising/Marketing",
        "Business",
        "CDN / Hosting / Infrastructure",
        "Cloud Storage / File Hosting",
        "Developer Tools / Code Hosting",
        "Email and Messaging",
        "Podcasts",
        "Search Engines & Platforms",
        "Streaming Media",
        "Web-based Applications",
        "Webinars/E-learning"
    ],
    "primary_category": "Search Engines & Platforms",
    "risk_level": "low",
    "content risk_flags": [],
    "confidence": 0.98,
    "processing_time_ms": 12,
    "status": 200
}

curl -X POST "https://webfilteringdatabase.com/api/moderate.php" \
     -H "Content-Type: application/json" \
     -d '{
       "api_key": "YOUR_API_KEY",
       "query": "https://reddit.com/r/gambling",
       "content_type": "url"
     }'

curl -X POST "https://webfilteringdatabase.com/api/moderate.php" \
     -H "Content-Type: application/json" \
     -d '{
       "api_key": "YOUR_API_KEY",
       "api_type": "bulk",
       "content": "google.com\nfacebook.com\nbbc.co.uk\npornhub.com\nunsafe content-site.xyz"
     }'

{
    "results": [
        {
            "domain": "google.com",
            "web_filtering_category": "AI / LLM Tools|Advertising/Marketing|Business|Search Engines & Platforms|Streaming Media",
            "web_filtering_categories": ["AI / LLM Tools","Advertising/Marketing","Business","Search Engines & Platforms","Streaming Media"],
            "risk_level": "low"
        },
        {
            "domain": "facebook.com",
            "web_filtering_category": "Advertising/Marketing|Social Networking|Streaming Media",
            "web_filtering_categories": ["Advertising/Marketing","Social Networking","Streaming Media"],
            "risk_level": "low"
        },
        {
            "domain": "bbc.co.uk",
            "web_filtering_category": "News/Media|Streaming Media",
            "web_filtering_categories": ["News/Media","Streaming Media"],
            "risk_level": "low"
        },
        {
            "domain": "unsafe content-site.xyz",
            "web_filtering_category": "Restricted / Suspicious",
            "web_filtering_categories": ["Restricted / Suspicious"],
            "risk_level": "critical"
        }
    ],
    "total": 4,
    "processing_time_ms": 48,
    "status": 200
}

import requests

API_URL = "https://webfilteringdatabase.com/api/moderate.php"
API_KEY = "YOUR_API_KEY"

def classify_domain(domain):
    response = requests.post(API_URL, json={
        "api_key": API_KEY,
        "query": domain
    })
    return response.json()

result = classify_domain("example.com")
print(f"Primary category: {result['primary_category']}")
print(f"category level: {result['risk_level']}")
# Categories come pipe-separated, matching the offline database CSV format
cats = result['web_filtering_category'].split('|')
print(f"All web filtering categories: {cats}")

const API_URL = 'https://webfilteringdatabase.com/api/moderate.php';
const API_KEY = 'YOUR_API_KEY';

async function classifyDomain(domain) {
    const response = await fetch(API_URL, {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({ api_key: API_KEY, query: domain })
    });
    return response.json();
}

classifyDomain('bbc.co.uk').then(result => {
    console.log('Primary category:', result.primary_category);
    console.log('Risk:', result.risk_level);
    // Categories arrive pipe-separated, matching the offline database CSV format
    const cats = result.web_filtering_category.split('|');
    console.log('All web filtering categories:', cats);
});

<?php
$apiUrl = 'https://webfilteringdatabase.com/api/moderate.php';
$apiKey = 'YOUR_API_KEY';

function classifyDomain($domain, $apiUrl, $apiKey) {
    $ch = curl_init($apiUrl);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
        'api_key' => $apiKey,
        'query'   => $domain
    ]));
    curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $result = curl_exec($ch);
    curl_close($ch);
    return json_decode($result, true);
}

$result = classifyDomain('example.com', $apiUrl, $apiKey);
echo "Category: " . $result['primary_category'] . "\n";
echo "Risk: "     . $result['risk_level']        . "\n";
?>

import requests

API_URL = "https://webfilteringdatabase.com/api/moderate.php"
API_KEY  = "YOUR_API_KEY"

BLOCKED_CATEGORIES = {"unsafe content", "restricted content", "Adult Content", "Gambling", "Botnets"}

def should_block(domain):
    result = requests.post(API_URL, json={"api_key": API_KEY, "query": domain}).json()
    categories = set(result.get("categories", []))
    risk       = result.get("risk_level", "low")
    if risk in ("high", "critical"):
        return True, f"risk={risk}"
    blocked = categories & BLOCKED_CATEGORIES
    if blocked:
        return True, f"category={', '.join(blocked)}"
    return False, None

# Example DNS resolver hook
domain = "suspicious-unsafe content-site.xyz"
block, reason = should_block(domain)
if block:
    print(f"BLOCKED {domain}: {reason}")
else:
    print(f"ALLOWED {domain}")

{
    "error": "Invalid API key",
    "status": 401
}