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("user@example.com"))
# 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("user@example.com")
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.
1 maintainer
Metadata
1 maintainer
Release files for kiprio 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| kiprio-0.1.0.tar.gz | 8.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| kiprio-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 19.2 kB
Release files / kiprio-0.1.0.tar.gz
| Download URL | kiprio-0.1.0.tar.gz |
|---|---|
| Size | 8.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
73a09d14204ed93209249bb0291c0885c122244fc942256c2c8fea55f028bbb9
|
|
BLAKE2b-256 checksum How to use checksums |
12f894cf3c187e439e3a9becff0a63eb551802ee5152a1208b8f27e96cb7ca19
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Release files / kiprio-0.1.0-py3-none-any.whl
| Download URL | kiprio-0.1.0-py3-none-any.whl |
|---|---|
| Size | 11.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
28c2065552f1c4fc1f085ec5aa20d74183404f954bf2cdf5a3e2aa52b35d60cb
|
|
BLAKE2b-256 checksum How to use checksums |
85d3819e2890688872d78fc8acedefb2d650d9cbe0399dd6d28433c189ae71f6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
