ip.sb (#12)

* feat : _ipsb_ipv4 function added

* fix : IPv4API updated

* doc : README.md updated

* doc : CHANGELOG.md updated

* fix : autopep8

* fix : REQUEST_HEADERS added

Author: sepandhaghighi

CHANGELOG.md

@@ -5,6 +5,8 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+### Added
+- Support [ip.sb](https://api.ip.sb/geoip)
 ### Changed
 - `README.md` updated
 ## [0.1] - 2025-04-25

README.md

@@ -139,7 +139,7 @@ Public IP and Location Info:
 
 #### IPv4 API
 
-ℹ️ `ipv4-api` valid choices: [`auto`, `ipapi`, `ipinfo`]
+ℹ️ `ipv4-api` valid choices: [`auto`, `ipapi`, `ipinfo`, `ipsb`]
 
 ℹ️ The default value: `auto`
 

ipspot/functions.py

@@ -5,7 +5,7 @@
 from typing import Union, Dict, Any
 import requests
 from art import tprint
-from .params import IPv4API, PARAMETERS_NAME_MAP
+from .params import REQUEST_HEADERS, IPv4API, PARAMETERS_NAME_MAP
 from .params import IPSPOT_OVERVIEW, IPSPOT_REPO, IPSPOT_VERSION
 
 
@@ -27,6 +27,34 @@ def get_private_ipv4() -> Dict[str, Union[bool, Dict[str, str], str]]:
         return {"status": False, "error": str(e)}
 
 
+def _ipsb_ipv4(geo: bool=False) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+    """
+    Get public IP and geolocation using ip.sb.
+
+    :param geo: geolocation flag
+    """
+    try:
+        response = requests.get("https://api.ip.sb/geoip", headers=REQUEST_HEADERS, timeout=5)
+        response.raise_for_status()
+        data = response.json()
+        result = {"status": True, "data": {"ip": data.get("ip"), "api": "ip.sb"}}
+        if geo:
+            geo_data = {
+                "city": data.get("city"),
+                "region": data.get("region"),
+                "country": data.get("country"),
+                "country_code": data.get("country_code"),
+                "latitude": data.get("latitude"),
+                "longitude": data.get("longitude"),
+                "organization": data.get("organization"),
+                "timezone": data.get("timezone")
+            }
+            result["data"].update(geo_data)
+        return result
+    except Exception as e:
+        return {"status": False, "error": str(e)}
+
+
 def _ipapi_ipv4(geo: bool=False) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
     """
     Get public IP and geolocation using ip-api.com.
@@ -98,6 +126,7 @@ def get_public_ipv4(api: IPv4API=IPv4API.AUTO,
     api_map = {
         IPv4API.IPAPI: _ipapi_ipv4,
         IPv4API.IPINFO: _ipinfo_ipv4,
+        IPv4API.IPSB: _ipsb_ipv4
     }
 
     if api == IPv4API.AUTO:

ipspot/params.py

@@ -10,6 +10,12 @@
 Designed with simplicity and modularity in mind, IPSpot offers quick IP and geolocation lookups directly from your machine.
 '''
 
+REQUEST_HEADERS = {
+    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) "
+                  "AppleWebKit/537.36 (KHTML, like Gecko) "
+                  "Chrome/123.0.0.0 Safari/537.36"
+}
+
 IPSPOT_REPO = "Repo : https://github.com/openscilab/ipspot"
 
 
@@ -19,6 +25,7 @@ class IPv4API(Enum):
     AUTO = "auto"
     IPAPI = "ipapi"
     IPINFO = "ipinfo"
+    IPSB = "ipsb"
 
 
 PARAMETERS_NAME_MAP = {