upload-post 2.0.0__tar.gz → 2.1.1__tar.gz

{upload_post-2.0.0 → upload_post-2.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: upload-post
-Version: 2.0.0
+Version: 2.1.1
 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
@@ -162,6 +162,13 @@ status = client.get_status("request_id_from_upload")
 print(status)
 ```
 
+For scheduled or queued posts, check the status using the job_id:
+
+```python
+status = client.get_job_status("job_id_from_scheduled_post")
+print(status)
+```
+
 ### Get Upload History
 
 ```python
@@ -280,7 +287,8 @@ boards = client.get_pinterest_boards("my-profile")
 ### Facebook
 - `facebook_page_id` - Facebook Page ID (required)
 - `video_state` - PUBLISHED, DRAFT
-- `facebook_media_type` - REELS, STORIES
+- `facebook_media_type` - REELS, STORIES, or VIDEO (normal page video)
+- `thumbnail_url` - Thumbnail URL for normal page videos (only when `facebook_media_type` is VIDEO)
 - `facebook_link_url` - URL for text posts
 
 ### Pinterest
@@ -303,9 +311,12 @@ boards = client.get_pinterest_boards("my-profile")
 - `share_with_followers` - Share community post with followers
 - `card_uri` - Card URI for Twitter Cards
 - `x_long_text_as_post` - Post long text as single post
+- `x_thread_image_layout` - Comma-separated image layout for thread (e.g. "4,4" or "2,3,1"). Each value 1-4, total must equal image count. Auto-chunks into groups of 4 when >4 images.
 
 ### Threads
 - `threads_long_text_as_post` - Post long text as single post (vs thread)
+- `threads_thread_media_layout` - Comma-separated list of how many media items to include in each Threads post (e.g. "5,5" or "3,4,3"). Each value 1-10, total must equal media count. Auto-chunks into groups of 10 when >10 items.
+- `threads_topic_tag` - Topic tag for the Threads post (1-50 characters, no periods or ampersands). One tag per post. Helps increase reach.
 
 ### Reddit
 - `subreddit` - Subreddit name (without r/)
@@ -325,6 +336,7 @@ These options work across all upload methods:
 | `scheduled_date` | ISO date for scheduling |
 | `timezone` | Timezone for scheduled date |
 | `add_to_queue` | Add to posting queue |
+| `max_posts_per_slot` | Max posts per queue slot (overrides profile setting) |
 | `async_upload` | Process asynchronously (default: True) |
 
 ## Error Handling
@@ -350,3 +362,5 @@ except UploadPostError as e:
 ## License
 
 MIT
+
+<!-- deployed 2026-03-16 17:49 UTC -->

{upload_post-2.0.0 → upload_post-2.1.1}/README.md

@@ -124,6 +124,13 @@ status = client.get_status("request_id_from_upload")
 print(status)
 ```
 
+For scheduled or queued posts, check the status using the job_id:
+
+```python
+status = client.get_job_status("job_id_from_scheduled_post")
+print(status)
+```
+
 ### Get Upload History
 
 ```python
@@ -242,7 +249,8 @@ boards = client.get_pinterest_boards("my-profile")
 ### Facebook
 - `facebook_page_id` - Facebook Page ID (required)
 - `video_state` - PUBLISHED, DRAFT
-- `facebook_media_type` - REELS, STORIES
+- `facebook_media_type` - REELS, STORIES, or VIDEO (normal page video)
+- `thumbnail_url` - Thumbnail URL for normal page videos (only when `facebook_media_type` is VIDEO)
 - `facebook_link_url` - URL for text posts
 
 ### Pinterest
@@ -265,9 +273,12 @@ boards = client.get_pinterest_boards("my-profile")
 - `share_with_followers` - Share community post with followers
 - `card_uri` - Card URI for Twitter Cards
 - `x_long_text_as_post` - Post long text as single post
+- `x_thread_image_layout` - Comma-separated image layout for thread (e.g. "4,4" or "2,3,1"). Each value 1-4, total must equal image count. Auto-chunks into groups of 4 when >4 images.
 
 ### Threads
 - `threads_long_text_as_post` - Post long text as single post (vs thread)
+- `threads_thread_media_layout` - Comma-separated list of how many media items to include in each Threads post (e.g. "5,5" or "3,4,3"). Each value 1-10, total must equal media count. Auto-chunks into groups of 10 when >10 items.
+- `threads_topic_tag` - Topic tag for the Threads post (1-50 characters, no periods or ampersands). One tag per post. Helps increase reach.
 
 ### Reddit
 - `subreddit` - Subreddit name (without r/)
@@ -287,6 +298,7 @@ These options work across all upload methods:
 | `scheduled_date` | ISO date for scheduling |
 | `timezone` | Timezone for scheduled date |
 | `add_to_queue` | Add to posting queue |
+| `max_posts_per_slot` | Max posts per queue slot (overrides profile setting) |
 | `async_upload` | Process asynchronously (default: True) |
 
 ## Error Handling
@@ -312,3 +324,5 @@ except UploadPostError as e:
 ## License
 
 MIT
+
+<!-- deployed 2026-03-16 17:49 UTC -->

{upload_post-2.0.0 → upload_post-2.1.1}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="upload-post",
-    version="2.0.0",
+    version="2.1.1",
     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.0.0 → upload_post-2.1.1}/upload_post/__init__.py

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

