AD-SearchAPI 2.0.1__tar.gz → 2.0.2__tar.gz

{ad_searchapi-2.0.1 → ad_searchapi-2.0.2}/AD_SearchAPI.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: AD-SearchAPI
-Version: 2.0.1
+Version: 2.0.2
 Summary: A comprehensive Python client library for the Search API with enhanced error handling and balance management
 Home-page: https://github.com/AntiChrist-Coder/search_api_library
 Author: Search API Team
@@ -8,7 +8,7 @@ Author-email: support@search-api.dev
 Project-URL: Bug Reports, https://github.com/AntiChrist-Coder/search_api_library/issues
 Project-URL: Source, https://github.com/AntiChrist-Coder/search_api_library
 Project-URL: Documentation, https://github.com/AntiChrist-Coder/search_api_library/blob/main/README.md
-Keywords: search-api,email-search,phone-search,domain-search,people-search,api-client,balance-management,caching
+Keywords: search-api,email-search,phone-search,domain-search,people-search,api-client,balance-management
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -28,7 +28,6 @@ License-File: LICENSE
 Requires-Dist: requests>=2.31.0
 Requires-Dist: phonenumbers>=8.13.0
 Requires-Dist: python-dateutil>=2.8.2
-Requires-Dist: cachetools>=5.3.0
 Requires-Dist: typing-extensions>=4.7.0
 Requires-Dist: urllib3>=2.0.0
 Provides-Extra: dev
@@ -62,7 +61,6 @@ A comprehensive Python client library for the Search API with enhanced error han
 - **Enhanced Balance Management**: Manual balance checking capabilities
 - **Access Logs Integration**: Retrieve and analyze API access logs
 - **Improved Error Handling**: Comprehensive exception hierarchy with detailed error messages
-- **Advanced Caching**: Configurable response caching with TTL
 - **Better Data Models**: Enhanced data structures with metadata and cost tracking
 - **Context Manager Support**: Automatic resource cleanup
 - **Comprehensive Validation**: Input validation for all search types
@@ -95,8 +93,8 @@ try:
     
     result = client.search_email(
         "example@domain.com",
-        include_house_value=True,
-        include_extra_info=True
+        house_value=True,
+        extra_info=True
     )
     
     print(f"Name: {result.person.name if result.person else 'N/A'}")
