kiprio 0.1.0

Python SDK for kiprio.com — email validation, DNS, OCR, QR, translation, sentiment, screenshot, and 30+ more APIs.

kiprio

Python SDK for kiprio.com — 30+ utility APIs for developers: email validation, DNS, OCR, QR codes, translation, sentiment analysis, screenshots, and more.

Install

pip install kiprio

Quick start

import kiprio

client = kiprio.Client(api_key="kip_your_key_here")
# Or set KIPRIO_API_KEY environment variable

# Email validation
print(client.email_validate("[e-mail]"))

# DNS lookup
print(client.dns_lookup("example.com", "MX"))

# OCR from URL
print(client.ocr("https://example.com/image.png"))

# QR code generation
result = client.qr("https://kiprio.com")
# result["image"] contains base64-encoded PNG

# Translation
print(client.translate("Hello world", "es"))

Async usage

import kiprio, asyncio

async def main():
    async with kiprio.AsyncClient(api_key="kip_...") as client:
        result = await client.email_validate("[e-mail]")
        print(result)

asyncio.run(main())

Available methods

Method	Endpoint	Description
email_validate(email)	POST /v1/email-validate	MX + SMTP deliverability check
dns_lookup(domain, type)	GET /v1/dns-lookup	DNS record lookup
whois(domain)	POST /v1/whois	WHOIS registration data
ssl_check(domain)	POST /v1/ssl-check	SSL certificate validity
ip_lookup(ip)	POST /v1/ip-lookup	IP geolocation + threat score
screenshot(url)	POST /v1/screenshot	Web page screenshot (PNG)
ocr(url)	POST /v1/ocr	Image text extraction
qr(data)	POST /v1/qr	QR code generation
hash_hex(text, algo)	POST /v1/hash/hex	Hash to hex digest
hash_base64(text, algo)	POST /v1/hash/base64	Hash to base64 digest
uuid(version, count)	GET /v1/uuid	UUID generation
translate(text, target)	POST /v1/translate	Text translation
detect_language(text)	POST /v1/translate/detect	Language detection
sentiment(text)	POST /v1/sentiment	Sentiment analysis
grammar(text)	POST /v1/text	Grammar and style check
summarize(text)	POST /v1/summarize	Text summarisation
tldr(url)	POST /v1/tldr	URL to 3-sentence summary
moderation(text)	POST /v1/moderation	Content moderation
readability(url)	POST /v1/readability	Clean article extraction
iban(iban)	POST /v1/iban	IBAN validation
vat(vat_number)	POST /v1/vat	EU VAT validation
phone(number)	POST /v1/phonenumber	Phone number validation
cron_parse(expr)	POST /v1/cron-parse	Cron expression parser
jwt_decode(token)	POST /v1/jwt/decode	JWT decode
jwt_sign(payload, secret)	POST /v1/jwt/sign	JWT sign
jwt_verify(token, secret)	POST /v1/jwt/verify	JWT verify
html_to_pdf(html)	POST /v1/html-to-pdf	HTML to PDF conversion
markdown(text)	POST /v1/markdown	Markdown to HTML
html_to_markdown(html)	POST /v1/html-to-markdown	HTML to Markdown
favicon(url)	POST /v1/favicon	Favicon extraction
geocode(address)	GET /v1/geocode/forward	Forward geocoding
reverse_geocode(lat, lon)	GET /v1/geocode/reverse	Reverse geocoding
carbon(url)	POST /v1/carbon	Website carbon footprint
diff(original, modified)	POST /v1/diff	Text diff
redact(text)	POST /v1/redact	PII redaction
tech_stack(url)	POST /v1/tech-stack	Technology detection
tts(text)	POST /v1/tts	Text to speech
ai_detect(text)	POST /v1/ai-detect	AI content detection
fx(from, to, amount)	GET /v1/fx	Currency conversion
mock(schema)	POST /v1/mock	Mock data generation

Error handling

import kiprio

try:
    client.email_validate("bad")
except kiprio.ValidationError as e:
    print(f"Bad input: {e}")
except kiprio.RateLimitError as e:
    print(f"Rate limited, retry after {e.retry_after}s")
except kiprio.AuthError:
    print("Check your API key")
except kiprio.KiprioError as e:
    print(f"API error {e.status_code}: {e}")

Get a free API key

kiprio.com/signup — free tier, no credit card required.