{upload_post-2.0.0 → upload_post-2.1.1}/upload_post/api_client.py

@@ -6,7 +6,7 @@ Facebook, Pinterest, Threads, Reddit, Bluesky, and X (Twitter).
 """
 
 from pathlib import Path
-from typing import Dict, List, Union, Optional, Any, Literal
+from typing import Dict, List, Union, Optional, Any
 import requests
 
 
@@ -45,7 +45,8 @@ class UploadPostClient:
         self.session = requests.Session()
         self.session.headers.update({
             "Authorization": f"Apikey {self.api_key}",
-            "User-Agent": "upload-post-python-client/2.0.0"
+            "User-Agent": "upload-post-python-client/2.0.0",
+            "X-Upload-Post-Source": "pip",
         })
 
     def _request(
@@ -85,7 +86,7 @@ class UploadPostClient:
                 try:
                     error_data = e.response.json()
                     error_msg = error_data.get('message') or error_data.get('detail') or str(error_data)
-                except:
+                except (ValueError, KeyError):
                     pass
             raise UploadPostError(f"API request failed: {error_msg}") from e
 
@@ -93,22 +94,24 @@ class UploadPostClient:
         self,
         data: List[tuple],
         user: str,
-        title: str,
+        title: Optional[str],
         platforms: List[str],
         first_comment: Optional[str] = None,
         alt_text: Optional[str] = None,
         scheduled_date: Optional[str] = None,
         timezone: Optional[str] = None,
         add_to_queue: Optional[bool] = None,
+        max_posts_per_slot: Optional[int] = None,
         async_upload: Optional[bool] = None,
         **kwargs
     ):
         """Add common upload parameters."""
         data.append(("user", user))
-        data.append(("title", title))
+        if title:
+            data.append(("title", title))
         for p in platforms:
             data.append(("platform[]", p))
-        
+
         if first_comment:
             data.append(("first_comment", first_comment))
         if alt_text:
@@ -119,6 +122,8 @@ class UploadPostClient:
             data.append(("timezone", timezone))
         if add_to_queue is not None:
             data.append(("add_to_queue", str(add_to_queue).lower()))
+        if max_posts_per_slot is not None:
+            data.append(("max_posts_per_slot", str(max_posts_per_slot)))
         if async_upload is not None:
             data.append(("async_upload", str(async_upload).lower()))
         
@@ -144,7 +149,7 @@ class UploadPostClient:
         comment_overrides = [
             "instagram_first_comment", "facebook_first_comment", "x_first_comment",
             "threads_first_comment", "youtube_first_comment", "reddit_first_comment",
-            "bluesky_first_comment"
+            "bluesky_first_comment", "linkedin_first_comment"
         ]
         for key in comment_overrides:
             if kwargs.get(key):
@@ -178,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"]))
@@ -188,12 +193,20 @@ 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"):
@@ -236,12 +249,15 @@ class UploadPostClient:
         if kwargs.get("recordingDate"):
             data.append(("recordingDate", kwargs["recordingDate"]))
 
-    def _add_linkedin_params(self, data: List[tuple], **kwargs):
+    def _add_linkedin_params(self, data: List[tuple], is_text: bool = False, **kwargs):
         """Add LinkedIn-specific parameters."""
         if kwargs.get("visibility"):
             data.append(("visibility", kwargs["visibility"]))
         if kwargs.get("target_linkedin_page_id"):
             data.append(("target_linkedin_page_id", kwargs["target_linkedin_page_id"]))
+        if is_text and (kwargs.get("linkedin_link_url") or kwargs.get("link_url")):
+            link = kwargs.get("linkedin_link_url") or kwargs.get("link_url")
+            data.append(("linkedin_link_url", link))
 
     def _add_facebook_params(self, data: List[tuple], is_video: bool = False, is_text: bool = False, **kwargs):
         """Add Facebook-specific parameters."""
@@ -253,7 +269,9 @@ class UploadPostClient:
                 data.append(("video_state", kwargs["video_state"]))
             if kwargs.get("facebook_media_type"):
                 data.append(("facebook_media_type", kwargs["facebook_media_type"]))
-        
+            if kwargs.get("thumbnail_url"):
+                data.append(("thumbnail_url", kwargs["thumbnail_url"]))
+
         if is_text and kwargs.get("facebook_link_url"):
             data.append(("facebook_link_url", kwargs["facebook_link_url"]))
 
@@ -307,6 +325,8 @@ class UploadPostClient:
                     data.append(("tagged_user_ids[]", uid))
             if kwargs.get("place_id"):
                 data.append(("place_id", kwargs["place_id"]))
+            if kwargs.get("x_thread_image_layout"):
+                data.append(("x_thread_image_layout", kwargs["x_thread_image_layout"]))
         else:
             if kwargs.get("post_url"):
                 data.append(("post_url", kwargs["post_url"]))
@@ -328,20 +348,28 @@ class UploadPostClient:
         """Add Threads-specific parameters."""
         if kwargs.get("threads_long_text_as_post") is not None:
             data.append(("threads_long_text_as_post", str(kwargs["threads_long_text_as_post"]).lower()))
+        if kwargs.get("threads_thread_media_layout"):
+            data.append(("threads_thread_media_layout", kwargs["threads_thread_media_layout"]))
+        if kwargs.get("threads_topic_tag"):
+            data.append(("threads_topic_tag", kwargs["threads_topic_tag"]))
 
-    def _add_reddit_params(self, data: List[tuple], **kwargs):
+    def _add_reddit_params(self, data: List[tuple], is_text: bool = False, **kwargs):
         """Add Reddit-specific parameters."""
         if kwargs.get("subreddit"):
             data.append(("subreddit", kwargs["subreddit"]))
         if kwargs.get("flair_id"):
             data.append(("flair_id", kwargs["flair_id"]))
+        if is_text:
+            reddit_link = kwargs.get("reddit_link_url") or kwargs.get("link_url")
+            if reddit_link:
+                data.append(("reddit_link_url", reddit_link))
 
     def upload_video(
         self,
         video_path: Union[str, Path],
-        title: str,
-        user: str,
-        platforms: List[str],
+        title: Optional[str] = None,
+        user: str = "",
+        platforms: Optional[List[str]] = None,
         **kwargs
     ) -> Dict:
         """
