seoscoreapi 1.1.0__tar.gz → 1.2.0__tar.gz

{seoscoreapi-1.1.0 → seoscoreapi-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: seoscoreapi
-Version: 1.1.0
+Version: 1.2.0
 Summary: Python client for SEO Score API — audit any URL for SEO issues with one function call
 Author-email: SEO Score API <info@seoscoreapi.com>
 License: MIT

{seoscoreapi-1.1.0 → seoscoreapi-1.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "seoscoreapi"
-version = "1.1.0"
+version = "1.2.0"
 description = "Python client for SEO Score API — audit any URL for SEO issues with one function call"
 readme = "README.md"
 license = {text = "MIT"}

{seoscoreapi-1.1.0 → seoscoreapi-1.2.0}/seoscoreapi/__init__.py

@@ -17,10 +17,12 @@ Usage:
 Full docs: https://seoscoreapi.com/docs
 """
 
+from typing import Optional
+
 import requests
 
 BASE_URL = "https://seoscoreapi.com"
-__version__ = "1.1.0"
+__version__ = "1.2.0"
 
 _HEADERS = {"User-Agent": f"seoscoreapi-python/{__version__}"}
 
@@ -74,6 +76,30 @@ def scoreboard_opt_out(api_key: str, opt_out: bool = True) -> dict:
     return r.json()
 
 
+def competitive_audit(url: str, competitor_url: str, keyword: str, api_key: str) -> dict:
+    """Run a head-to-head competitive audit (Pro plan or higher). Returns gap score, per-check diffs, and action items."""
+    r = requests.post(f"{BASE_URL}/audit/competitive", json={"url": url, "competitor_url": competitor_url, "keyword": keyword}, headers={"X-API-Key": api_key, **_HEADERS})
+    r.raise_for_status()
+    return r.json()
+
+
 def report_url(domain: str) -> str:
     """Get the shareable report URL for a domain."""
     return f"{BASE_URL}/report/{domain}"
+
+
+def history(url: str, api_key: str, limit: int = 100, since: Optional[float] = None) -> dict:
+    """Get historical audit scores and trend summary for a URL (Starter plan or higher)."""
+    params: dict = {"url": url, "limit": limit}
+    if since is not None:
+        params["since"] = since
+    r = requests.get(f"{BASE_URL}/history", params=params, headers={"X-API-Key": api_key, **_HEADERS})
+    r.raise_for_status()
+    return r.json()
+
+
+def history_domains(api_key: str) -> list:
+    """List every domain audited by this key with latest score and 30-day trend (Starter plan or higher)."""
+    r = requests.get(f"{BASE_URL}/history/domains", headers={"X-API-Key": api_key, **_HEADERS})
+    r.raise_for_status()
+    return r.json()["domains"]

{seoscoreapi-1.1.0 → seoscoreapi-1.2.0}/seoscoreapi.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: seoscoreapi
-Version: 1.1.0
+Version: 1.2.0
 Summary: Python client for SEO Score API — audit any URL for SEO issues with one function call
 Author-email: SEO Score API <info@seoscoreapi.com>
 License: MIT