URL Content Type Detector

A lightweight, efficient utility to determine the content type of any URL with minimal overhead

URL Content Type Detector is a powerful Python library that detects and retrieves the MIME type of any URL using efficient HTTP HEAD requests. It’s designed for production use with comprehensive error handling, URL validation, and robust security features.

Key Highlights:

  • πŸš€ Fast & Efficient - Uses HTTP HEAD requests to minimize bandwidth

  • βœ… Robust Error Handling - Custom exceptions and detailed error messages

  • πŸ”’ URL Validation - Built-in URL validation using industry standards

  • ⏱️ Configurable Timeout - Adjustable timeout with sensible defaults

  • πŸ›‘οΈ Security-First - Optional strict HTTP status code validation

  • πŸ“¦ Lightweight - Zero unnecessary dependencies beyond requests and validators

  • πŸ§ͺ Well-Tested - Comprehensive test suite with pytest

  • 🐍 Python 3.10+ - Modern Python support

Quick Start Example

Get the content type of any URL with just a few lines:

from url_content_type_detector import get_content_type

# Detect content type from URL
content_type = get_content_type("https://example.com/image.png")
print(content_type)  # Output: image/png

# Detect content type from any URL with error handling
try:
    content_type = get_content_type("https://github.com/krsahil8825/url_content_type_detector")
    print(f"Content Type: {content_type}")
except Exception as e:
    print(f"Error: {e}")

Contents & Documentation

Documentation