@@ -349,9 +377,10 @@ class UploadPostClient:
 
         Args:
             video_path: Path to video file or video URL.
-            title: Video title/caption.
+            title: Video title/caption. Required for YouTube and Reddit.
+                   Optional for TikTok, Instagram, Facebook, LinkedIn, X, Threads, Bluesky, Pinterest.
             user: User identifier (profile name).
-            platforms: Target platforms. Supported: tiktok, instagram, youtube, 
+            platforms: Target platforms. Supported: tiktok, instagram, youtube,
                       linkedin, facebook, pinterest, threads, bluesky, x
 
         Keyword Args:
@@ -378,7 +407,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
@@ -408,7 +437,8 @@ class UploadPostClient:
             Facebook:
                 facebook_page_id: Facebook Page ID
                 video_state: PUBLISHED or DRAFT
-                facebook_media_type: REELS or STORIES
+                facebook_media_type: REELS, STORIES, or VIDEO
+                thumbnail_url: Thumbnail URL for normal page videos (VIDEO type only)
             
             Pinterest:
                 pinterest_board_id: Board ID
@@ -429,6 +459,7 @@ class UploadPostClient:
             
             Threads:
                 threads_long_text_as_post: Post long text as single post
+                threads_topic_tag: Topic tag for the post (1-50 chars, no periods or ampersands)
 
         Returns:
             API response with request_id for async uploads.
