substack-api 1.1.2__py3-none-any.whl → 1.1.4.dev0__py3-none-any.whl

substack_api/__init__.py

@@ -1,9 +1,17 @@
+from importlib import metadata as _metadata
+
 from .auth import SubstackAuth
 from .category import Category, list_all_categories
 from .newsletter import Newsletter
 from .post import Post
 from .user import User, resolve_handle_redirect
 
+try:
+    # Use distribution metadata so tag-based builds report the correct version.
+    __version__ = _metadata.version("substack-api")
+except _metadata.PackageNotFoundError:  # pragma: no cover - occurs for editable installs
+    __version__ = "0.0.0"
+
 __all__ = [
     "User",
     "Post",
@@ -12,4 +20,5 @@ __all__ = [
     "SubstackAuth",
     "resolve_handle_redirect",
     "list_all_categories",
+    "__version__",
 ]

substack_api/newsletter.py

@@ -1,3 +1,5 @@
+import re
+import urllib.parse
 from time import sleep
 from typing import Any, Dict, List, Optional
 
@@ -10,6 +12,43 @@ HEADERS = {
 }
 
 
+SEARCH_URL = "https://substack.com/api/v1/publication/search"
+
+DISCOVERY_HEADERS = {
+    "User-Agent": HEADERS["User-Agent"],
+    "Accept": "application/json",
+    "Origin": "https://substack.com",
+    "Referer": "https://substack.com/discover",
+}
+
+
+def _host_from_url(url: str) -> str:
+    host = urllib.parse.urlparse(
+        url if "://" in url else f"https://{url}"
+    ).netloc.lower()
+    return host
+
+
+def _match_publication(search_results: dict, host: str) -> Optional[dict]:
+    # Try exact custom domain, then subdomain match
+    for item in search_results.get("publications", []):
+        if (
+            item.get("custom_domain") and _host_from_url(item["custom_domain"]) == host
+        ) or (
+            item.get("subdomain")
+            and f"{item['subdomain'].lower()}.substack.com" == host
+        ):
+            return item
+    # Fallback: loose match on subdomain token
+    m = re.match(r"^([a-z0-9-]+)\.substack\.com$", host)
+    if m:
+        sub = m.group(1)
+        for item in search_results.get("publications", []):
+            if item.get("subdomain", "").lower() == sub:
+                return item
+    return None
+
+
 class Newsletter:
     """
     Newsletter class for interacting with Substack newsletters
@@ -183,49 +222,73 @@ class Newsletter:
         post_data = self._fetch_paginated_posts(params, limit)
         return [Post(item["canonical_url"], auth=self.auth) for item in post_data]
 
-    def get_recommendations(self) -> List["Newsletter"]:
+    def _resolve_publication_id(self) -> Optional[int]:
         """
-        Get recommended publications for this newsletter
+        Resolve publication_id via Substack discovery search—no posts needed.
+
+        Parameters
+        ----------
+        None
 
         Returns
         -------
-        List[Newsletter]
-            List of recommended Newsletter objects
+        Optional[int]
+            The publication ID if found, otherwise None.
+
+        Raises
+        ------
+        requests.HTTPError
+            If the HTTP request to Substack fails.
         """
-        # First get any post to extract the publication ID
-        posts = self.get_posts(limit=1)
-        if not posts:
-            return []
+        host = _host_from_url(self.url)
+        q = host.split(":")[0]  # strip port if present
+        params = {
+            "query": q,
+            "page": 0,
+            "limit": 25,
+            "skipExplanation": "true",
+            "sort": "relevance",
+        }
+        r = requests.get(
+            SEARCH_URL, headers=DISCOVERY_HEADERS, params=params, timeout=30
+        )
+        r.raise_for_status()
+        match = _match_publication(r.json(), host)
+        return match.get("id") if match else None
 
-        publication_id = posts[0].get_metadata()["publication_id"]
+    def get_recommendations(self) -> List["Newsletter"]:
+        """
+        Get recommended publications without relying on the latest post.
+        """
+        publication_id = self._resolve_publication_id()
+        if not publication_id:
+            # graceful fallback to your existing (post-derived) path
+            try:
+                posts = self.get_posts(limit=1)
+                publication_id = (
+                    posts[0].get_metadata()["publication_id"] if posts else None
+                )
+            except Exception:
+                publication_id = None
+        if not publication_id:
+            return []
 
-        # Now get the recommendations
         endpoint = f"{self.url}/api/v1/recommendations/from/{publication_id}"
         response = self._make_request(endpoint, timeout=30)
         response.raise_for_status()
+        recommendations = response.json() or []
 
-        recommendations = response.json()
-        if not recommendations:
-            return []
-
-        recommended_newsletter_urls = []
+        urls = []
         for rec in recommendations:
-            recpub = rec["recommendedPublication"]
-            if "custom_domain" in recpub and recpub["custom_domain"]:
-                recommended_newsletter_urls.append(recpub["custom_domain"])
-            else:
-                recommended_newsletter_urls.append(
-                    f"{recpub['subdomain']}.substack.com"
-                )
-
-        # Avoid circular import
-        from .newsletter import Newsletter
+            pub = rec.get("recommendedPublication", {})
+            if pub.get("custom_domain"):
+                urls.append(pub["custom_domain"])
+            elif pub.get("subdomain"):
+                urls.append(f"{pub['subdomain']}.substack.com")
 
-        result = [
-            Newsletter(url, auth=self.auth) for url in recommended_newsletter_urls
-        ]
+        from .newsletter import Newsletter  # avoid circular import
 
-        return result
+        return [Newsletter(u, auth=self.auth) for u in urls]
 
     def get_authors(self) -> List:
         """

{substack_api-1.1.2.dist-info → substack_api-1.1.4.dev0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: substack-api
-Version: 1.1.2
+Version: 1.1.4.dev0
 Summary: Unofficial wrapper for the Substack API
 Project-URL: Homepage, https://github.com/nhagar/substack_api
 Project-URL: Bug Tracker, https://github.com/nhagar/substack_api/issues

substack_api-1.1.4.dev0.dist-info/RECORD

@@ -0,0 +1,11 @@
+substack_api/__init__.py,sha256=PIVnDjujILU1uVJoSr7XckDNHYHaGYkX7InO7dZZcdw,658
+substack_api/auth.py,sha256=V5pU1jKZdEdsEcaL02wGO3frdxmtj-zJbafNXzH1AKI,2775
+substack_api/category.py,sha256=Xzc8KOIHg_eqloiWy44Lfm-T2EWC1nbt8sd4OII_eAQ,5167
+substack_api/newsletter.py,sha256=XmpX8-QIPD38-akUHzB0LMWj0-9FoYs75npeSWbvOzM,9676
+substack_api/post.py,sha256=k75iXnxAECKFvIzyAPT3fjbel6dM2YJysss82ZsLsLo,3633
+substack_api/user.py,sha256=aCQPdTVz0CYwCjIBkVeGi-6gz5o2pD1SbiyXD_Cj73w,8211
+substack_api-1.1.4.dev0.dist-info/licenses/LICENSE,sha256=yBOIxrO0jO_AaAkiYbdydb7kg5ZO_qy4mBEYzjxIQn8,1066
+substack_api-1.1.4.dev0.dist-info/METADATA,sha256=_RhPL7q0sZbJyGFkuEmBjU8v3pAFBJEE5ONpLNHjKds,5977
+substack_api-1.1.4.dev0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+substack_api-1.1.4.dev0.dist-info/top_level.txt,sha256=0CQgkJ3y5JH19TzaDyg_rjPkU6zKxEffCGksxw7qyIg,13
+substack_api-1.1.4.dev0.dist-info/RECORD,,

substack_api-1.1.2.dist-info/RECORD

@@ -1,11 +0,0 @@
-substack_api/__init__.py,sha256=zlsma-aBbXqRp6hoZ1e2ZZU4H5xZjJpr91EpJfAGd28,340
-substack_api/auth.py,sha256=V5pU1jKZdEdsEcaL02wGO3frdxmtj-zJbafNXzH1AKI,2775
-substack_api/category.py,sha256=Xzc8KOIHg_eqloiWy44Lfm-T2EWC1nbt8sd4OII_eAQ,5167
-substack_api/newsletter.py,sha256=ynvkH5iwI45pgar4lJxwAsaG_6FSlRpq0CyM85F8kIc,7664
-substack_api/post.py,sha256=k75iXnxAECKFvIzyAPT3fjbel6dM2YJysss82ZsLsLo,3633
-substack_api/user.py,sha256=aCQPdTVz0CYwCjIBkVeGi-6gz5o2pD1SbiyXD_Cj73w,8211
-substack_api-1.1.2.dist-info/licenses/LICENSE,sha256=yBOIxrO0jO_AaAkiYbdydb7kg5ZO_qy4mBEYzjxIQn8,1066
-substack_api-1.1.2.dist-info/METADATA,sha256=o8RRePSGLjiYZrS8OwEO4IB6jpT4Noor00p30JXkIrg,5972
-substack_api-1.1.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-substack_api-1.1.2.dist-info/top_level.txt,sha256=0CQgkJ3y5JH19TzaDyg_rjPkU6zKxEffCGksxw7qyIg,13
-substack_api-1.1.2.dist-info/RECORD,,