upload-post 2.1.0__tar.gz → 2.2.0__tar.gz

{upload_post-2.1.0 → upload_post-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: upload-post
-Version: 2.1.0
+Version: 2.2.0
 Summary: Cross-platform social media upload for TikTok, Instagram, YouTube, LinkedIn, Facebook, Pinterest, Threads, Reddit, Bluesky, and X (Twitter)
 Home-page: https://www.upload-post.com/
 Author: Upload-Post
@@ -223,6 +223,23 @@ analytics = client.get_analytics(
 print(analytics)
 ```
 
+### Get Media
+
+Retrieve recent posts from a connected social account. Supported platforms:
+`instagram`, `tiktok`, `youtube`, `linkedin`, `facebook`, `x`, `threads`,
+`pinterest`, `bluesky`, `reddit`.
+
+```python
+# Personal LinkedIn profile (default for non-org accounts):
+media = client.get_media("linkedin", "my-profile")
+
+# Force the personal profile of an account connected as an org admin:
+media = client.get_media("linkedin", "my-profile", page_urn="me")
+
+# Target a specific LinkedIn organization page:
+media = client.get_media("linkedin", "my-profile", page_urn="12345")
+```
+
 ### Helper Methods
 
 ```python

{upload_post-2.1.0 → upload_post-2.2.0}/README.md

@@ -185,6 +185,23 @@ analytics = client.get_analytics(
 print(analytics)
 ```
 
+### Get Media
+
+Retrieve recent posts from a connected social account. Supported platforms:
+`instagram`, `tiktok`, `youtube`, `linkedin`, `facebook`, `x`, `threads`,
+`pinterest`, `bluesky`, `reddit`.
+
+```python
+# Personal LinkedIn profile (default for non-org accounts):
+media = client.get_media("linkedin", "my-profile")
+
+# Force the personal profile of an account connected as an org admin:
+media = client.get_media("linkedin", "my-profile", page_urn="me")
+
+# Target a specific LinkedIn organization page:
+media = client.get_media("linkedin", "my-profile", page_urn="12345")
+```
+
 ### Helper Methods
 
 ```python

{upload_post-2.1.0 → upload_post-2.2.0}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="upload-post",
-    version="2.1.0",
+    version="2.2.0",
     author="Upload-Post",
     author_email="hi@img2html.com",
     description="Cross-platform social media upload for TikTok, Instagram, YouTube, LinkedIn, Facebook, Pinterest, Threads, Reddit, Bluesky, and X (Twitter)",

{upload_post-2.1.0 → upload_post-2.2.0}/upload_post/__init__.py

@@ -15,7 +15,7 @@ Example:
     ... )
 """
 
-__version__ = "2.1.0"
+__version__ = "2.2.0"
 
 from .api_client import UploadPostClient, UploadPostError
 

{upload_post-2.1.0 → upload_post-2.2.0}/upload_post/api_client.py

@@ -183,7 +183,7 @@ class UploadPostClient:
             if kwargs.get("photo_cover_index") is not None:
                 data.append(("photo_cover_index", str(kwargs["photo_cover_index"])))
 
-    def _add_instagram_params(self, data: List[tuple], is_video: bool = True, **kwargs):
+    def _add_instagram_params(self, data: List[tuple], is_video: bool = True, files: List[tuple] | None = None, **kwargs):
         """Add Instagram-specific parameters."""
         if kwargs.get("media_type"):
             data.append(("media_type", kwargs["media_type"]))
@@ -193,18 +193,26 @@ class UploadPostClient:
             data.append(("user_tags", kwargs["user_tags"]))
         if kwargs.get("location_id"):
             data.append(("location_id", kwargs["location_id"]))
-        
+
         if is_video:
             if kwargs.get("share_to_feed") is not None:
                 data.append(("share_to_feed", str(kwargs["share_to_feed"]).lower()))
             if kwargs.get("cover_url"):
-                data.append(("cover_url", kwargs["cover_url"]))
+                cover_val = str(kwargs["cover_url"])
+                if cover_val.lower().startswith(("http://", "https://")):
+                    data.append(("cover_url", cover_val))
+                elif files is not None:
+                    cover_path = Path(cover_val)
+                    if cover_path.exists():
+                        files.append(("cover_image", (cover_path.name, cover_path.open("rb"))))
+                else:
+                    data.append(("cover_url", cover_val))
             if kwargs.get("audio_name"):
                 data.append(("audio_name", kwargs["audio_name"]))
             if kwargs.get("thumb_offset"):
                 data.append(("thumb_offset", kwargs["thumb_offset"]))
 
-    def _add_youtube_params(self, data: List[tuple], **kwargs):
+    def _add_youtube_params(self, data: List[tuple], files: List[tuple] = None, **kwargs):
         """Add YouTube-specific parameters."""
         if kwargs.get("tags"):
             tags = kwargs["tags"]
@@ -240,6 +248,21 @@ class UploadPostClient:
             data.append(("hasPaidProductPlacement", str(kwargs["hasPaidProductPlacement"]).lower()))
         if kwargs.get("recordingDate"):
             data.append(("recordingDate", kwargs["recordingDate"]))
+        if kwargs.get("subtitles"):
+            for idx, sub in enumerate(kwargs["subtitles"]):
+                if sub.get("language"):
+                    data.append((f"youtube_subtitle_language_{idx}", sub["language"]))
+                    if sub.get("name"):
+                        data.append((f"youtube_subtitle_name_{idx}", sub["name"]))
+                    if sub.get("file"):
+                        sub_path = Path(sub["file"])
+                        if sub_path.exists() and files is not None:
+                            files.append((f"youtube_subtitle_file_{idx}", (sub_path.name, sub_path.open("rb"))))
+                        else:
+                            # Treat as URL string
+                            data.append((f"youtube_subtitle_file_{idx}", str(sub["file"])))
+                    elif sub.get("url"):
+                        data.append((f"youtube_subtitle_file_{idx}", sub["url"]))
 
     def _add_linkedin_params(self, data: List[tuple], is_text: bool = False, **kwargs):
         """Add LinkedIn-specific parameters."""
@@ -399,7 +422,7 @@ class UploadPostClient:
                 media_type: REELS or STORIES
                 share_to_feed: Share to feed
                 collaborators: Comma-separated collaborator usernames
-                cover_url: Custom cover URL
+                cover_url: Custom cover URL or file path. URLs are sent directly; file paths are uploaded as binary.
                 audio_name: Audio track name
                 user_tags: Comma-separated user tags
                 location_id: Location ID
@@ -421,7 +444,9 @@ class UploadPostClient:
                 blockedCountries: Comma-separated country codes
                 hasPaidProductPlacement: Paid placement flag
                 recordingDate: Recording date (ISO 8601)
-            
+                subtitles: List of subtitle dicts with keys: language (BCP-47),
+                    name (display name), file (path to SRT/VTT file), url (subtitle URL)
+
             LinkedIn:
                 visibility: PUBLIC, CONNECTIONS, LOGGED_IN, CONTAINER
                 target_linkedin_page_id: Page ID for organization posts
@@ -479,9 +504,9 @@ class UploadPostClient:
             if "tiktok" in platforms:
                 self._add_tiktok_params(data, is_video=True, **kwargs)
             if "instagram" in platforms:
-                self._add_instagram_params(data, is_video=True, **kwargs)
+                self._add_instagram_params(data, is_video=True, files=files, **kwargs)
             if "youtube" in platforms:
-                self._add_youtube_params(data, **kwargs)
+                self._add_youtube_params(data, files=files, **kwargs)
             if "linkedin" in platforms:
                 self._add_linkedin_params(data, **kwargs)
             if "facebook" in platforms:
@@ -937,6 +962,25 @@ class UploadPostClient:
         """
         return self._request(f"/uploadposts/post-analytics/{request_id}", "GET")
 
+    def get_post_analytics_by_platform_id(self, platform_post_id: str, platform: str, user: str) -> Dict:
+        """
+        Get analytics for any post (including organic posts) using its native platform ID.
+
+        Args:
+            platform_post_id: The native post ID on the platform (e.g., Instagram media ID).
+            platform: The platform to query (instagram, youtube, tiktok, facebook, linkedin, x, threads, pinterest, reddit).
+            user: The profile_username that owns the social account.
+
+        Returns:
+            Post analytics with live per-post metrics from the platform API.
+        """
+        params = {
+            "platform_post_id": platform_post_id,
+            "platform": platform,
+            "user": user,
+        }
+        return self._request("/uploadposts/post-analytics", "GET", params=params)
+
     def get_platform_metrics(self) -> Dict:
         """
         Get available metrics configuration for all supported platforms.
@@ -946,6 +990,30 @@ class UploadPostClient:
         """
         return self._request("/uploadposts/platform-metrics", "GET")
 
+    def get_media(
+        self,
+        platform: str,
+        user: str,
+        page_urn: Optional[str] = None,
+    ) -> Dict:
+        """
+        Retrieve recent media from a connected social account.
+
+        Args:
+            platform: instagram, tiktok, youtube, linkedin, facebook, x,
+                threads, pinterest, bluesky, or reddit.
+            user: Profile username.
+            page_urn: LinkedIn only. Numeric org ID, full URN, or ``"me"`` to
+                force the personal profile of an org-admin account.
+
+        Returns:
+            ``{"success": True, "media": [...]}``.
+        """
+        params: Dict[str, str] = {"platform": platform, "user": user}
+        if page_urn:
+            params["page_urn"] = page_urn
+        return self._request("/uploadposts/media", "GET", params=params)
+
     # ==================== Scheduled Posts ====================
 
     def list_scheduled(self) -> Dict:
@@ -1089,6 +1157,66 @@ class UploadPostClient:
         """
         return self._request("/uploadposts/users/validate-jwt", "POST", json_data={"jwt": jwt})
 
+    def get_user_preferences(self) -> Dict:
+        """
+        Get user preferences (including calendar settings).
+
+        Returns:
+            User preferences including week_start_day.
+        """
+        return self._request("/uploadposts/users/preferences", "GET")
+
+    def update_user_preferences(
+        self,
+        week_start_day: Optional[int] = None
+    ) -> Dict:
+        """
+        Update user preferences (including calendar settings).
+
+        Args:
+            week_start_day: Week start day (0=Sunday, 1=Monday).
+
+        Returns:
+            Updated preferences.
+        """
+        body: Dict[str, Any] = {}
+        if week_start_day is not None:
+            body["week_start_day"] = week_start_day
+        return self._request("/uploadposts/users/preferences", "POST", json_data=body)
+
+    def get_notification_config(self) -> Dict:
+        """
+        Get notification configuration (including webhook settings).
+
+        Returns:
+            Notification config including webhook_events and webhook_url.
+        """
+        return self._request("/uploadposts/notification-config", "GET")
+
+    def update_notification_config(
+        self,
+        webhook_events: Optional[List[str]] = None,
+        webhook_url: Optional[str] = None
+    ) -> Dict:
+        """
+        Update notification configuration (including webhook settings).
+
+        Args:
+            webhook_events: Webhook event types to subscribe to
+                (upload_completed, social_account_connected,
+                social_account_disconnected, social_account_reauth_required).
+            webhook_url: Webhook URL for notifications.
+
+        Returns:
+            Updated notification config.
+        """
+        body: Dict[str, Any] = {}
+        if webhook_events:
+            body["webhook_events"] = webhook_events
+        if webhook_url:
+            body["webhook_url"] = webhook_url
+        return self._request("/uploadposts/notification-config", "POST", json_data=body)
+
     # ==================== Helper Endpoints ====================
 
     def get_facebook_pages(self, profile: Optional[str] = None) -> Dict:
@@ -1130,6 +1258,82 @@ class UploadPostClient:
         params = {"profile": profile} if profile else None
         return self._request("/uploadposts/pinterest/boards", "GET", params=params)
 
+    # ==================== Instagram Comments ====================
+
+    def get_post_comments(
+        self,
+        user: str,
+        post_id: Optional[str] = None,
+        post_url: Optional[str] = None
+    ) -> Dict:
+        """
+        Get comments on an Instagram post.
+
+        Args:
+            user: Profile username.
+            post_id: Numeric media ID (provide post_id or post_url).
+            post_url: Full Instagram post URL (provide post_id or post_url).
+
+        Returns:
+            Comments data including comment IDs, text, timestamps, and user info.
+        """
+        params = {"platform": "instagram", "user": user}
+        if post_id:
+            params["post_id"] = post_id
+        if post_url:
+            params["post_url"] = post_url
+        return self._request("/uploadposts/comments", "GET", params=params)
+
+    def reply_to_comment(
+        self,
+        user: str,
+        comment_id: str,
+        message: str
+    ) -> Dict:
+        """
+        Send a private reply (DM) to the author of an Instagram comment.
+
+        Args:
+            user: Profile username.
+            comment_id: Comment ID from get_post_comments.
+            message: Reply message text.
+
+        Returns:
+            Reply result with recipient_id and message_id.
+        """
+        return self._request("/uploadposts/comments/reply", "POST", json_data={
+            "platform": "instagram",
+            "user": user,
+            "comment_id": comment_id,
+            "message": message
+        })
+
+    def public_reply_to_comment(
+        self,
+        user: str,
+        comment_id: str,
+        message: str
+    ) -> Dict:
+        """
+        Post a public reply to an Instagram comment (visible under the original comment).
+
+        Args:
+            user: Profile username.
+            comment_id: Comment ID from get_post_comments.
+            message: Reply message text.
+
+        Returns:
+            Reply result with the new comment ID.
+        """
+        return self._request("/uploadposts/comments/public-reply", "POST", json_data={
+            "platform": "instagram",
+            "user": user,
+            "comment_id": comment_id,
+            "message": message
+        })
+
+    # ==================== Google Business ====================
+
     def get_google_business_locations(self, profile: Optional[str] = None) -> Dict:
         """
         Get Google Business Profile locations for a connected account.

{upload_post-2.1.0 → upload_post-2.2.0}/upload_post.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: upload-post
-Version: 2.1.0
+Version: 2.2.0
 Summary: Cross-platform social media upload for TikTok, Instagram, YouTube, LinkedIn, Facebook, Pinterest, Threads, Reddit, Bluesky, and X (Twitter)
 Home-page: https://www.upload-post.com/
 Author: Upload-Post
@@ -223,6 +223,23 @@ analytics = client.get_analytics(
 print(analytics)
 ```
 
+### Get Media
+
+Retrieve recent posts from a connected social account. Supported platforms:
+`instagram`, `tiktok`, `youtube`, `linkedin`, `facebook`, `x`, `threads`,
+`pinterest`, `bluesky`, `reddit`.
+
+```python
+# Personal LinkedIn profile (default for non-org accounts):
+media = client.get_media("linkedin", "my-profile")
+
+# Force the personal profile of an account connected as an org admin:
+media = client.get_media("linkedin", "my-profile", page_urn="me")
+
+# Target a specific LinkedIn organization page:
+media = client.get_media("linkedin", "my-profile", page_urn="12345")
+```
+
 ### Helper Methods
 
 ```python