@@ -456,7 +487,7 @@ 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)
             if "linkedin" in platforms:
@@ -479,9 +510,9 @@ class UploadPostClient:
     def upload_photos(
         self,
         photos: List[Union[str, Path]],
-        title: str,
-        user: str,
-        platforms: List[str],
+        title: Optional[str] = None,
+        user: str = "",
+        platforms: Optional[List[str]] = None,
         **kwargs
     ) -> Dict:
         """
@@ -489,7 +520,8 @@ class UploadPostClient:
 
         Args:
             photos: List of photo file paths or URLs.
-            title: Post title/caption.
+            title: Post title/caption. Required for Reddit.
+                   Optional for TikTok, Instagram, Facebook, LinkedIn, X, Threads, Bluesky, Pinterest.
             user: User identifier (profile name).
             platforms: Target platforms. Supported: tiktok, instagram, linkedin,
                       facebook, pinterest, threads, reddit, bluesky, x
@@ -533,14 +565,27 @@ class UploadPostClient:
                 nullcast: Promoted-only post
                 tagged_user_ids: User IDs to tag
                 x_long_text_as_post: Post long text as single post
-            
+                x_thread_image_layout: Comma-separated image layout for thread
+                    (e.g. "4,4", "2,3,1", or "0,1"). Each value 0-4, total must
+                    equal image count. 0 means no images for that tweet (useful
+                    for URL preview cards). Auto-chunks into groups of 4 if >4
+                    images and no layout specified.
+
             Threads:
                 threads_long_text_as_post: Post long text as single post
-            
+                threads_thread_media_layout: Comma-separated media layout for thread
+                    (e.g. "5,5", "3,4,3", or "0,1"). Each value 0-10, total must
+                    equal media count. 0 means no media for that post. Auto-chunks
+                    into groups of 10 if >10 items and no layout specified.
+                threads_topic_tag: Topic tag for the post (1-50 chars, no periods or ampersands)
+
             Reddit:
                 subreddit: Subreddit name (without r/)
                 flair_id: Flair template ID
 
+            first_comment_media: List of file paths to attach as images in
+                the first comment. Supported on Reddit and X.
+
         Returns:
             API response.
 
@@ -550,7 +595,7 @@ class UploadPostClient:
         data: List[tuple] = []
         files: List[tuple] = []
         opened_files: List = []
-        
+
         try:
             for photo in photos:
                 photo_str = str(photo)
@@ -563,9 +608,9 @@ class UploadPostClient:
                     photo_file = photo_p.open("rb")
                     opened_files.append(photo_file)
                     files.append(("photos[]", (photo_p.name, photo_file)))
-            
+
             self._add_common_params(data, user, title, platforms, **kwargs)
-            
+
             if "tiktok" in platforms:
                 self._add_tiktok_params(data, is_video=False, **kwargs)
             if "instagram" in platforms:
@@ -582,9 +627,19 @@ class UploadPostClient:
                 self._add_threads_params(data, **kwargs)
             if "reddit" in platforms:
                 self._add_reddit_params(data, **kwargs)
-            
+
+            first_comment_media = kwargs.get("first_comment_media")
+            if first_comment_media:
+                for media_path in first_comment_media:
+                    p = Path(media_path)
+                    if not p.exists():
+                        raise UploadPostError(f"First comment media file not found: {media_path}")
+                    f = open(p, "rb")
+                    opened_files.append(f)
+                    files.append(("first_comment_media[]", (p.name, f)))
+
             return self._request("/upload_photos", "POST", data=data, files=files if files else None)
-            
+
         finally:
             for f in opened_files:
                 f.close()
@@ -611,14 +666,20 @@ class UploadPostClient:
             timezone: Timezone for scheduled date
             add_to_queue: Add to posting queue
             async_upload: Process asynchronously
-            
+            link_url: Generic URL for link preview card (works for LinkedIn,
+                Bluesky, Facebook). Platform-specific params take priority.
+
             LinkedIn:
                 target_linkedin_page_id: Page ID for organization posts
-            
+                linkedin_link_url: URL to attach as link preview on LinkedIn
+
             Facebook:
                 facebook_page_id: Facebook Page ID
-                facebook_link_url: URL to attach as link preview
-            
+                facebook_link_url: URL to attach as link preview on Facebook
+
+            Bluesky:
+                bluesky_link_url: URL to attach as external embed link preview
+
             X (Twitter):
                 reply_settings: Who can reply
                 post_url: URL to attach
@@ -628,13 +689,20 @@ class UploadPostClient:
                 poll_reply_settings: Who can reply to poll
                 card_uri: Card URI for Twitter Cards
                 x_long_text_as_post: Post long text as single post
-            
+
             Threads:
                 threads_long_text_as_post: Post long text as single post
-            
+                threads_topic_tag: Topic tag for the post (1-50 chars, no periods or ampersands)
+
             Reddit:
                 subreddit: Subreddit name (without r/)
                 flair_id: Flair template ID
+                reddit_link_url: URL for link post. Creates a Reddit link post
+                    (kind: "link") instead of a text post. Overrides `link_url`
+                    for Reddit.
+
+            first_comment_media: List of file paths to attach as images in
+                the first comment. Supported on Reddit and X.
 
         Returns:
             API response.
@@ -643,11 +711,16 @@ class UploadPostClient:
             UploadPostError: If upload fails.
         """
         data: List[tuple] = []
