Endpoint Geolocate an IP address (/v1/ip/lookup) Check if an IP is within a CIDR range (/v1/ip/in-range) Reverse DNS (PTR) lookup (/v1/ip/reverse) Bulk IP geolocation lookup (/v1/ip/bulk) Validate an email address (/v1/email/validate) Parse a user agent string (/v1/useragent/parse) Get current time in a timezone (/v1/timezone) Convert time between timezones (/v1/timezone/convert) Look up DNS records for a domain (/v1/dns/lookup) Look up multiple DNS record types at once (/v1/dns/batch) DNS propagation check across global resolvers (/v1/dns/propagation) Extract metadata and Open Graph tags from a URL (/v1/url-metadata) Domain WHOIS/RDAP lookup (/v1/whois) SSL/Security headers check (/v1/ssl) Inspect HTTP response headers of any URL (/v1/headers) Validate and parse a phone number (/v1/phone) Company/domain info lookup (/v1/company) Validate a freeform address and return structured components with coordinates. (/v1/address/validate) Return address suggestions for partial input. (/v1/address/autocomplete) Monitor DNS record changes for a domain over time. (/v1/dns-monitor/check) Check SSL certificate expiry and issuer for a domain. (/v1/ssl-cert/expiry) Run basic accessibility checks on a webpage. (/v1/accessibility/check) Get the full list of known disposable email domains. (/v1/disposable-email/list) Get a full domain report covering DNS, WHOIS, SSL, headers, and tech stack. (/v1/domain/report) Audit SPF, DMARC, and DKIM records for a domain and return a security grade. (/v1/email-security/report) Extract Open Graph and Twitter Card metadata from a URL. (/v1/social-preview/extract) Get a rich IP profile with geolocation, network, security, and TLS data. (/v1/ip/intelligence) Measure TTFB, total load time, compression, and redirect chain for a URL. (/v1/site/performance) Query DNS records across 5 resolvers and compare results. (/v1/dns/compare) Follow the redirect chain for a URL and return every hop with timing. (/v1/redirect/trace) Get the TLS fingerprint, JA3/JA4 hashes, and connection metadata for the caller. (/v1/tls/fingerprint) Look up an ASN and return organization, country, and RDAP registration data. (/v1/asn/lookup) Estimate CO2 emissions per page view for a URL. (/v1/carbon/estimate) Get current weather conditions for a city or coordinate pair. (/v1/weather/current) Check air quality index and pollutant levels for a coordinate pair. (/v1/air-quality/check) Get the elevation in meters for a coordinate pair or batch of locations. (/v1/elevation/lookup) Check whether a coordinate pair is over water or land. (/v1/on-water/check) Check the page rank and global ranking for a domain. (/v1/page-rank/check) List public holidays for a country and year. (/v1/holidays/list) Look up card scheme, issuer, and country from a BIN/IIN number. (/v1/bin/lookup) Search for registered domains matching a keyword query. (/v1/domain-search/search) Look up metadata for any npm package from the registry. (/v1/npm/info) Get live prices, market caps, and 24h changes for any cryptocurrency. (/v1/exchange/price) Search for cryptocurrencies by name or ticker symbol. (/v1/exchange/search) Estimate the likely age of a person based on their first name. (/v1/age/estimate) Predict the likely gender of a person based on their first name. (/v1/gender/estimate) Predict the most likely countries of origin for a name. (/v1/nationality/estimate) Encode UTF-8 string to Base64. Supports URL-safe encoding. (/v1/base64/encode) Decode Base64 string to UTF-8. (/v1/base64/decode) Pretty-print JSON with configurable indentation. (/v1/json/format) Remove whitespace from JSON. (/v1/json/minify) Validate JSON syntax and report errors. (/v1/json/validate) Diff two JSON documents showing additions, removals, changes. (/v1/json/diff) Convert Markdown to sanitized HTML. (/v1/markdown/to-html) Convert Markdown to plain text. (/v1/markdown/to-text) Convert HTML to plain text preserving structure. (/v1/html-to-text/convert) Generate lorem ipsum placeholder text. (/v1/lorem/generate) Test a regex pattern against a string. (/v1/regex/test) Find and replace with regex. (/v1/regex/replace) Count words, characters, sentences, paragraphs. Estimate reading time. (/v1/text/stats) Convert text to a URL-safe slug. (/v1/text/slugify) Smart text truncation at word boundaries. (/v1/text/truncate) Extract all URLs from text. (/v1/text/extract-urls) Extract all email addresses from text. (/v1/text/extract-emails) Detect the language of text. (/v1/text/language) Convert text between cases (camel, snake, pascal, kebab, etc.). (/v1/text/case) Sanitize HTML by removing dangerous tags and attributes. (/v1/html-sanitize) Convert CSV to JSON array. (/v1/csv/to-json) Convert JSON array to CSV. (/v1/csv/to-csv) Convert XML to JSON. (/v1/xml/to-json) Generate a hash (MD5, SHA-1, SHA-256, SHA-512, etc.). (/v1/hash) Generate multiple hashes at once. (/v1/hash/batch) Generate an HMAC signature. (/v1/hash/hmac) Generate a UUID v4. (/v1/uuid/v4) Generate multiple UUIDs. (/v1/uuid/batch) Generate a ULID. (/v1/uuid/ulid) Validate a UUID. (/v1/uuid/validate) Generate a UUID v7 (time-ordered). (/v1/uuid/v7) URL-encode a string. (/v1/url/encode) URL-decode a string. (/v1/url/decode) Parse a URL into protocol, host, path, query, etc. (/v1/url/parse) Generate secure passwords. (/v1/password/generate) Check password strength and get feedback. (/v1/password/strength) Parse and describe a cron expression in plain English. (/v1/cron/parse) Get next scheduled runs for a cron expression. (/v1/cron/next) Generate random test data (fake identities, addresses, etc.). (/v1/random/data) Convert colors between HEX, RGB, HSL. (/v1/color/convert) Generate a color palette from a base color. (/v1/color/palette) Decode a JWT token without verification. (/v1/jwt/decode) Generate a signed JWT. (/v1/jwt/generate) Compare two texts line by line. (/v1/diff) Deep-compare two JSON objects. (/v1/diff/json) Format a number with locale and style options. (/v1/number/format) Generate a TOTP code. (/v1/totp/generate) Validate a TOTP code. (/v1/totp/validate) Convert between timestamp formats (Unix, ISO, RFC). (/v1/timestamp/convert) Compare two semantic versions. (/v1/semver/compare) Validate a semantic version string. (/v1/semver/validate) Convert YAML to JSON. (/v1/yaml/to-json) Convert JSON to YAML. (/v1/yaml/to-yaml) Evaluate a math expression safely. (/v1/math/evaluate) Convert between units (length, weight, temperature, etc.). (/v1/units/convert) Look up a software license by SPDX identifier. (/v1/license/lookup) Generate an Open Graph image with custom title, description, and colors. (/v1/og/generate) Generate a QR code from any text or URL. (/v1/qr/generate) Generate a placeholder image with custom dimensions and text. (/v1/placeholder) Generate an identicon avatar from a string seed. (/v1/avatar) Extract favicon URLs from any domain. (/v1/favicon) Generate a Code128B barcode from any printable ASCII string. (/v1/barcode) Validate a credit card number using the Luhn algorithm and detect the card brand. (/v1/validate/credit-card) Validate an IBAN and extract its country code, bank code, and check digits. (/v1/validate/iban) Validate a European VAT identification number. (/v1/validate/vat) Encrypt text with AES-256-GCM using a password. (/v1/encrypt/encrypt) Decrypt AES-256-GCM ciphertext using a password. (/v1/encrypt/decrypt) Generate a numeric one-time password with configurable length. (/v1/otp/generate) Check if a password has appeared in known data breaches. (/v1/breach/check) Grade a URL's security headers on a scale from A+ to F. (/v1/security/grade) Check a URL against known phishing and malware databases. (/v1/phishing/check) Create a temporary webhook inbox that captures incoming payloads for 24 hours. (/v1/webhook/inbox/create) List all captured payloads from a webhook inbox. (/v1/webhook/inbox/:id/list) Shorten a URL with an optional custom slug and get a tracked short link. (/v1/short-url/create) Get click count and metadata for a shortened URL. (/v1/short-url/stats) Create a temporary paste with optional syntax highlighting and configurable TTL. (/v1/paste/create) Retrieve a paste by ID with its content, language, and creation timestamp. (/v1/paste/get) Calculate the great-circle distance between two coordinate pairs. (/v1/geo/distance) Convert a street address or place name into latitude/longitude coordinates. (/v1/geo/geocode) Convert latitude/longitude coordinates into a human-readable address. (/v1/geo/reverse) Geocode up to 10 addresses in a single request. (/v1/geo/batch)
Code examples cURL JavaScript TypeScript Python Go
curl -X POST https://api.botoi.com/v1/holidays/list \
-H "Content-Type: application/json" \
-d '{"country":"US","year":2026}'