@@ -121,9 +119,6 @@ from search_api import SearchAPI, SearchAPIConfig
 config = SearchAPIConfig(
     api_key="your_api_key",
     debug_mode=True,           # Enable debug logging
-    enable_caching=True,       # Enable response caching
-    cache_ttl=1800,           # 30 minutes cache
-    max_cache_size=500,       # Maximum cache entries
     timeout=120,              # 2 minutes timeout
     max_retries=5,           # Retry failed requests
     proxy={                   # Optional proxy
@@ -150,7 +145,7 @@ try:
     # Calculate required credits based on actual search costs
     email_search_cost = 0.0025
     phone_search_cost = 0.0025
-    domain_search_cost = 4.00
+    domain_search_cost = 0.0025
     
     required_credits = 5 * email_search_cost
     if balance.current_balance < required_credits:
@@ -169,11 +164,13 @@ except InsufficientBalanceError as e:
 ### Search Costs:
 - **Email Search**: $0.0025 per search
 - **Phone Search**: $0.0025 per search  
-- **Domain Search**: $4.00 per search
+- **Domain Search**: $0.0025 per search
 
 ### Optional Parameters:
-- **House Value**: Additional $0.0005 per successful lookup
-- **Extra Info**: Additional $0.0020 per successful lookup
+- **House Value (Zestimate)**: Additional $0.0015 per successful lookup
+- **Extra Info**: Additional $0.0015 per successful lookup
+- **Carrier Info**: Additional $0.0005 per successful lookup
+- **TLO Enrichment**: Additional $0.0030 per successful lookup
 
 ## 📊 Access Logs
 
@@ -214,8 +211,10 @@ print(f"Most active IP: {most_active_ip[0]} ({most_active_ip[1]} accesses)")
 ```python
 result = client.search_email(
     "john.doe@example.com",
-    include_house_value=True,
-    include_extra_info=True,
+    house_value=True,
+    extra_info=True,
+    carrier_info=True,
+    tlo_enrichment=True,
     phone_format="international"  # or "national", "e164"
 )
 
@@ -224,6 +223,16 @@ print(f"Valid: {result.email_valid}")
 print(f"Type: {result.email_type}")
 print(f"Search Cost: ${result.search_cost}")
 
+# Access detailed pricing breakdown
+if result.pricing:
+    print(f"Pricing Breakdown:")
+    print(f"  Base Search: ${result.pricing.search_cost:.4f}")
+    print(f"  Extra Info: ${result.pricing.extra_info_cost:.4f}")
+    print(f"  Zestimate: ${result.pricing.zestimate_cost:.4f}")
+    print(f"  Carrier: ${result.pricing.carrier_cost:.4f}")
+    print(f"  TLO Enrichment: ${result.pricing.tlo_enrichment_cost:.4f}")
+    print(f"  Total Cost: ${result.pricing.total_cost:.4f}")
+
 if result.person:
     print(f"Name: {result.person.name}")
     print(f"DOB: {result.person.dob}")
@@ -243,8 +252,10 @@ for phone in result.phone_numbers:
 ```python
 results = client.search_phone(
     "+1234567890",
-    include_house_value=True,
-    include_extra_info=True,
+    house_value=True,
+    extra_info=True,
+    carrier_info=True,
+    tlo_enrichment=True,
     phone_format="international"
 )
 
@@ -252,6 +263,11 @@ for result in results:
     print(f"Phone: {result.phone.number}")
     print(f"Search Cost: ${result.search_cost}")
     
+    # Access detailed pricing breakdown
+    if result.pricing:
+        print(f"  Total Cost: ${result.pricing.total_cost:.4f}")
+        print(f"  Breakdown: {result.pricing}")
+    
     if result.person:
         print(f"Name: {result.person.name}")
         print(f"DOB: {result.person.dob}")
@@ -269,6 +285,10 @@ print(f"Valid: {result.domain_valid}")
 print(f"Total results: {result.total_results}")
 print(f"Search Cost: ${result.search_cost}")
 
+# Access detailed pricing breakdown
+if result.pricing:
+    print(f"Pricing: {result.pricing}")
+
 for email_result in result.results:
     print(f"Email: {email_result.email}")
     print(f"Valid: {email_result.email_valid}")
@@ -316,29 +336,6 @@ except SearchAPIError as e:
     print(f"API error: {e}")
 ```
 
-## 🔄 Caching
-
-The client supports configurable response caching:
-
-```python
-# Enable caching with custom settings
-config = SearchAPIConfig(
-    api_key="your_api_key",
-    enable_caching=True,
-    cache_ttl=3600,      # 1 hour
-    max_cache_size=1000   # Maximum 1000 cached responses
-)
-
-client = SearchAPI(config=config)
-
-# Cache is automatically used for repeated searches
-result1 = client.search_email("test@example.com")  # Cached
-result2 = client.search_email("test@example.com")  # From cache
-
-# Clear cache when needed
-client.clear_cache()
-```
-
 ## 🧹 Context Manager
 
 Use the client as a context manager for automatic resource cleanup:
@@ -426,12 +423,9 @@ class AccessLog:
 |-----------|------|---------|-------------|
 | `api_key` | str | Required | Your API key |
 | `base_url` | str | `"https://search-api.dev/search.php"` | API base URL |
-| `max_retries` | int | `3` | Maximum retry attempts |
+| `max_retries` | int | `1` | Maximum retry attempts |
 | `timeout` | int | `90` | Request timeout in seconds |
 | `debug_mode` | bool | `False` | Enable debug logging |
-| `enable_caching` | bool | `True` | Enable response caching |
-| `cache_ttl` | int | `3600` | Cache time-to-live in seconds |
-| `max_cache_size` | int | `1000` | Maximum cache entries |
 | `proxy` | Dict | `None` | Proxy configuration |
 | `user_agent` | str | Chrome UA | Custom user agent |
 

{ad_searchapi-2.0.1 → ad_searchapi-2.0.2}/AD_SearchAPI.egg-info/requires.txt

@@ -1,7 +1,6 @@
 requests>=2.31.0
 phonenumbers>=8.13.0
 python-dateutil>=2.8.2
-cachetools>=5.3.0
 typing-extensions>=4.7.0
 urllib3>=2.0.0
 

{ad_searchapi-2.0.1 → ad_searchapi-2.0.2}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Search API Team
+Copyright (c) 2025 Search API Team
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{ad_searchapi-2.0.1 → ad_searchapi-2.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: AD-SearchAPI
-Version: 2.0.1
+Version: 2.0.2
 Summary: A comprehensive Python client library for the Search API with enhanced error handling and balance management
 Home-page: https://github.com/AntiChrist-Coder/search_api_library
 Author: Search API Team
@@ -8,7 +8,7 @@ Author-email: support@search-api.dev
 Project-URL: Bug Reports, https://github.com/AntiChrist-Coder/search_api_library/issues
 Project-URL: Source, https://github.com/AntiChrist-Coder/search_api_library
 Project-URL: Documentation, https://github.com/AntiChrist-Coder/search_api_library/blob/main/README.md
-Keywords: search-api,email-search,phone-search,domain-search,people-search,api-client,balance-management,caching
+Keywords: search-api,email-search,phone-search,domain-search,people-search,api-client,balance-management
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -28,7 +28,6 @@ License-File: LICENSE
 Requires-Dist: requests>=2.31.0
 Requires-Dist: phonenumbers>=8.13.0
 Requires-Dist: python-dateutil>=2.8.2
-Requires-Dist: cachetools>=5.3.0
 Requires-Dist: typing-extensions>=4.7.0
 Requires-Dist: urllib3>=2.0.0
 Provides-Extra: dev
@@ -62,7 +61,6 @@ A comprehensive Python client library for the Search API with enhanced error han
 - **Enhanced Balance Management**: Manual balance checking capabilities
 - **Access Logs Integration**: Retrieve and analyze API access logs
 - **Improved Error Handling**: Comprehensive exception hierarchy with detailed error messages
-- **Advanced Caching**: Configurable response caching with TTL
 - **Better Data Models**: Enhanced data structures with metadata and cost tracking
 - **Context Manager Support**: Automatic resource cleanup
 - **Comprehensive Validation**: Input validation for all search types
@@ -95,8 +93,8 @@ try:
     
     result = client.search_email(
         "example@domain.com",
-        include_house_value=True,
-        include_extra_info=True
+        house_value=True,
+        extra_info=True
     )
     
     print(f"Name: {result.person.name if result.person else 'N/A'}")
@@ -121,9 +119,6 @@ from search_api import SearchAPI, SearchAPIConfig
 config = SearchAPIConfig(
     api_key="your_api_key",
     debug_mode=True,           # Enable debug logging
-    enable_caching=True,       # Enable response caching
-    cache_ttl=1800,           # 30 minutes cache
-    max_cache_size=500,       # Maximum cache entries
     timeout=120,              # 2 minutes timeout
     max_retries=5,           # Retry failed requests
     proxy={                   # Optional proxy
@@ -150,7 +145,7 @@ try:
     # Calculate required credits based on actual search costs
     email_search_cost = 0.0025
     phone_search_cost = 0.0025
-    domain_search_cost = 4.00
+    domain_search_cost = 0.0025
     
     required_credits = 5 * email_search_cost
     if balance.current_balance < required_credits:
@@ -169,11 +164,13 @@ except InsufficientBalanceError as e:
 ### Search Costs:
 - **Email Search**: $0.0025 per search
 - **Phone Search**: $0.0025 per search  
-- **Domain Search**: $4.00 per search
+- **Domain Search**: $0.0025 per search
 
 ### Optional Parameters:
-- **House Value**: Additional $0.0005 per successful lookup
-- **Extra Info**: Additional $0.0020 per successful lookup
+- **House Value (Zestimate)**: Additional $0.0015 per successful lookup
+- **Extra Info**: Additional $0.0015 per successful lookup
+- **Carrier Info**: Additional $0.0005 per successful lookup
+- **TLO Enrichment**: Additional $0.0030 per successful lookup
 
 ## 📊 Access Logs
 
@@ -214,8 +211,10 @@ print(f"Most active IP: {most_active_ip[0]} ({most_active_ip[1]} accesses)")
 ```python
 result = client.search_email(
     "john.doe@example.com",
-    include_house_value=True,
-    include_extra_info=True,
+    house_value=True,
+    extra_info=True,
+    carrier_info=True,
+    tlo_enrichment=True,
     phone_format="international"  # or "national", "e164"
 )
 
@@ -224,6 +223,16 @@ print(f"Valid: {result.email_valid}")
 print(f"Type: {result.email_type}")
 print(f"Search Cost: ${result.search_cost}")
 
+# Access detailed pricing breakdown
+if result.pricing:
+    print(f"Pricing Breakdown:")
+    print(f"  Base Search: ${result.pricing.search_cost:.4f}")
+    print(f"  Extra Info: ${result.pricing.extra_info_cost:.4f}")
+    print(f"  Zestimate: ${result.pricing.zestimate_cost:.4f}")
+    print(f"  Carrier: ${result.pricing.carrier_cost:.4f}")
+    print(f"  TLO Enrichment: ${result.pricing.tlo_enrichment_cost:.4f}")
+    print(f"  Total Cost: ${result.pricing.total_cost:.4f}")
+
 if result.person:
     print(f"Name: {result.person.name}")
     print(f"DOB: {result.person.dob}")
@@ -243,8 +252,10 @@ for phone in result.phone_numbers:
 ```python
 results = client.search_phone(
     "+1234567890",
-    include_house_value=True,
-    include_extra_info=True,
+    house_value=True,
+    extra_info=True,
+    carrier_info=True,
+    tlo_enrichment=True,
     phone_format="international"
 )
 
@@ -252,6 +263,11 @@ for result in results:
     print(f"Phone: {result.phone.number}")
     print(f"Search Cost: ${result.search_cost}")
     
+    # Access detailed pricing breakdown
+    if result.pricing:
+        print(f"  Total Cost: ${result.pricing.total_cost:.4f}")
+        print(f"  Breakdown: {result.pricing}")
+    
     if result.person:
         print(f"Name: {result.person.name}")
         print(f"DOB: {result.person.dob}")
@@ -269,6 +285,10 @@ print(f"Valid: {result.domain_valid}")
 print(f"Total results: {result.total_results}")
 print(f"Search Cost: ${result.search_cost}")
 
+# Access detailed pricing breakdown
+if result.pricing:
+    print(f"Pricing: {result.pricing}")
+
 for email_result in result.results:
     print(f"Email: {email_result.email}")
     print(f"Valid: {email_result.email_valid}")
@@ -316,29 +336,6 @@ except SearchAPIError as e:
     print(f"API error: {e}")
 ```
 
-## 🔄 Caching
-
-The client supports configurable response caching:
-
-```python
-# Enable caching with custom settings
-config = SearchAPIConfig(
-    api_key="your_api_key",
-    enable_caching=True,
-    cache_ttl=3600,      # 1 hour
-    max_cache_size=1000   # Maximum 1000 cached responses
-)
-
-client = SearchAPI(config=config)
-
-# Cache is automatically used for repeated searches
-result1 = client.search_email("test@example.com")  # Cached
-result2 = client.search_email("test@example.com")  # From cache
-
-# Clear cache when needed
-client.clear_cache()
-```
-
 ## 🧹 Context Manager
 
 Use the client as a context manager for automatic resource cleanup:
@@ -426,12 +423,9 @@ class AccessLog:
 |-----------|------|---------|-------------|
 | `api_key` | str | Required | Your API key |
 | `base_url` | str | `"https://search-api.dev/search.php"` | API base URL |
-| `max_retries` | int | `3` | Maximum retry attempts |
+| `max_retries` | int | `1` | Maximum retry attempts |
 | `timeout` | int | `90` | Request timeout in seconds |
 | `debug_mode` | bool | `False` | Enable debug logging |
-| `enable_caching` | bool | `True` | Enable response caching |
-| `cache_ttl` | int | `3600` | Cache time-to-live in seconds |
-| `max_cache_size` | int | `1000` | Maximum cache entries |
 | `proxy` | Dict | `None` | Proxy configuration |
 | `user_agent` | str | Chrome UA | Custom user agent |
 

{ad_searchapi-2.0.1 → ad_searchapi-2.0.2}/README.md

@@ -7,7 +7,6 @@ A comprehensive Python client library for the Search API with enhanced error han
 - **Enhanced Balance Management**: Manual balance checking capabilities
 - **Access Logs Integration**: Retrieve and analyze API access logs
 - **Improved Error Handling**: Comprehensive exception hierarchy with detailed error messages
-- **Advanced Caching**: Configurable response caching with TTL
 - **Better Data Models**: Enhanced data structures with metadata and cost tracking
 - **Context Manager Support**: Automatic resource cleanup
 - **Comprehensive Validation**: Input validation for all search types
@@ -40,8 +39,8 @@ try:
     
     result = client.search_email(
         "example@domain.com",
-        include_house_value=True,
-        include_extra_info=True
+        house_value=True,
+        extra_info=True
     )
     
     print(f"Name: {result.person.name if result.person else 'N/A'}")
@@ -66,9 +65,6 @@ from search_api import SearchAPI, SearchAPIConfig
 config = SearchAPIConfig(
     api_key="your_api_key",
     debug_mode=True,           # Enable debug logging
-    enable_caching=True,       # Enable response caching
-    cache_ttl=1800,           # 30 minutes cache
-    max_cache_size=500,       # Maximum cache entries
     timeout=120,              # 2 minutes timeout
     max_retries=5,           # Retry failed requests
     proxy={                   # Optional proxy
@@ -95,7 +91,7 @@ try:
     # Calculate required credits based on actual search costs
     email_search_cost = 0.0025
     phone_search_cost = 0.0025
-    domain_search_cost = 4.00
+    domain_search_cost = 0.0025
     
     required_credits = 5 * email_search_cost
     if balance.current_balance < required_credits:
@@ -114,11 +110,13 @@ except InsufficientBalanceError as e:
 ### Search Costs:
 - **Email Search**: $0.0025 per search
 - **Phone Search**: $0.0025 per search  
-- **Domain Search**: $4.00 per search
+- **Domain Search**: $0.0025 per search
 
 ### Optional Parameters:
-- **House Value**: Additional $0.0005 per successful lookup
-- **Extra Info**: Additional $0.0020 per successful lookup
+- **House Value (Zestimate)**: Additional $0.0015 per successful lookup
+- **Extra Info**: Additional $0.0015 per successful lookup
+- **Carrier Info**: Additional $0.0005 per successful lookup
+- **TLO Enrichment**: Additional $0.0030 per successful lookup
 
 ## 📊 Access Logs
 
@@ -159,8 +157,10 @@ print(f"Most active IP: {most_active_ip[0]} ({most_active_ip[1]} accesses)")
 ```python
 result = client.search_email(
     "john.doe@example.com",
-    include_house_value=True,
-    include_extra_info=True,
+    house_value=True,
+    extra_info=True,
+    carrier_info=True,
+    tlo_enrichment=True,
     phone_format="international"  # or "national", "e164"
 )
 
@@ -169,6 +169,16 @@ print(f"Valid: {result.email_valid}")
 print(f"Type: {result.email_type}")
 print(f"Search Cost: ${result.search_cost}")
 
+# Access detailed pricing breakdown
+if result.pricing:
+    print(f"Pricing Breakdown:")
+    print(f"  Base Search: ${result.pricing.search_cost:.4f}")
+    print(f"  Extra Info: ${result.pricing.extra_info_cost:.4f}")
+    print(f"  Zestimate: ${result.pricing.zestimate_cost:.4f}")
+    print(f"  Carrier: ${result.pricing.carrier_cost:.4f}")
+    print(f"  TLO Enrichment: ${result.pricing.tlo_enrichment_cost:.4f}")
+    print(f"  Total Cost: ${result.pricing.total_cost:.4f}")
+
 if result.person:
     print(f"Name: {result.person.name}")
     print(f"DOB: {result.person.dob}")
@@ -188,8 +198,10 @@ for phone in result.phone_numbers:
 ```python
 results = client.search_phone(
     "+1234567890",
-    include_house_value=True,
-    include_extra_info=True,
+    house_value=True,
+    extra_info=True,
+    carrier_info=True,
+    tlo_enrichment=True,
     phone_format="international"
 )
 
@@ -197,6 +209,11 @@ for result in results:
     print(f"Phone: {result.phone.number}")
     print(f"Search Cost: ${result.search_cost}")
     
+    # Access detailed pricing breakdown
+    if result.pricing:
+        print(f"  Total Cost: ${result.pricing.total_cost:.4f}")
+        print(f"  Breakdown: {result.pricing}")
+    
     if result.person:
         print(f"Name: {result.person.name}")
         print(f"DOB: {result.person.dob}")
@@ -214,6 +231,10 @@ print(f"Valid: {result.domain_valid}")
 print(f"Total results: {result.total_results}")
 print(f"Search Cost: ${result.search_cost}")
 
+# Access detailed pricing breakdown
+if result.pricing:
+    print(f"Pricing: {result.pricing}")
+
 for email_result in result.results:
     print(f"Email: {email_result.email}")
     print(f"Valid: {email_result.email_valid}")
@@ -261,29 +282,6 @@ except SearchAPIError as e:
     print(f"API error: {e}")
 ```
 
-## 🔄 Caching
-
-The client supports configurable response caching:
-
-```python
-# Enable caching with custom settings
-config = SearchAPIConfig(
-    api_key="your_api_key",
-    enable_caching=True,
-    cache_ttl=3600,      # 1 hour
-    max_cache_size=1000   # Maximum 1000 cached responses
-)
-
-client = SearchAPI(config=config)
-
-# Cache is automatically used for repeated searches
-result1 = client.search_email("test@example.com")  # Cached
-result2 = client.search_email("test@example.com")  # From cache
-
-# Clear cache when needed
-client.clear_cache()
-```
-
 ## 🧹 Context Manager
 
 Use the client as a context manager for automatic resource cleanup:
@@ -371,12 +369,9 @@ class AccessLog:
 |-----------|------|---------|-------------|
 | `api_key` | str | Required | Your API key |
 | `base_url` | str | `"https://search-api.dev/search.php"` | API base URL |
-| `max_retries` | int | `3` | Maximum retry attempts |
+| `max_retries` | int | `1` | Maximum retry attempts |
 | `timeout` | int | `90` | Request timeout in seconds |
 | `debug_mode` | bool | `False` | Enable debug logging |
-| `enable_caching` | bool | `True` | Enable response caching |
-| `cache_ttl` | int | `3600` | Cache time-to-live in seconds |
-| `max_cache_size` | int | `1000` | Maximum cache entries |
 | `proxy` | Dict | `None` | Proxy configuration |
 | `user_agent` | str | Chrome UA | Custom user agent |
 

{ad_searchapi-2.0.1 → ad_searchapi-2.0.2}/search_api/__init__.py

@@ -22,6 +22,7 @@ from .models import (
     AccessLog,
     PhoneFormat,
     SearchType,
+    PricingInfo,
 )
 
 __version__ = "2.0.0"
@@ -48,4 +49,5 @@ __all__ = [
     "AccessLog",
     "PhoneFormat",
     "SearchType",
+    "PricingInfo",
 ]