-        
+        files: Optional[List[tuple]] = None
+
         self._add_common_params(data, user, title, platforms, **kwargs)
-        
+
+        # Generic link_url support
+        if kwargs.get("link_url"):
+            data.append(("link_url", kwargs["link_url"]))
+
         if "linkedin" in platforms:
-            self._add_linkedin_params(data, **kwargs)
+            self._add_linkedin_params(data, is_text=True, **kwargs)
         if "facebook" in platforms:
             self._add_facebook_params(data, is_video=False, is_text=True, **kwargs)
         if "x" in platforms:
@@ -655,9 +728,29 @@ class UploadPostClient:
         if "threads" in platforms:
             self._add_threads_params(data, **kwargs)
         if "reddit" in platforms:
-            self._add_reddit_params(data, **kwargs)
-        
-        return self._request("/upload_text", "POST", data=data)
+            self._add_reddit_params(data, is_text=True, **kwargs)
+        if "bluesky" in platforms:
+            bluesky_link = kwargs.get("bluesky_link_url")
+            if bluesky_link:
+                data.append(("bluesky_link_url", bluesky_link))
+
+        first_comment_media = kwargs.get("first_comment_media")
+        opened_files: List = []
+        if first_comment_media:
+            files = []
+            for media_path in first_comment_media:
+                p = Path(media_path)
+                if not p.exists():
+                    raise UploadPostError(f"First comment media file not found: {media_path}")
+                f = open(p, "rb")
+                opened_files.append(f)
+                files.append(("first_comment_media[]", (p.name, f)))
+
+        try:
+            return self._request("/upload_text", "POST", data=data, files=files)
+        finally:
+            for f in opened_files:
+                f.close()
 
     def upload_document(
         self,
@@ -737,7 +830,7 @@ class UploadPostClient:
 
     def get_status(self, request_id: str) -> Dict:
         """
-        Get the status of an async upload.
+        Get the status of an async upload by request ID.
 
         Args:
             request_id: The request_id from an async upload.
@@ -747,6 +840,18 @@ class UploadPostClient:
         """
         return self._request("/uploadposts/status", "GET", params={"request_id": request_id})
 
+    def get_job_status(self, job_id: str) -> Dict:
+        """
+        Get the status of a scheduled or queued upload by job ID.
+
+        Args:
+            job_id: The job_id from a scheduled or queued upload.
+
+        Returns:
+            Upload status.
+        """
+        return self._request("/uploadposts/status", "GET", params={"job_id": job_id})
+
     def get_history(self, page: int = 1, limit: int = 20) -> Dict:
         """
         Get upload history.
@@ -760,22 +865,114 @@ class UploadPostClient:
         """
         return self._request("/uploadposts/history", "GET", params={"page": page, "limit": limit})
 
-    def get_analytics(self, profile_username: str, platforms: Optional[List[str]] = None) -> Dict:
+    def get_analytics(self, profile_username: str, platforms: Optional[List[str]] = None,
+                      page_id: Optional[str] = None, page_urn: Optional[str] = None) -> Dict:
         """
         Get analytics for a profile.
 
         Args:
             profile_username: Profile username.
-            platforms: Filter by platforms (instagram, linkedin, facebook, x).
+            platforms: Filter by platforms (instagram, linkedin, facebook, x, youtube, tiktok, threads, pinterest, reddit).
+            page_id: Facebook Page ID (required for Facebook analytics).
+            page_urn: LinkedIn page URN (defaults to "me" for personal profile).
 
         Returns:
-            Analytics data.
+            Analytics data per platform. For Instagram, the response includes both
+            'views' (official Instagram metric) and 'impressions' (backwards-compatible alias).
         """
         params = {}
         if platforms:
             params["platforms"] = ",".join(platforms)
+        if page_id:
+            params["page_id"] = page_id
+        if page_urn:
+            params["page_urn"] = page_urn
         return self._request(f"/analytics/{profile_username}", "GET", params=params if params else None)
 
+    def get_total_impressions(
+        self,
+        profile_username: str,
+        period: Optional[str] = None,
+        start_date: Optional[str] = None,
+        end_date: Optional[str] = None,
+        date: Optional[str] = None,
+        platforms: Optional[List[str]] = None,
+        breakdown: bool = False,
+        metrics: Optional[List[str]] = None,
+    ) -> Dict:
+        """
+        Get total impressions for a profile from daily snapshots.
+
+        Args:
+            profile_username: Profile username.
+            period: Period shortcut (last_day, last_week, last_month, last_3months, last_year).
+            start_date: Start date in YYYY-MM-DD format.
+            end_date: End date in YYYY-MM-DD format.
+            date: Single date in YYYY-MM-DD format.
+            platforms: Filter by platforms.
+            breakdown: Include per-platform and per-day breakdown.
+            metrics: Specific metrics to aggregate (e.g., ["likes", "comments", "shares", "views"]).
+
+        Returns:
+            Total impressions data with optional breakdown. For Instagram, uses 'reach' as the primary metric.
+        """
+        params: Dict[str, Any] = {}
+        if period:
+            params["period"] = period
+        if start_date:
+            params["start_date"] = start_date
+        if end_date:
+            params["end_date"] = end_date
+        if date:
+            params["date"] = date
+        if platforms:
+            params["platform"] = ",".join(platforms)
+        if breakdown:
+            params["breakdown"] = "true"
+        if metrics:
+            params["metrics"] = ",".join(metrics)
+        return self._request(f"/uploadposts/total-impressions/{profile_username}", "GET", params=params if params else None)
+
+    def get_post_analytics(self, request_id: str) -> Dict:
+        """
+        Get analytics for a specific post across all platforms it was published to.
+
+        Args:
+            request_id: The request_id from the upload.
+
+        Returns:
+            Post analytics with per-platform metrics, profile snapshots, and post-level metrics.
+        """
+        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.
+
+        Returns:
+            Platform metrics config with primary fields, available metrics, and labels.
+        """
+        return self._request("/uploadposts/platform-metrics", "GET")
+
     # ==================== Scheduled Posts ====================
 
     def list_scheduled(self) -> Dict:
@@ -864,7 +1061,11 @@ class UploadPostClient:
         redirect_url: Optional[str] = None,
         logo_image: Optional[str] = None,
         redirect_button_text: Optional[str] = None,
-        platforms: Optional[List[str]] = None
+        platforms: Optional[List[str]] = None,
+        show_calendar: Optional[bool] = None,
+        readonly_calendar: Optional[bool] = None,
+        connect_title: Optional[str] = None,
+        connect_description: Optional[str] = None
     ) -> Dict:
         """
         Generate a JWT for platform integration.
@@ -876,6 +1077,10 @@ class UploadPostClient:
             logo_image: Logo image URL for the linking page.
             redirect_button_text: Text for redirect button.
             platforms: Platforms to show for connection.
+            show_calendar: Whether to show the calendar view.
+            readonly_calendar: Show only a read-only calendar (no editing, no account connection).
+            connect_title: Custom title for the connection page.
+            connect_description: Custom description for the connection page.
 
         Returns:
             JWT and connection URL.
@@ -889,6 +1094,14 @@ class UploadPostClient:
             body["redirect_button_text"] = redirect_button_text
         if platforms:
             body["platforms"] = platforms
+        if show_calendar is not None:
+            body["show_calendar"] = show_calendar
+        if readonly_calendar is not None:
+            body["readonly_calendar"] = readonly_calendar
+        if connect_title:
+            body["connect_title"] = connect_title
+        if connect_description:
+            body["connect_description"] = connect_description
         return self._request("/uploadposts/users/generate-jwt", "POST", json_data=body)
 
     def validate_jwt(self, jwt: str) -> Dict:
@@ -903,6 +1116,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:
@@ -943,3 +1216,108 @@ 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.
+
+        Args:
+            profile: Profile username.
+
+        Returns:
+            List of Google Business locations.
+        """
+        params = {"profile": profile} if profile else None
+        return self._request("/uploadposts/google-business/locations", "GET", params=params)
+
+    def select_google_business_location(self, location_id: str, profile: Optional[str] = None) -> Dict:
+        """
+        Select a specific Google Business Profile location for a profile.
+
+        Args:
+            location_id: The location ID to select (e.g. "accounts/123/locations/456").
+            profile: Profile username.
+
+        Returns:
+            Selection result with google_business_id and display_name.
+        """
+        data = {"location_id": location_id}
+        if profile:
+            data["profile"] = profile
+        return self._request("/uploadposts/google-business/locations/select", "POST", json_data=data)

{upload_post-2.0.0 → upload_post-2.1.1}/upload_post.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: upload-post
-Version: 2.0.0
+Version: 2.1.1
 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
@@ -162,6 +162,13 @@ status = client.get_status("request_id_from_upload")
 print(status)
 ```
 
+For scheduled or queued posts, check the status using the job_id:
+
+```python
+status = client.get_job_status("job_id_from_scheduled_post")
+print(status)
+```
+
 ### Get Upload History
 
 ```python
@@ -280,7 +287,8 @@ boards = client.get_pinterest_boards("my-profile")
 ### Facebook
 - `facebook_page_id` - Facebook Page ID (required)
 - `video_state` - PUBLISHED, DRAFT
-- `facebook_media_type` - REELS, STORIES
+- `facebook_media_type` - REELS, STORIES, or VIDEO (normal page video)
+- `thumbnail_url` - Thumbnail URL for normal page videos (only when `facebook_media_type` is VIDEO)
 - `facebook_link_url` - URL for text posts
 
 ### Pinterest
@@ -303,9 +311,12 @@ boards = client.get_pinterest_boards("my-profile")
 - `share_with_followers` - Share community post with followers
 - `card_uri` - Card URI for Twitter Cards
 - `x_long_text_as_post` - Post long text as single post
+- `x_thread_image_layout` - Comma-separated image layout for thread (e.g. "4,4" or "2,3,1"). Each value 1-4, total must equal image count. Auto-chunks into groups of 4 when >4 images.
 
 ### Threads
 - `threads_long_text_as_post` - Post long text as single post (vs thread)
+- `threads_thread_media_layout` - Comma-separated list of how many media items to include in each Threads post (e.g. "5,5" or "3,4,3"). Each value 1-10, total must equal media count. Auto-chunks into groups of 10 when >10 items.
+- `threads_topic_tag` - Topic tag for the Threads post (1-50 characters, no periods or ampersands). One tag per post. Helps increase reach.
 
 ### Reddit
 - `subreddit` - Subreddit name (without r/)
@@ -325,6 +336,7 @@ These options work across all upload methods:
 | `scheduled_date` | ISO date for scheduling |
 | `timezone` | Timezone for scheduled date |
 | `add_to_queue` | Add to posting queue |
+| `max_posts_per_slot` | Max posts per queue slot (overrides profile setting) |
 | `async_upload` | Process asynchronously (default: True) |
 
 ## Error Handling
@@ -350,3 +362,5 @@ except UploadPostError as e:
 ## License
 
 MIT
+
+<!-- deployed 2026-03-16 17:49 UTC -->