{
    "openapi": "3.0.0",
    "tags": [
        {
            "name": "Domain & IP Tools"
        },
        {
            "name": "Security"
        },
        {
            "name": "Validation Tools"
        },
        {
            "name": "Web Utilities"
        },
        {
            "name": "Data & Content"
        },
        {
            "name": "Financial"
        },
        {
            "name": "Generators"
        }
    ],
    "paths": {
        "/subdomainfinder": {
            "get": {
                "tags": [
                    "Domain & IP Tools"
                ],
                "summary": "Subdomain Finder",
                "description": "Performs an advanced scan to find subdomains of the given domain. Add parameter <b>&realtime=true</b> for realtime and instant results",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "domain",
                        "in": "query",
                        "description": "The domain to find subdomains for (e.g., example.com).",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "example.com"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "A successful response containing the list of found subdomains.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "subdomains": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "subdomain": {
                                                        "type": "string"
                                                    },
                                                    "ip": {
                                                        "type": "string"
                                                    },
                                                    "cloudflare": {
                                                        "type": "boolean"
                                                    }
                                                }
                                            }
                                        },
                                        "cached": {
                                            "type": "boolean"
                                        },
                                        "cache_time": {
                                            "type": "string",
                                            "format": "date-time"
                                        }
                                    }
                                },
                                "example": {
                                    "success": true,
                                    "subdomains": [
                                        {
                                            "subdomain": "autodiscover.example.com",
                                            "ip": "none",
                                            "cloudflare": false
                                        },
                                        {
                                            "subdomain": "mail.example.com",
                                            "ip": "none",
                                            "cloudflare": false
                                        },
                                        {
                                            "subdomain": "www.example.com",
                                            "ip": "23.77.197.7",
                                            "cloudflare": false
                                        }
                                    ],
                                    "cached": true,
                                    "cache_time": "2025-06-18 03:54:11"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/ipreputation": {
            "get": {
                "tags": [
                    "Security"
                ],
                "summary": "IP Reputation/Malicious IP Checker",
                "description": "Checks if the IP is involved in any malicious activity. Checks common lists.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "host",
                        "in": "query",
                        "description": "IP or host/domain of the target",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "134.209.199.4"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": null
            }
        },
        "/phonelookup": {
            "get": {
                "tags": [
                    "Validation Tools"
                ],
                "summary": "Phone Number Lookup",
                "description": "Validates and retrieves details about a phone number, including country, carrier, and validity.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "number",
                        "in": "query",
                        "description": "The phone number to look up, including the country code (e.g., +31637333793).",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "31637333793"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Detailed information about the phone number.",
                        "content": {
                            "application/json": {
                                "example": {
                                    "success": true,
                                    "details": {
                                        "valid": true,
                                        "number": "31637333793",
                                        "international_format": "+31637333793",
                                        "country_code": "NL",
                                        "country_name": "Netherlands",
                                        "carrier": "Teleena Holding B.V."
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/firewalldetector": {
            "get": {
                "tags": [
                    "Security"
                ],
                "summary": "Firewall Detector",
                "description": "Detects if a website is protected by a known Web Application Firewall (WAF).",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "url",
                        "in": "query",
                        "description": "The URL of the website to check.",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "sucuri.net"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The detected firewall or a confirmation of none.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "result": {
                                            "type": "string"
                                        }
                                    }
                                },
                                "example": {
                                    "success": true,
                                    "result": "Sucuri CloudProxy (Sucuri Inc.)"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/gethostname": {
            "get": {
                "tags": [
                    "Domain & IP Tools"
                ],
                "summary": "Get Hostname",
                "description": "Resolves an IP address to its corresponding hostname (reverse DNS lookup).",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "host",
                        "in": "query",
                        "description": "The IP address to resolve (e.g., 1.1.1.1).",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "1.1.1.1"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The resolved hostname.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "hostname": {
                                            "type": "string"
                                        }
                                    }
                                },
                                "example": {
                                    "success": true,
                                    "hostname": "one.one.one.one"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/dnschecker": {
            "get": {
                "tags": [
                    "Domain & IP Tools"
                ],
                "summary": "DNS Checker",
                "description": "Performs a DNS lookup for a given domain and record type.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "url",
                        "in": "query",
                        "description": "The domain name to check (e.g., example.com).",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "example.com"
                        }
                    },
                    {
                        "name": "type",
                        "in": "query",
                        "description": "The DNS record type to query (e.g., A, AAAA, MX, NS, TXT, CNAME, SRV, SOA, NAPTR, PTR, ALL).",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "all"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The DNS query result.",
                        "content": {
                            "application/json": {
                                "example": {
                                    "status": "success",
                                    "domain": "example.com",
                                    "data": {
                                        "a": [
                                            "104.18.27.120",
                                            "104.18.26.120"
                                        ],
                                        "aaaa": [
                                            "2606:4700::6812:1a78",
                                            "2606:4700::6812:1b78"
                                        ],
                                        "mx": [
                                            {
                                                "exchange": "",
                                                "priority": 0
                                            }
                                        ],
                                        "txt": [
                                            "v=spf1 -all",
                                            "_k2n1y4vw3qtb4skdx9e7dxt97qrmmq9"
                                        ],
                                        "ns": [
                                            "hera.ns.cloudflare.com",
                                            "elliott.ns.cloudflare.com"
                                        ],
                                        "soa": {
                                            "nsname": "elliott.ns.cloudflare.com",
                                            "hostmaster": "dns.cloudflare.com",
                                            "serial": 2393120882,
                                            "refresh": 10000,
                                            "retry": 2400,
                                            "expire": 604800,
                                            "minttl": 1800
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/dnsresolver": {
            "get": {
                "tags": [
                    "Domain & IP Tools"
                ],
                "summary": "Gets the IP behind a host",
                "description": "Gets server IP of given host.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "host",
                        "in": "query",
                        "description": "The domain name to check (e.g., example.com).",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "whitehouse.gov"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The DNS query result.",
                        "content": {
                            "application/json": {
                                "example": {
                                    "success": true,
                                    "ip": "104.18.27.120"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/ip2domains": {
            "get": {
                "tags": [
                    "Domain & IP Tools"
                ],
                "summary": "IP to Domains",
                "description": "Finds domains that are hosted on a given IP address (reverse IP lookup).",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "ip",
                        "in": "query",
                        "description": "The IP address to query.",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "1.1.1.1"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "A list of domains associated with the IP.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "count": {
                                            "type": "integer"
                                        },
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "success": true,
                                    "count": 20777,
                                    "data": [
                                        "0.pizza",
                                        "000.kids",
                                        "000071.xyz"
                                    ]
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/whois": {
            "get": {
                "tags": [
                    "Domain & IP Tools"
                ],
                "summary": "WHOIS Lookup",
                "description": "Retrieves WHOIS registration data for a given domain name.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "domain",
                        "in": "query",
                        "description": "The domain name for the WHOIS lookup.",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "example.com"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The raw and split WHOIS record.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "result": {
                                            "type": "string"
                                        },
                                        "splitted_result": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "success": true,
                                    "result": "[Querying whois.verisign-grs.com]<br />...",
                                    "splitted_result": [
                                        "[Querying whois.verisign-grs.com]",
                                        "[Redirected to whois.iana.org]"
                                    ]
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/geoip": {
            "get": {
                "tags": [
                    "Domain & IP Tools"
                ],
                "summary": "GeoIP Lookup",
                "description": "Provides geolocation information for a given IP address or hostname.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "host",
                        "in": "query",
                        "description": "The IP address or hostname to geolocate.",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "1.1.1.1"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Detailed geolocation data for the host.",
                        "content": {
                            "application/json": {
                                "example": {
                                    "success": true,
                                    "ip": "1.1.1.1",
                                    "hostname": "one.one.one.one",
                                    "records": {
                                        "country_code": "Unknown",
                                        "country_name": "Unknown",
                                        "isp": "Cloudflare, Inc",
                                        "organization": "CLOUDFLARENET",
                                        "asn": "AS13335"
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/upordown": {
            "get": {
                "tags": [
                    "Domain & IP Tools"
                ],
                "summary": "Up or Down Checker",
                "description": "Checks if a website or host is online and accessible.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "host",
                        "in": "query",
                        "description": "The hostname or IP address to check.",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "example.com"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The status of the host.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "host": {
                                            "type": "string"
                                        },
                                        "ip": {
                                            "type": "string"
                                        },
                                        "port": {
                                            "type": "integer"
                                        },
                                        "code": {
                                            "type": "integer"
                                        },
                                        "status_short": {
                                            "type": "string"
                                        },
                                        "status_long": {
                                            "type": "string"
                                        },
                                        "response_time": {
                                            "type": "number"
                                        }
                                    }
                                },
                                "example": {
                                    "success": true,
                                    "host": "example.com",
                                    "ip": "23.88.96.112",
                                    "port": 2000,
                                    "code": 200,
                                    "status_short": "UP",
                                    "status_long": "Site is up",
                                    "response_time": 1.542047
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/reputationchecker": {
            "get": {
                "tags": [
                    "Security"
                ],
                "summary": "URL Reputation Checker",
                "description": "Checks a URL against multiple blacklists to determine if it is considered unsafe.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "url",
                        "in": "query",
                        "description": "The URL to check the reputation of.",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "https://example.com"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The reputation status of the URL.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "detections": {
                                            "type": "string"
                                        },
                                        "message": {
                                            "type": "string"
                                        }
                                    }
                                },
                                "example": {
                                    "success": true,
                                    "detections": "None",
                                    "message": "URL is safe"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/getheaders": {
            "get": {
                "tags": [
                    "Domain & IP Tools"
                ],
                "summary": "Get HTTP Headers",
                "description": "Fetches the HTTP response headers from a given host.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "host",
                        "in": "query",
                        "description": "The hostname to fetch headers from.",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "example.com"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The raw and split HTTP headers.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "result": {
                                            "type": "string"
                                        },
                                        "splitted_result": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "success": true,
                                    "result": "HTTP/1.1 200 OK<br>Content-Type: text/html<br>...",
                                    "splitted_result": [
                                        "HTTP/1.1 200 OK",
                                        "Content-Type: text/html"
                                    ]
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/linkbackup": {
            "get": {
                "tags": [
                    "Web Utilities"
                ],
                "summary": "Link Backup (Archive.org)",
                "description": "Finds or creates a backup of a URL on the Internet Archive (Wayback Machine).",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "url",
                        "in": "query",
                        "description": "The URL to backup or find a backup for.",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "https://example.com"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "A URL to the archived version of the page.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "url": {
                                            "type": "string",
                                            "format": "uri"
                                        }
                                    }
                                },
                                "example": {
                                    "success": true,
                                    "url": "http://web.archive.org/20250622151837/https://www.example.com/"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/dictionary": {
            "get": {
                "tags": [
                    "Data & Content"
                ],
                "summary": "Dictionary Lookup",
                "description": "Provides a definition and example sentence for a given word.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "word",
                        "in": "query",
                        "description": "The word to look up.",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "car"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The definition and example for the word.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "definition": {
                                            "type": "string"
                                        },
                                        "example": {
                                            "type": "string"
                                        }
                                    }
                                },
                                "example": {
                                    "success": true,
                                    "definition": "LOOK AT THIS DUDE WHY IS HE LOOKING UP WHAT IS A CAR",
                                    "example": "A CAR HAS WHEELS"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/emailvalidator": {
            "get": {
                "tags": [
                    "Validation Tools"
                ],
                "summary": "Email Validator",
                "description": "Checks if an email address is valid and deliverable.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "email",
                        "in": "query",
                        "description": "The email address to validate.",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "email",
                            "example": "test@outlook.com"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Validation result of the email.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "exists": {
                                            "type": "boolean"
                                        },
                                        "result": {
                                            "type": "string"
                                        }
                                    }
                                },
                                "example": {
                                    "success": true,
                                    "exists": true,
                                    "result": "Email exists."
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/disposablemailchecker": {
            "get": {
                "tags": [
                    "Validation Tools"
                ],
                "summary": "Disposable Email Checker",
                "description": "Checks if an email address belongs to a disposable (temporary) email service provider.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "email",
                        "in": "query",
                        "description": "The email address to check.",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "email",
                            "example": "test@outlook.com"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Result indicating if the email is disposable.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "disposable": {
                                            "type": "boolean"
                                        },
                                        "status": {
                                            "type": "string"
                                        }
                                    }
                                },
                                "example": {
                                    "success": true,
                                    "disposable": true,
                                    "status": "disposable"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/ipvalidator": {
            "get": {
                "tags": [
                    "Validation Tools"
                ],
                "summary": "IP Address Validator",
                "description": "Checks if a given string is a valid IPv4 or IPv6 address.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "ip",
                        "in": "query",
                        "description": "The IP address string to validate.",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "exmaple": "1.1.1.1"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Validation result of the IP address.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "valid_ip": {
                                            "type": "boolean"
                                        },
                                        "result": {
                                            "type": "string"
                                        }
                                    }
                                },
                                "example": {
                                    "success": true,
                                    "valid_ip": true,
                                    "result": "Valid IP address"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/torchecker": {
            "get": {
                "tags": [
                    "Security"
                ],
                "summary": "Tor Exit Node Checker",
                "description": "Checks if a given IP address is a known Tor exit node.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "ip",
                        "in": "query",
                        "description": "The IP address to check.",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "1.1.1.1"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Tor detection result.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "tor_detected": {
                                            "type": "boolean"
                                        },
                                        "status": {
                                            "type": "string"
                                        }
                                    }
                                },
                                "example": {
                                    "success": true,
                                    "tor_detected": false,
                                    "status": "No TOR detected!"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/translate": {
            "get": {
                "tags": [
                    "Data & Content"
                ],
                "summary": "Translate Text",
                "description": "Translates text from one language to another.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "text",
                        "in": "query",
                        "description": "The text to translate.",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "Hello world"
                        }
                    },
                    {
                        "name": "tolanguage",
                        "in": "query",
                        "description": "The ISO 639-1 code of the target language (e.g., EN, ES, FR).",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "ES"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The translation result.",
                        "content": {
                            "application/json": {
                                "example": {
                                    "success": true,
                                    "original": "Hello World",
                                    "translated": "Hello World",
                                    "detected_lang": "en",
                                    "to_lang": "en"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/randomperson": {
            "get": {
                "tags": [
                    "Data & Content"
                ],
                "summary": "Random Person Generator",
                "description": "Generates a random identity with name, address, email, etc.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "gender",
                        "in": "query",
                        "description": "Specify `male`, `female`, or `all`.",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "male",
                                "female",
                                "all"
                            ],
                            "example": "all"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Details of a randomly generated person.",
                        "content": {
                            "application/json": {
                                "example": {
                                    "success": true,
                                    "gender": "Male",
                                    "name": "Krasun Bernackiy",
                                    "age": "27",
                                    "street": "Provulok Vasnecova 3195",
                                    "city": "Rozdilna",
                                    "country": "UA",
                                    "email": "krasun.bernackiy@example.com"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/youtubedetails": {
            "get": {
                "tags": [
                    "Data & Content"
                ],
                "summary": "YouTube Video Details",
                "description": "Retrieves details for a specific YouTube video by its ID.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "videoid",
                        "in": "query",
                        "description": "The ID of the YouTube video (e.g., Urdlvw0SSEc).",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "Urdlvw0SSEc"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Detailed information about the YouTube video.",
                        "content": {
                            "application/json": {
                                "example": {
                                    "success": true,
                                    "id": "Urdlvw0SSEc",
                                    "title": "Alicia Keys - Fallin' (Official HD Video)",
                                    "uploader": "aliciakeysVEVO",
                                    "duration": "207",
                                    "views": "363.503.212",
                                    "likes": "2.276.563"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/iplogger": {
            "get": {
                "tags": [
                    "Security"
                ],
                "summary": "View IP Loggers",
                "description": "Retrieves a list of all active IP loggers associated with your key.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "action",
                        "in": "query",
                        "description": "The action to perform. Must be `viewloggers`.",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "viewloggers"
                            ],
                            "example": "viewloggers"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "A list of your configured IP loggers.",
                        "content": {
                            "application/json": {
                                "example": {
                                    "success": true,
                                    "loggers": [
                                        {
                                            "type": "gyazo",
                                            "token": "243d32c9",
                                            "logger": "https://gyazo.nl/...",
                                            "logs": "https://api.c99.nl/iplogger?key=..."
                                        },
                                        {
                                            "type": "imgur",
                                            "token": "493201f0",
                                            "logger": "https://i.imgur.lt/...",
                                            "logs": "https://api.c99.nl/iplogger?key=..."
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/iplogger/logs": {
            "get": {
                "tags": [
                    "Security"
                ],
                "summary": "View IP Logger Logs",
                "description": "Retrieves the logs for a specific IP logger.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "action",
                        "in": "query",
                        "description": "The action to perform. Must be `viewlogs`.",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "viewlogs"
                            ],
                            "example": "viewlogs"
                        }
                    },
                    {
                        "name": "type",
                        "in": "query",
                        "description": "The type of the logger (e.g., gyazo, imgur).",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "gyazo"
                        }
                    },
                    {
                        "name": "token",
                        "in": "query",
                        "description": "The unique token of the logger.",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "243d32c9"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "A list of log entries for the specified logger.",
                        "content": {
                            "application/json": {
                                "example": {
                                    "success": true,
                                    "url": "https://gyazo.nl/yjJed1kMYB8as3iVZHoAu2FxLtPwTCbc",
                                    "token": "243d32c9",
                                    "logs_count": 1,
                                    "logs": [
                                        {
                                            "code": "yjJed1kMYB8as3iVZHoAu2FxLtPwTCbc",
                                            "ip": "185.65.134.197",
                                            "date": "2025-06-22 17:21:57",
                                            "useragent": "Mozilla/5.0 ...",
                                            "referrer": "",
                                            "url": "https://gyazo.nl/{code}"
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/bitcoinbalance": {
            "get": {
                "tags": [
                    "Financial"
                ],
                "summary": "Bitcoin Address Balance",
                "description": "Checks the balance of a given Bitcoin address.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "address",
                        "in": "query",
                        "description": "The Bitcoin address to check.",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "1C99NLhJ5NDFC6R6Uw2pgBUrJkQJEBDTDc"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The balance and transaction details of the Bitcoin address.",
                        "content": {
                            "application/json": {
                                "example": {
                                    "success": true,
                                    "address": "1C99NLhJ5NDFC6R6Uw2pgBUrJkQJEBDTDc",
                                    "balance": 0,
                                    "total_transactions": 103,
                                    "total_received": 0.24833018
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/currency": {
            "get": {
                "tags": [
                    "Financial"
                ],
                "summary": "Currency Converter",
                "description": "Converts an amount from one currency to another.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "amount",
                        "in": "query",
                        "description": "The amount of money to convert.",
                        "required": true,
                        "schema": {
                            "type": "number",
                            "example": "150"
                        }
                    },
                    {
                        "name": "from",
                        "in": "query",
                        "description": "The source currency code (e.g., USD).",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "USD"
                        }
                    },
                    {
                        "name": "to",
                        "in": "query",
                        "description": "The target currency code (e.g., EUR).",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "EUR"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The converted currency amount.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "amount": {
                                            "type": "number"
                                        }
                                    }
                                },
                                "example": {
                                    "success": true,
                                    "amount": 106.729191
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/currencyrates": {
            "get": {
                "tags": [
                    "Financial"
                ],
                "summary": "Currency Rates",
                "description": "Gets the latest exchange rates for a given source currency.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "source",
                        "in": "query",
                        "description": "The source currency code (e.g., USD).",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "USD"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "A list of exchange rates.",
                        "content": {
                            "application/json": {
                                "example": {
                                    "success": true,
                                    "source": "USD",
                                    "data": {
                                        "AED": 3.6725,
                                        "AFN": 70.987935,
                                        "ALL": 85.016971
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/currencies": {
            "get": {
                "tags": [
                    "Financial"
                ],
                "summary": "Currency Rates",
                "description": "Gets the latest exchange rates for a given source currency (Fiat and Crypto)",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "amount",
                        "in": "query",
                        "description": "The amount to convert (used with 'from' and 'to').",
                        "required": false,
                        "schema": {
                            "type": "number",
                            "default": 1,
                            "example": 50.5
                        }
                    },
                    {
                        "name": "from",
                        "in": "query",
                        "description": "The currency code to convert from (e.g., BTC, USD).",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "BTC"
                        }
                    },
                    {
                        "name": "to",
                        "in": "query",
                        "description": "The currency code to convert to (e.g., EUR, USD).",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "USD"
                        }
                    },
                    {
                        "name": "source",
                        "in": "query",
                        "description": "The base currency for the rates list. Defaults to USD.",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "default": "USD",
                            "example": "EUR"
                        }
                    },
                    {
                        "name": "type",
                        "in": "query",
                        "description": "Filter results by type.",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "all",
                                "fiat",
                                "crypto"
                            ],
                            "default": "all"
                        }
                    },
                    {
                        "name": "detailed",
                        "in": "query",
                        "description": "Set to 'true' to get full crypto metadata. Only shows crypto.",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "true",
                                "false"
                            ],
                            "default": "false"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "boolean",
                            "default": true
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful response. Format depends on parameters used.",
                        "content": {
                            "application/json": {
                                "examples": {
                                    "Conversion": {
                                        "summary": "Conversion between two currencies",
                                        "value": {
                                            "success": true,
                                            "amount": 91272.45,
                                            "from": "BTC",
                                            "to": "USD"
                                        }
                                    },
                                    "RatesList": {
                                        "summary": "Standard rates list (Default)",
                                        "value": {
                                            "success": true,
                                            "source": "USD",
                                            "data": {
                                                "BTC": 91272,
                                                "EUR": 0.9421,
                                                "GBP": 0.7845,
                                                "ETH": 3111.51
                                            }
                                        }
                                    },
                                    "DetailedCrypto": {
                                        "summary": "Detailed crypto list (detailed=true)",
                                        "value": {
                                            "success": true,
                                            "data": [
                                                {
                                                    "rank": 1,
                                                    "name": "Bitcoin",
                                                    "symbol": "BTC",
                                                    "price_usd": 91271.96327981287,
                                                    "volume_24h_usd": 27991127756.62577,
                                                    "pricechange_24h": -2.1,
                                                    "marketcap_usd": 1823464049038.919,
                                                    "circulating_supply": 19978359,
                                                    "max_supply": 19978359,
                                                    "last_update": "2026-01-20 13:10:45"
                                                }
                                            ]
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response when currency codes are missing or invalid.",
                        "content": {
                            "application/json": {
                                "example": {
                                    "success": false,
                                    "error": "BTC doesn't seem to exist."
                                }
                            }
                        }
                    }
                }
            }
        },
        "/weather": {
            "get": {
                "tags": [
                    "Data & Content"
                ],
                "summary": "Weather Information",
                "description": "Gets the current weather conditions for a specified location.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "location",
                        "in": "query",
                        "description": "The city name to get weather for (e.g., Miami).",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "Miami"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Current weather data for the location.",
                        "content": {
                            "application/json": {
                                "example": {
                                    "success": true,
                                    "city": "Miami",
                                    "country": "US",
                                    "temperature": "30.94 (C)",
                                    "humidity": 75,
                                    "weather": "Clouds",
                                    "description": "broken clouds"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/qrgenerator": {
            "get": {
                "tags": [
                    "Web Utilities"
                ],
                "summary": "QR Code Generator",
                "description": "Generates a QR code image from a given string.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "string",
                        "in": "query",
                        "description": "The text or URL to encode in the QR code.",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "Hello World"
                        }
                    },
                    {
                        "name": "size",
                        "in": "query",
                        "description": "The size of the QR code image in pixels (e.g., 150).",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "example": "150"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "A URL to the generated QR code image.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "base64": {
                                            "type": "string",
                                            "format": "string"
                                        },
                                        "base64_full": {
                                            "type": "string",
                                            "format": "string"
                                        }
                                    }
                                },
                                "example": {
                                    "success": true,
                                    "base64": "PGJyIC8+CjxiPkRlcHJlY2F0ZWQ8L2I+OiAgUVJpbWFnZTo6cG5nKCk6IE9wdGlvbmFsIHBhcmFtZXRlciAkZmlsZW5hbWUgZGVjbGFyZWQgYmVmb3JlIHJlcXVpcmVkIHBhcmFtZXRlciAkZm9yZV9jb2xvciBpcyBpbXBsaWNpdGx5IHRyZWF0ZWQgYXMgYSByZXF1aXJlZCBwYXJhbWV0ZXIgaW4gPGI+L3d3dy93d3dyb290L2FwaS5jOTkubmwvYXBpL3BocHFyY29kZS9xcmltYWdlLnBocDwvYj4gb24gbGluZSA8Yj4zMDwvYj48YnIgLz4KPGJyIC8+CjxiPkRlcHJlY2F0ZWQ8L2I+OiAgUVJpbWFnZTo6cG5nKCk6IE9wdGlvbmFsIHBhcmFtZXRlciAkcGl4ZWxQZXJQb2ludCBkZWNsYXJlZCBiZWZvcmUgcmVxdWlyZWQgcGFyYW1ldGVyICRmb3JlX2NvbG9yIGlzIGltcGxpY2l0bHkgdHJlYXRlZCBhcyBhIHJlcXVpcmVkIHBhcmFtZXRlciBpbiA8Yj4vd3d3L3d3d3Jvb3QvYXBpLmM5OS5ubC9hcGkvcGhwcXJjb2RlL3FyaW1hZ2UucGhwPC9iPiBvbiBsaW5lIDxiPjMwPC9iPjxiciAvPgo8YnIgLz4KPGI+RGVwcmVjYXRlZDwvYj46ICBRUmltYWdlOjpwbmcoKTogT3B0aW9uYWwgcGFyYW1ldGVyICRvdXRlckZyYW1lIGRlY2xhcmVkIGJlZm9yZSByZXF1aXJlZCBwYXJhbWV0ZXIgJGZvcmVfY29sb3IgaXMgaW1wbGljaXRseSB0cmVhdGVkIGFzIGEgcmVxdWlyZWQgcGFyYW1ldGVyIGluIDxiPi93d3cvd3d3cm9vdC9hcGkuYzk5Lm5sL2FwaS9waHBxcmNvZGUvcXJpbWFnZS5waHA8L2I+IG9uIGxpbmUgPGI+MzA8L2I+PGJyIC8+CjxiciAvPgo8Yj5EZXByZWNhdGVkPC9iPjogIFFSaW1hZ2U6OnBuZygpOiBPcHRpb25hbCBwYXJhbWV0ZXIgJHNhdmVhbmRwcmludCBkZWNsYXJlZCBiZWZvcmUgcmVxdWlyZWQgcGFyYW1ldGVyICRmb3JlX2NvbG9yIGlzIGltcGxpY2l0bHkgdHJlYXRlZCBhcyBhIHJlcXVpcmVkIHBhcmFtZXRlciBpbiA8Yj4vd3d3L3d3d3Jvb3QvYXBpLmM5OS5ubC9hcGkvcGhwcXJjb2RlL3FyaW1hZ2UucGhwPC9iPiBvbiBsaW5lIDxiPjMwPC9iPjxiciAvPgo8YnIgLz4KPGI+RGVwcmVjYXRlZDwvYj46ICBRUnZlY3Q6OnN2ZygpOiBPcHRpb25hbCBwYXJhbWV0ZXIgJGZpbGVuYW1lIGRlY2xhcmVkIGJlZm9yZSByZXF1aXJlZCBwYXJhbWV0ZXIgJGZvcmVfY29sb3IgaXMgaW1wbGljaXRseSB0cmVhdGVkIGFzIGEgcmVxdWlyZWQgcGFyYW1ldGVyIGluIDxiPi93d3cvd3d3cm9vdC9hcGkuYzk5Lm5sL2FwaS9waHBxcmNvZGUvcXJ2ZWN0LnBocDwvYj4gb24gbGluZSA8Yj4xNDA8L2I+PGJyIC8+CjxiciAvPgo8Yj5EZXByZWNhdGVkPC9iPjogIFFSdmVjdDo6c3ZnKCk6IE9wdGlvbmFsIHBhcmFtZXRlciAkcGl4ZWxQZXJQb2ludCBkZWNsYXJlZCBiZWZvcmUgcmVxdWlyZWQgcGFyYW1ldGVyICRmb3JlX2NvbG9yIGlzIGltcGxpY2l0bHkgdHJlYXRlZCBhcyBhIHJlcXVpcmVkIHBhcmFtZXRlciBpbiA8Yj4vd3d3L3d3d3Jvb3QvYXBpLmM5OS5ubC9hcGkvcGhwcXJjb2RlL3FydmVjdC5waHA8L2I+IG9uIGxpbmUgPGI+MTQwPC9iPjxiciAvPgo8YnIgLz4KPGI+RGVwcmVjYXRlZDwvYj46ICBRUnZlY3Q6OnN2ZygpOiBPcHRpb25hbCBwYXJhbWV0ZXIgJG91dGVyRnJhbWUgZGVjbGFyZWQgYmVmb3JlIHJlcXVpcmVkIHBhcmFtZXRlciAkZm9yZV9jb2xvciBpcyBpbXBsaWNpdGx5IHRyZWF0ZWQgYXMgYSByZXF1aXJlZCBwYXJhbWV0ZXIgaW4gPGI+L3d3dy93d3dyb290L2FwaS5jOTkubmwvYXBpL3BocHFyY29kZS9xcnZlY3QucGhwPC9iPiBvbiBsaW5lIDxiPjE0MDwvYj48YnIgLz4KPGJyIC8+CjxiPkRlcHJlY2F0ZWQ8L2I+OiAgUVJ2ZWN0OjpzdmcoKTogT3B0aW9uYWwgcGFyYW1ldGVyICRzYXZlYW5kcHJpbnQgZGVjbGFyZWQgYmVmb3JlIHJlcXVpcmVkIHBhcmFtZXRlciAkZm9yZV9jb2xvciBpcyBpbXBsaWNpdGx5IHRyZWF0ZWQgYXMgYSByZXF1aXJlZCBwYXJhbWV0ZXIgaW4gPGI+L3d3dy93d3dyb290L2FwaS5jOTkubmwvYXBpL3BocHFyY29kZS9xcnZlY3QucGhwPC9iPiBvbiBsaW5lIDxiPjE0MDwvYj48YnIgLz4KPGJyIC8+CjxiPkRlcHJlY2F0ZWQ8L2I+OiAgQ3JlYXRpb24gb2YgZHluYW1pYyBwcm9wZXJ0eSBRUmVuY29kZTo6JGNteWsgaXMgZGVwcmVjYXRlZCBpbiA8Yj4vd3d3L3d3d3Jvb3QvYXBpLmM5OS5ubC9hcGkvcGhwcXJjb2RlL3FyZW5jb2RlLnBocDwvYj4gb24gbGluZSA8Yj40MzQ8L2I+PGJyIC8+ColQTkcNChoKAAAADUlIRFIAAAAXAAAAFwEDAAAA2uRG4wAAAAZQTFRF////AAAAVcLTfgAAAAlwSFlzAAAOxAAADsQBlSsOGwAAAF1JREFUCJljYACC+tI/DI6JLAyxkiUMsb5A7FkC5teH/mFgMGFg4NR4w8BztIch8uoXhgzVNwzJBWsYGPxyGOotPRgcTTkYYrlVGGIz1jDEsk1hcNRcwFAvtQNkLABIWRd+k/oT/gAAAABJRU5ErkJggg==",
                                    "base64_full": "data:image/png;base64,PGJyIC8+CjxiPkRlcHJlY2F0ZWQ8L2I+OiAgUVJpbWFnZTo6cG5nKCk6IE9wdGlvbmFsIHBhcmFtZXRlciAkZmlsZW5hbWUgZGVjbGFyZWQgYmVmb3JlIHJlcXVpcmVkIHBhcmFtZXRlciAkZm9yZV9jb2xvciBpcyBpbXBsaWNpdGx5IHRyZWF0ZWQgYXMgYSByZXF1aXJlZCBwYXJhbWV0ZXIgaW4gPGI+L3d3dy93d3dyb290L2FwaS5jOTkubmwvYXBpL3BocHFyY29kZS9xcmltYWdlLnBocDwvYj4gb24gbGluZSA8Yj4zMDwvYj48YnIgLz4KPGJyIC8+CjxiPkRlcHJlY2F0ZWQ8L2I+OiAgUVJpbWFnZTo6cG5nKCk6IE9wdGlvbmFsIHBhcmFtZXRlciAkcGl4ZWxQZXJQb2ludCBkZWNsYXJlZCBiZWZvcmUgcmVxdWlyZWQgcGFyYW1ldGVyICRmb3JlX2NvbG9yIGlzIGltcGxpY2l0bHkgdHJlYXRlZCBhcyBhIHJlcXVpcmVkIHBhcmFtZXRlciBpbiA8Yj4vd3d3L3d3d3Jvb3QvYXBpLmM5OS5ubC9hcGkvcGhwcXJjb2RlL3FyaW1hZ2UucGhwPC9iPiBvbiBsaW5lIDxiPjMwPC9iPjxiciAvPgo8YnIgLz4KPGI+RGVwcmVjYXRlZDwvYj46ICBRUmltYWdlOjpwbmcoKTogT3B0aW9uYWwgcGFyYW1ldGVyICRvdXRlckZyYW1lIGRlY2xhcmVkIGJlZm9yZSByZXF1aXJlZCBwYXJhbWV0ZXIgJGZvcmVfY29sb3IgaXMgaW1wbGljaXRseSB0cmVhdGVkIGFzIGEgcmVxdWlyZWQgcGFyYW1ldGVyIGluIDxiPi93d3cvd3d3cm9vdC9hcGkuYzk5Lm5sL2FwaS9waHBxcmNvZGUvcXJpbWFnZS5waHA8L2I+IG9uIGxpbmUgPGI+MzA8L2I+PGJyIC8+CjxiciAvPgo8Yj5EZXByZWNhdGVkPC9iPjogIFFSaW1hZ2U6OnBuZygpOiBPcHRpb25hbCBwYXJhbWV0ZXIgJHNhdmVhbmRwcmludCBkZWNsYXJlZCBiZWZvcmUgcmVxdWlyZWQgcGFyYW1ldGVyICRmb3JlX2NvbG9yIGlzIGltcGxpY2l0bHkgdHJlYXRlZCBhcyBhIHJlcXVpcmVkIHBhcmFtZXRlciBpbiA8Yj4vd3d3L3d3d3Jvb3QvYXBpLmM5OS5ubC9hcGkvcGhwcXJjb2RlL3FyaW1hZ2UucGhwPC9iPiBvbiBsaW5lIDxiPjMwPC9iPjxiciAvPgo8YnIgLz4KPGI+RGVwcmVjYXRlZDwvYj46ICBRUnZlY3Q6OnN2ZygpOiBPcHRpb25hbCBwYXJhbWV0ZXIgJGZpbGVuYW1lIGRlY2xhcmVkIGJlZm9yZSByZXF1aXJlZCBwYXJhbWV0ZXIgJGZvcmVfY29sb3IgaXMgaW1wbGljaXRseSB0cmVhdGVkIGFzIGEgcmVxdWlyZWQgcGFyYW1ldGVyIGluIDxiPi93d3cvd3d3cm9vdC9hcGkuYzk5Lm5sL2FwaS9waHBxcmNvZGUvcXJ2ZWN0LnBocDwvYj4gb24gbGluZSA8Yj4xNDA8L2I+PGJyIC8+CjxiciAvPgo8Yj5EZXByZWNhdGVkPC9iPjogIFFSdmVjdDo6c3ZnKCk6IE9wdGlvbmFsIHBhcmFtZXRlciAkcGl4ZWxQZXJQb2ludCBkZWNsYXJlZCBiZWZvcmUgcmVxdWlyZWQgcGFyYW1ldGVyICRmb3JlX2NvbG9yIGlzIGltcGxpY2l0bHkgdHJlYXRlZCBhcyBhIHJlcXVpcmVkIHBhcmFtZXRlciBpbiA8Yj4vd3d3L3d3d3Jvb3QvYXBpLmM5OS5ubC9hcGkvcGhwcXJjb2RlL3FydmVjdC5waHA8L2I+IG9uIGxpbmUgPGI+MTQwPC9iPjxiciAvPgo8YnIgLz4KPGI+RGVwcmVjYXRlZDwvYj46ICBRUnZlY3Q6OnN2ZygpOiBPcHRpb25hbCBwYXJhbWV0ZXIgJG91dGVyRnJhbWUgZGVjbGFyZWQgYmVmb3JlIHJlcXVpcmVkIHBhcmFtZXRlciAkZm9yZV9jb2xvciBpcyBpbXBsaWNpdGx5IHRyZWF0ZWQgYXMgYSByZXF1aXJlZCBwYXJhbWV0ZXIgaW4gPGI+L3d3dy93d3dyb290L2FwaS5jOTkubmwvYXBpL3BocHFyY29kZS9xcnZlY3QucGhwPC9iPiBvbiBsaW5lIDxiPjE0MDwvYj48YnIgLz4KPGJyIC8+CjxiPkRlcHJlY2F0ZWQ8L2I+OiAgUVJ2ZWN0OjpzdmcoKTogT3B0aW9uYWwgcGFyYW1ldGVyICRzYXZlYW5kcHJpbnQgZGVjbGFyZWQgYmVmb3JlIHJlcXVpcmVkIHBhcmFtZXRlciAkZm9yZV9jb2xvciBpcyBpbXBsaWNpdGx5IHRyZWF0ZWQgYXMgYSByZXF1aXJlZCBwYXJhbWV0ZXIgaW4gPGI+L3d3dy93d3dyb290L2FwaS5jOTkubmwvYXBpL3BocHFyY29kZS9xcnZlY3QucGhwPC9iPiBvbiBsaW5lIDxiPjE0MDwvYj48YnIgLz4KPGJyIC8+CjxiPkRlcHJlY2F0ZWQ8L2I+OiAgQ3JlYXRpb24gb2YgZHluYW1pYyBwcm9wZXJ0eSBRUmVuY29kZTo6JGNteWsgaXMgZGVwcmVjYXRlZCBpbiA8Yj4vd3d3L3d3d3Jvb3QvYXBpLmM5OS5ubC9hcGkvcGhwcXJjb2RlL3FyZW5jb2RlLnBocDwvYj4gb24gbGluZSA8Yj40MzQ8L2I+PGJyIC8+ColQTkcNChoKAAAADUlIRFIAAAAXAAAAFwEDAAAA2uRG4wAAAAZQTFRF////AAAAVcLTfgAAAAlwSFlzAAAOxAAADsQBlSsOGwAAAF1JREFUCJljYACC+tI/DI6JLAyxkiUMsb5A7FkC5teH/mFgMGFg4NR4w8BztIch8uoXhgzVNwzJBWsYGPxyGOotPRgcTTkYYrlVGGIz1jDEsk1hcNRcwFAvtQNkLABIWRd+k/oT/gAAAABJRU5ErkJggg=="
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/passwordgenerator": {
            "get": {
                "tags": [
                    "Generators"
                ],
                "summary": "Password Generator",
                "description": "Generates a random, strong password with customizable rules.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "length",
                        "in": "query",
                        "description": "The desired length of the password.",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "example": "15"
                        }
                    },
                    {
                        "name": "include",
                        "in": "query",
                        "description": "Comma-separated list of character types to include: `numbers`, `letters`, `chars`.",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "numbers,letters"
                        }
                    },
                    {
                        "name": "customlist",
                        "in": "query",
                        "description": "A custom set of characters to generate the password from.",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "abc"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The generated password.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "output": {
                                            "type": "string"
                                        }
                                    }
                                },
                                "example": {
                                    "success": true,
                                    "output": "bcdbcaeahf"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/licensekeygenerator": {
            "get": {
                "tags": [
                    "Generators"
                ],
                "summary": "License Key Generator",
                "description": "Generates license keys based on a custom template.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "template",
                        "in": "query",
                        "description": "The template for the key. Use `?` for a random alphanumeric character. (e.g., ?????-?????-?????-?????).",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "?????-?????-?????-?????"
                        }
                    },
                    {
                        "name": "amount",
                        "in": "query",
                        "description": "The number of keys to generate.",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "example": "10"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "A list of generated license keys.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "keys": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "success": true,
                                    "keys": [
                                        "XK93X-XKL2Q-3QYCJ-SE5DJ"
                                    ]
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/randomnumber": {
            "get": {
                "tags": [
                    "Generators"
                ],
                "summary": "Random Number Generator",
                "description": "Generates a random number of a specified length.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "length",
                        "in": "query",
                        "description": "The number of digits for the random number.",
                        "required": true,
                        "schema": {
                            "type": "integer",
                            "example": "10"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The generated random number as a string.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "output": {
                                            "type": "string"
                                        }
                                    }
                                },
                                "example": {
                                    "success": true,
                                    "output": "5367778141"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/gif": {
            "get": {
                "tags": [
                    "Data & Content"
                ],
                "summary": "Search GIFs",
                "description": "Searches for and returns a list of GIFs based on a keyword.",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "Your API key.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "keyword",
                        "in": "query",
                        "description": "The keyword to search for.",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "bean"
                        }
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "default": true,
                        "description": "Set to receive the response in JSON format.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "A list of GIF URLs matching the keyword.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "images": {
                                            "type": "array",
                                            "items": {
                                                "type": "string",
                                                "format": "uri"
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "success": true,
                                    "images": [
                                        "https://gif.c99.nl/KWhmkHq7zVkOc.gif",
                                        "https://gif.c99.nl/dv78V39sfMssrjpHWO.gif"
                                    ]
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Error response.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "Error": {
                "type": "object",
                "properties": {
                    "success": {
                        "type": "boolean",
                        "description": "Indicates the request failed.",
                        "example": false
                    },
                    "error": {
                        "type": "string",
                        "description": "A message describing the error.",
                        "example": "Invalid API key or parameter."
                    }
                },
                "required": [
                    "success",
                    "error"
                ]
            }
        }
    }
}