upload-post 2.0.3 → 2.1.0

package/.github/workflows/publish.yml

@@ -3,6 +3,9 @@ name: Publish to npm
 on:
   release:
     types: [published]
+  push:
+    branches: [main]
+    paths: ['package.json']
   workflow_dispatch:
     inputs:
       dry_run:
@@ -16,7 +19,7 @@ jobs:
     runs-on: ubuntu-latest
     permissions:
       contents: read
-      id-token: write  # Required for OIDC trusted publishing
+      id-token: write
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -27,13 +30,32 @@ jobs:
           node-version: '22'
           registry-url: 'https://registry.npmjs.org'
 
+      - name: Check if version is new
+        id: version_check
+        run: |
+          LOCAL=$(node -p "require('./package.json').version")
+          PKG_NAME=$(node -p "require('./package.json').name")
+          REMOTE=$(npm view "$PKG_NAME" version 2>/dev/null || echo "0.0.0")
+          echo "local=$LOCAL" >> $GITHUB_OUTPUT
+          echo "remote=$REMOTE" >> $GITHUB_OUTPUT
+          if [ "$LOCAL" = "$REMOTE" ]; then
+            echo "new=false" >> $GITHUB_OUTPUT
+            echo "⏭️ Version $LOCAL already published, skipping."
+          else
+            echo "new=true" >> $GITHUB_OUTPUT
+            echo "🚀 New version detected: $REMOTE → $LOCAL"
+          fi
+
       - name: Update npm to latest
+        if: steps.version_check.outputs.new == 'true' || github.event_name == 'workflow_dispatch'
         run: npm install -g npm@latest && npm --version
 
       - name: Install dependencies
+        if: steps.version_check.outputs.new == 'true' || github.event_name == 'workflow_dispatch'
         run: npm ci
 
       - name: Build (if needed)
+        if: steps.version_check.outputs.new == 'true' || github.event_name == 'workflow_dispatch'
         run: npm run build --if-present
 
       - name: Publish to npm (dry-run)
@@ -41,5 +63,5 @@ jobs:
         run: npm publish --access public --dry-run
 
       - name: Publish to npm
-        if: ${{ inputs.dry_run != true }}
+        if: (steps.version_check.outputs.new == 'true' && inputs.dry_run != true) || github.event_name == 'release'
         run: npm publish --access public --provenance

package/README.md

@@ -123,6 +123,13 @@ const status = await client.getStatus('request_id_from_upload');
 console.log(status);
 ```
 
+For scheduled or queued posts, check the status using the job_id:
+
+```javascript
+const status = await client.getJobStatus('job_id_from_scheduled_post');
+console.log(status);
+```
+
 ### Get Upload History
 
 ```javascript
@@ -238,7 +245,8 @@ const boards = await client.getPinterestBoards('my-profile');
 ### Facebook
 - `facebookPageId` - Facebook Page ID (required)
 - `facebookVideoState` - PUBLISHED, DRAFT
-- `facebookMediaType` - REELS, STORIES
+- `facebookMediaType` - REELS, STORIES, VIDEO (VIDEO for normal page videos with no 9:16 restriction)
+- `thumbnailUrl` - URL for custom video thumbnail (only when facebookMediaType is VIDEO)
 - `facebookLinkUrl` - URL for text posts
 
 ### Pinterest
@@ -261,9 +269,12 @@ const boards = await client.getPinterestBoards('my-profile');
 - `xShareWithFollowers` - Share community post with followers
 - `xCardUri` - Card URI for Twitter Cards
 - `xLongTextAsPost` - Post long text as single post
+- `xThreadImageLayout` - Comma-separated image layout for thread (e.g. "4,4" or "2,3,1")
 
 ### Threads
 - `threadsLongTextAsPost` - Post long text as single post (vs thread)
+- `threadsThreadMediaLayout` - Comma-separated list of how many media items to include in each Threads post. Each value must be 1-10, and the total must equal the number of files. Example: '5,5' splits 10 items into 2 posts with 5 each. If omitted and more than 10 items are provided, auto-chunks into groups of 10.
+- `threadsTopicTag` - Topic tag for the Threads post (1-50 characters, no periods or ampersands). One tag per post. Helps increase reach.
 
 ### Reddit
 - `redditSubreddit` - Subreddit name (without r/)
@@ -283,6 +294,7 @@ These options work across all upload methods:
 | `scheduledDate` | ISO date for scheduling |
 | `timezone` | Timezone for scheduled date |
 | `addToQueue` | Add to posting queue |
+| `maxPostsPerSlot` | Max posts per queue slot (overrides profile setting) |
 | `asyncUpload` | Process asynchronously (default: true) |
 
 ## TypeScript Support
@@ -324,3 +336,5 @@ try {
 ## License
 
 MIT
+
+<!-- deployed 2026-03-16 17:49 UTC -->

package/index.d.ts

@@ -2,13 +2,13 @@ declare module 'upload-post' {
   // ==================== Common Types ====================
 
   /** Supported platforms for video upload */
-  export type VideoPlatform = 'tiktok' | 'instagram' | 'youtube' | 'linkedin' | 'facebook' | 'pinterest' | 'threads' | 'bluesky' | 'x';
+  export type VideoPlatform = 'tiktok' | 'instagram' | 'youtube' | 'linkedin' | 'facebook' | 'pinterest' | 'threads' | 'bluesky' | 'x' | 'google_business';
 
   /** Supported platforms for photo upload */
-  export type PhotoPlatform = 'tiktok' | 'instagram' | 'linkedin' | 'facebook' | 'pinterest' | 'threads' | 'reddit' | 'bluesky' | 'x';
+  export type PhotoPlatform = 'tiktok' | 'instagram' | 'linkedin' | 'facebook' | 'pinterest' | 'threads' | 'reddit' | 'bluesky' | 'x' | 'google_business';
 
   /** Supported platforms for text upload */
-  export type TextPlatform = 'x' | 'linkedin' | 'facebook' | 'threads' | 'reddit' | 'bluesky';
+  export type TextPlatform = 'x' | 'linkedin' | 'facebook' | 'threads' | 'reddit' | 'bluesky' | 'google_business';
 
   /** TikTok privacy levels */
   export type TikTokPrivacyLevel = 'PUBLIC_TO_EVERYONE' | 'MUTUAL_FOLLOW_FRIENDS' | 'FOLLOWER_OF_CREATOR' | 'SELF_ONLY';
@@ -35,7 +35,7 @@ declare module 'upload-post' {
   export type FacebookVideoState = 'PUBLISHED' | 'DRAFT';
 
   /** Facebook media type */
-  export type FacebookMediaType = 'REELS' | 'STORIES';
+  export type FacebookMediaType = 'REELS' | 'STORIES' | 'VIDEO';
 
   /** X (Twitter) reply settings */
   export type XReplySettings = 'everyone' | 'following' | 'mentionedUsers' | 'subscribers' | 'verified';
@@ -43,8 +43,8 @@ declare module 'upload-post' {
   // ==================== Common Options ====================
 
   export interface CommonUploadOptions {
-    /** Post title/caption */
-    title: string;
+    /** Post title/caption. Required for YouTube, Reddit, and text posts. Optional for TikTok, Instagram, Facebook, LinkedIn, X, Threads, Bluesky, Pinterest. */
+    title?: string;
     /** User identifier (profile name) */
     user: string;
     /** First comment to post after publishing */
@@ -57,6 +57,8 @@ declare module 'upload-post' {
     timezone?: string;
     /** Add to posting queue instead of immediate post */
     addToQueue?: boolean;
+    /** Maximum number of posts allowed per queue slot (overrides profile setting). Only used when addToQueue is true. */
+    maxPostsPerSlot?: number;
     /** Process upload asynchronously (default: true) */
     asyncUpload?: boolean;
 
@@ -210,6 +212,8 @@ declare module 'upload-post' {
     facebookVideoState?: FacebookVideoState;
     /** Media type */
     facebookMediaType?: FacebookMediaType;
+    /** Thumbnail URL for normal page videos (only when facebookMediaType is 'VIDEO') */
+    thumbnailUrl?: string;
   }
 
   export interface FacebookPhotoOptions {
@@ -276,6 +280,8 @@ declare module 'upload-post' {
     xTaggedUserIds?: string | string[];
     /** Location place ID */
     xPlaceId?: string;
+    /** Comma-separated image layout for thread (e.g. "4,4" or "2,3,1"). Each value 1-4, total must equal image count. */
+    xThreadImageLayout?: string;
   }
 
   export interface XTextOptions extends XBaseOptions {
@@ -298,6 +304,8 @@ declare module 'upload-post' {
   export interface ThreadsOptions {
     /** Post long text as single post (vs thread) */
     threadsLongTextAsPost?: boolean;
+    /** Comma-separated list of how many media items per Threads post (e.g. "5,5"). Each value 1-10, total must equal file count. */
+    threadsThreadMediaLayout?: string;
   }
 
   // ==================== Reddit Options ====================
@@ -337,12 +345,22 @@ declare module 'upload-post' {
     platforms: PhotoPlatform[];
   }
 
+  export interface LinkPreviewOptions {
+    /** Generic URL for link preview card (works for LinkedIn, Bluesky, Facebook). Platform-specific params take priority. */
+    linkUrl?: string;
+    /** URL for link preview card on LinkedIn */
+    linkedinLinkUrl?: string;
+    /** URL for external embed link preview on Bluesky */
+    blueskyLinkUrl?: string;
+  }
+
   export interface UploadTextOptions extends CommonUploadOptions,
     LinkedInOptions,
     FacebookTextOptions,
     XTextOptions,
     ThreadsOptions,
-    RedditOptions {
+    RedditOptions,
+    LinkPreviewOptions {
     /** Target platforms */
     platforms: TextPlatform[];
   }
@@ -364,6 +382,8 @@ declare module 'upload-post' {
     timezone?: string;
     /** Add to posting queue */
     addToQueue?: boolean;
+    /** Maximum number of posts allowed per queue slot (overrides profile setting). Only used when addToQueue is true. */
+    maxPostsPerSlot?: number;
     /** Process upload asynchronously */
     asyncUpload?: boolean;
   }
@@ -495,6 +515,12 @@ declare module 'upload-post' {
      */
     getStatus(requestId: string): Promise<StatusResponse>;
 
+    /**
+     * Get the status of a scheduled or queued upload by job ID
+     * @param jobId - The job_id from a scheduled or queued upload
+     */
+    getJobStatus(jobId: string): Promise<StatusResponse>;
+
     /**
      * Get upload history
      * @param options - Query options
@@ -506,7 +532,62 @@ declare module 'upload-post' {
      * @param profileUsername - Profile username
      * @param options - Query options
      */
-    getAnalytics(profileUsername: string, options?: { platforms?: string[] }): Promise<AnalyticsResponse>;
+    getAnalytics(profileUsername: string, options?: { platforms?: string[]; pageId?: string; pageUrn?: string }): Promise<AnalyticsResponse>;
+
+    /**
+     * Get total impressions for a profile from daily snapshots
+     * @param profileUsername - Profile username
+     * @param options - Query options
+     */
+    getTotalImpressions(profileUsername: string, options?: {
+      period?: 'last_day' | 'last_week' | 'last_month' | 'last_3months' | 'last_year';
+      startDate?: string;
+      endDate?: string;
+      date?: string;
+      platforms?: string[];
+      breakdown?: boolean;
+      metrics?: string[];
+    }): Promise<{
+      success: boolean;
+      profile_username: string;
+      start_date: string;
+      end_date: string;
+      total_impressions?: number;
+      metrics?: Record<string, number>;
+      per_platform?: Record<string, number | Record<string, number>>;
+      per_day?: Record<string, number | Record<string, number>>;
+      platforms_filter?: string[];
+    }>;
+
+    /**
+     * Get analytics for a specific post across all platforms
+     * @param requestId - The request_id from the upload
+     */
+    getPostAnalytics(requestId: string): Promise<{
+      success: boolean;
+      post: { request_id: string; profile_username: string; post_title: string; post_caption: string; media_type: string; upload_timestamp: string };
+      platforms: Record<string, {
+        success: boolean;
+        platform_post_id?: string;
+        post_url?: string;
+        post_metrics?: Record<string, number>;
+        post_metrics_source?: string;
+        post_metrics_error?: string;
+        profile_snapshot_at_post_date?: Record<string, number>;
+        profile_snapshot_latest?: Record<string, number>;
+        profile_snapshot_latest_date?: string;
+        error_message?: string;
+      }>;
+    }>;
+
+    /**
+     * Get available metrics configuration for all supported platforms
+     */
+    getPlatformMetrics(): Promise<Record<string, {
+      primary_impressions_field: string;
+      available_metrics: string[];
+      metric_labels: Record<string, string>;
+    }>>;
 
     // Scheduled Posts
     /**
@@ -555,6 +636,10 @@ declare module 'upload-post' {
       logoImage?: string;
       redirectButtonText?: string;
       platforms?: string[];
+      showCalendar?: boolean;
+      readonlyCalendar?: boolean;
+      connectTitle?: string;
+      connectDescription?: string;
     }): Promise<JwtResponse>;
 
     /**

package/index.js

@@ -29,7 +29,8 @@ export class UploadPost {
       method,
       url: `${this.baseUrl}${endpoint}`,
       headers: {
-        'Authorization': `Apikey ${this.apiKey}`
+        'Authorization': `Apikey ${this.apiKey}`,
+        'X-Upload-Post-Source': 'npm',
       },
       maxContentLength: Infinity,
       maxBodyLength: Infinity
@@ -62,7 +63,7 @@ export class UploadPost {
    */
   _addCommonParams(form, options) {
     form.append('user', options.user);
-    form.append('title', options.title);
+    if (options.title) form.append('title', options.title);
 
     // Platforms
     const platforms = Array.isArray(options.platforms) ? options.platforms : [options.platforms];
@@ -74,6 +75,7 @@ export class UploadPost {
     if (options.scheduledDate) form.append('scheduled_date', options.scheduledDate);
     if (options.timezone) form.append('timezone', options.timezone);
     if (options.addToQueue !== undefined) form.append('add_to_queue', String(options.addToQueue));
+    if (options.maxPostsPerSlot !== undefined) form.append('max_posts_per_slot', String(options.maxPostsPerSlot));
     if (options.asyncUpload !== undefined) form.append('async_upload', String(options.asyncUpload));
 
     // Platform-specific title overrides
@@ -103,6 +105,24 @@ export class UploadPost {
     if (options.youtubeFirstComment) form.append('youtube_first_comment', options.youtubeFirstComment);
     if (options.redditFirstComment) form.append('reddit_first_comment', options.redditFirstComment);
     if (options.blueskyFirstComment) form.append('bluesky_first_comment', options.blueskyFirstComment);
+    if (options.linkedinFirstComment) form.append('linkedin_first_comment', options.linkedinFirstComment);
+
+    if (options.firstCommentMedia) {
+      const mediaItems = Array.isArray(options.firstCommentMedia) ? options.firstCommentMedia : [options.firstCommentMedia];
+      for (const mediaItem of mediaItems) {
+        if (typeof mediaItem === 'string') {
+          if (mediaItem.toLowerCase().startsWith('http://') || mediaItem.toLowerCase().startsWith('https://')) {
+            form.append('first_comment_media[]', mediaItem);
+          } else {
+            if (fs.existsSync(mediaItem)) {
+              form.append('first_comment_media[]', createReadStream(mediaItem));
+            }
+          }
+        } else {
+          form.append('first_comment_media[]', mediaItem);
+        }
+      }
+    }
   }
 
   /**
@@ -175,9 +195,12 @@ export class UploadPost {
    * Add LinkedIn-specific parameters
    * @private
    */
-  _addLinkedinParams(form, options) {
+  _addLinkedinParams(form, options, isText = false) {
     if (options.linkedinVisibility) form.append('visibility', options.linkedinVisibility);
     if (options.targetLinkedinPageId) form.append('target_linkedin_page_id', options.targetLinkedinPageId);
+    if (isText && (options.linkedinLinkUrl || options.linkUrl)) {
+      form.append('linkedin_link_url', options.linkedinLinkUrl || options.linkUrl);
+    }
   }
 
   /**
@@ -190,6 +213,7 @@ export class UploadPost {
     if (isVideo) {
       if (options.facebookVideoState) form.append('video_state', options.facebookVideoState);
       if (options.facebookMediaType) form.append('facebook_media_type', options.facebookMediaType);
+      if (options.thumbnailUrl) form.append('thumbnail_url', options.thumbnailUrl);
     }
     
     if (isText && options.facebookLinkUrl) {
@@ -235,6 +259,7 @@ export class UploadPost {
         ids.forEach(id => form.append('tagged_user_ids[]', id));
       }
       if (options.xPlaceId) form.append('place_id', options.xPlaceId);
+      if (options.xThreadImageLayout) form.append('x_thread_image_layout', options.xThreadImageLayout);
     } else {
       if (options.xPostUrl) form.append('post_url', options.xPostUrl);
       if (options.xCardUri) form.append('card_uri', options.xCardUri);
@@ -255,15 +280,20 @@ export class UploadPost {
    */
   _addThreadsParams(form, options) {
     if (options.threadsLongTextAsPost !== undefined) form.append('threads_long_text_as_post', String(options.threadsLongTextAsPost));
+    if (options.threadsThreadMediaLayout) form.append('threads_thread_media_layout', options.threadsThreadMediaLayout);
+    if (options.threadsTopicTag) form.append('threads_topic_tag', options.threadsTopicTag);
   }
 
   /**
    * Add Reddit-specific parameters
    * @private
    */
-  _addRedditParams(form, options) {
+  _addRedditParams(form, options, isText = false) {
     if (options.redditSubreddit) form.append('subreddit', options.redditSubreddit);
     if (options.redditFlairId) form.append('flair_id', options.redditFlairId);
+    if (isText && (options.redditLinkUrl || options.linkUrl)) {
+      form.append('reddit_link_url', options.redditLinkUrl || options.linkUrl);
+    }
   }
 
   /**
@@ -326,8 +356,9 @@ export class UploadPost {
    * Facebook options:
    * @param {string} [options.facebookPageId] - Facebook Page ID
    * @param {string} [options.facebookVideoState] - PUBLISHED or DRAFT
-   * @param {string} [options.facebookMediaType] - REELS or STORIES
-   * 
+   * @param {string} [options.facebookMediaType] - REELS, STORIES, or VIDEO
+   * @param {string} [options.thumbnailUrl] - Thumbnail URL for normal page videos (VIDEO type only)
+   *
    * Pinterest options:
    * @param {string} [options.pinterestBoardId] - Board ID
    * @param {string} [options.pinterestLink] - Destination link
@@ -347,14 +378,16 @@ export class UploadPost {
    * 
    * Threads options:
    * @param {boolean} [options.threadsLongTextAsPost] - Post long text as single post (vs thread)
-   * 
+   * @param {string} [options.threadsThreadMediaLayout] - Comma-separated list of how many media items per Threads post (e.g. "5,5")
+   * @param {string} [options.threadsTopicTag] - Topic tag for the Threads post (1-50 chars, no periods or ampersands)
+   *
    * @returns {Promise<Object>} API response with request_id for async uploads
    */
   async upload(videoPathOrUrl, options) {
     const form = new FormData();
 
     // Handle video (file path or URL)
-    if (videoPathOrUrl.toLowerCase().startsWith('http://') || videoPathOrUrl.toLowerCase().startsWith('https://')) {
+    if (typeof videoPathOrUrl === 'string' && (videoPathOrUrl.toLowerCase().startsWith('http://') || videoPathOrUrl.toLowerCase().startsWith('https://'))) {
       form.append('video', videoPathOrUrl);
     } else {
       if (!fs.existsSync(videoPathOrUrl)) {
@@ -424,14 +457,16 @@ export class UploadPost {
    * @param {boolean} [options.xNullcast] - Promoted-only post
    * @param {string|string[]} [options.xTaggedUserIds] - User IDs to tag
    * @param {boolean} [options.xLongTextAsPost] - Post long text as single post
-   * 
+   *
    * Threads options:
    * @param {boolean} [options.threadsLongTextAsPost] - Post long text as single post
-   * 
+   * @param {string} [options.threadsThreadMediaLayout] - Comma-separated list of how many media items per Threads post (e.g. "5,5")
+   * @param {string} [options.threadsTopicTag] - Topic tag for the Threads post (1-50 chars, no periods or ampersands)
+   *
    * Reddit options:
    * @param {string} [options.redditSubreddit] - Subreddit name (without r/)
    * @param {string} [options.redditFlairId] - Flair template ID
-   * 
+   *
    * @returns {Promise<Object>} API response
    */
   async uploadPhotos(photosPathsOrUrls, options) {
@@ -476,13 +511,18 @@ export class UploadPost {
    * @param {string} [options.timezone] - Timezone for scheduled date
    * @param {boolean} [options.addToQueue] - Add to posting queue
    * @param {boolean} [options.asyncUpload=true] - Process upload asynchronously
-   * 
+   * @param {string} [options.linkUrl] - Generic URL for link preview card (works for LinkedIn, Bluesky, Facebook). Platform-specific params take priority.
+   *
    * LinkedIn options:
    * @param {string} [options.targetLinkedinPageId] - Page ID for organization posts
-   * 
+   * @param {string} [options.linkedinLinkUrl] - URL to attach as link preview on LinkedIn
+   *
+   * Bluesky options:
+   * @param {string} [options.blueskyLinkUrl] - URL to attach as external embed link preview on Bluesky
+   *
    * Facebook options:
    * @param {string} [options.facebookPageId] - Facebook Page ID
-   * @param {string} [options.facebookLinkUrl] - URL to attach as link preview
+   * @param {string} [options.facebookLinkUrl] - URL to attach as link preview on Facebook
    * 
    * X (Twitter) options:
    * @param {string} [options.xReplySettings] - Who can reply
@@ -493,27 +533,35 @@ export class UploadPost {
    * @param {string} [options.xPollReplySettings] - Who can reply to poll
    * @param {string} [options.xCardUri] - Card URI for Twitter Cards
    * @param {boolean} [options.xLongTextAsPost] - Post long text as single post
-   * 
+   *
    * Threads options:
    * @param {boolean} [options.threadsLongTextAsPost] - Post long text as single post
-   * 
+   * @param {string} [options.threadsThreadMediaLayout] - Comma-separated list of how many media items per Threads post (e.g. "5,5")
+   * @param {string} [options.threadsTopicTag] - Topic tag for the Threads post (1-50 chars, no periods or ampersands)
+   *
    * Reddit options:
    * @param {string} [options.redditSubreddit] - Subreddit name (without r/)
    * @param {string} [options.redditFlairId] - Flair template ID
-   * 
+   *
    * @returns {Promise<Object>} API response
    */
   async uploadText(options) {
     const form = new FormData();
-    
+
     this._addCommonParams(form, options);
-    
+
+    // Generic link_url support
+    if (options.linkUrl) form.append('link_url', options.linkUrl);
+
     const platforms = Array.isArray(options.platforms) ? options.platforms : [options.platforms];
-    if (platforms.includes('linkedin')) this._addLinkedinParams(form, options);
+    if (platforms.includes('linkedin')) this._addLinkedinParams(form, options, true);
     if (platforms.includes('facebook')) this._addFacebookParams(form, options, false, true);
     if (platforms.includes('x')) this._addXParams(form, options, true);
     if (platforms.includes('threads')) this._addThreadsParams(form, options);
-    if (platforms.includes('reddit')) this._addRedditParams(form, options);
+    if (platforms.includes('reddit')) this._addRedditParams(form, options, true);
+    if (platforms.includes('bluesky') && (options.blueskyLinkUrl || options.linkUrl)) {
+      form.append('bluesky_link_url', options.blueskyLinkUrl || options.linkUrl);
+    }
 
     return this._request('/upload_text', 'POST', form, true);
   }
@@ -539,7 +587,7 @@ export class UploadPost {
     const form = new FormData();
 
     // Handle document (file path or URL)
-    if (documentPathOrUrl.toLowerCase().startsWith('http://') || documentPathOrUrl.toLowerCase().startsWith('https://')) {
+    if (typeof documentPathOrUrl === 'string' && (documentPathOrUrl.toLowerCase().startsWith('http://') || documentPathOrUrl.toLowerCase().startsWith('https://'))) {
       form.append('document', documentPathOrUrl);
     } else {
       if (!fs.existsSync(documentPathOrUrl)) {
@@ -557,6 +605,7 @@ export class UploadPost {
     if (options.scheduledDate) form.append('scheduled_date', options.scheduledDate);
     if (options.timezone) form.append('timezone', options.timezone);
     if (options.addToQueue !== undefined) form.append('add_to_queue', String(options.addToQueue));
+    if (options.maxPostsPerSlot !== undefined) form.append('max_posts_per_slot', String(options.maxPostsPerSlot));
     if (options.asyncUpload !== undefined) form.append('async_upload', String(options.asyncUpload));
 
     this._addLinkedinParams(form, options);
@@ -576,6 +625,16 @@ export class UploadPost {
     return this._request('/uploadposts/status', 'GET', { request_id: requestId });
   }
 
+  /**
+   * Get the status of a scheduled or queued upload by job ID
+   *
+   * @param {string} jobId - The job_id from a scheduled or queued upload
+   * @returns {Promise<Object>} Upload status
+   */
+  async getJobStatus(jobId) {
+    return this._request('/uploadposts/status', 'GET', { job_id: jobId });
+  }
+
   /**
    * Get upload history
    * 
@@ -593,20 +652,73 @@ export class UploadPost {
 
   /**
    * Get analytics for a profile
-   * 
+   *
    * @param {string} profileUsername - Profile username
    * @param {Object} [options] - Query options
-   * @param {string[]} [options.platforms] - Filter by platforms (instagram, linkedin, facebook, x)
-   * @returns {Promise<Object>} Analytics data
+   * @param {string[]} [options.platforms] - Filter by platforms (instagram, linkedin, facebook, x, youtube, tiktok, threads, pinterest, reddit)
+   * @param {string} [options.pageId] - Facebook Page ID (required for Facebook analytics)
+   * @param {string} [options.pageUrn] - LinkedIn page URN (defaults to "me" for personal profile)
+   * @returns {Promise<Object>} Analytics data per platform
    */
   async getAnalytics(profileUsername, options = {}) {
     const params = {};
     if (options.platforms && options.platforms.length > 0) {
       params.platforms = options.platforms.join(',');
     }
+    if (options.pageId) params.page_id = options.pageId;
+    if (options.pageUrn) params.page_urn = options.pageUrn;
     return this._request(`/analytics/${encodeURIComponent(profileUsername)}`, 'GET', params);
   }
 
+  /**
+   * Get total impressions for a profile from daily snapshots
+   *
+   * @param {string} profileUsername - Profile username
+   * @param {Object} [options] - Query options
+   * @param {string} [options.period] - Period shortcut: last_day, last_week, last_month, last_3months, last_year
+   * @param {string} [options.startDate] - Start date in YYYY-MM-DD format
+   * @param {string} [options.endDate] - End date in YYYY-MM-DD format
+   * @param {string} [options.date] - Single date in YYYY-MM-DD format
+   * @param {string[]} [options.platforms] - Filter by platforms
+   * @param {boolean} [options.breakdown] - Include per-platform and per-day breakdown
+   * @param {string[]} [options.metrics] - Specific metrics to aggregate (e.g., ['likes', 'comments', 'shares'])
+   * @returns {Promise<Object>} Total impressions data
+   */
+  async getTotalImpressions(profileUsername, options = {}) {
+    const params = {};
+    if (options.period) params.period = options.period;
+    if (options.startDate) params.start_date = options.startDate;
+    if (options.endDate) params.end_date = options.endDate;
+    if (options.date) params.date = options.date;
+    if (options.platforms && options.platforms.length > 0) {
+      params.platform = options.platforms.join(',');
+    }
+    if (options.breakdown) params.breakdown = 'true';
+    if (options.metrics && options.metrics.length > 0) {
+      params.metrics = options.metrics.join(',');
+    }
+    return this._request(`/uploadposts/total-impressions/${encodeURIComponent(profileUsername)}`, 'GET', params);
+  }
+
+  /**
+   * Get analytics for a specific post across all platforms it was published to
+   *
+   * @param {string} requestId - The request_id from the upload
+   * @returns {Promise<Object>} Post analytics with per-platform metrics
+   */
+  async getPostAnalytics(requestId) {
+    return this._request(`/uploadposts/post-analytics/${encodeURIComponent(requestId)}`, 'GET');
+  }
+
+  /**
+   * Get available metrics configuration for all supported platforms
+   *
+   * @returns {Promise<Object>} Platform metrics config (primary fields, available metrics, labels)
+   */
+  async getPlatformMetrics() {
+    return this._request('/uploadposts/platform-metrics', 'GET');
+  }
+
   // ==================== Scheduled Posts ====================
 
   /**
@@ -685,6 +797,10 @@ export class UploadPost {
    * @param {string} [options.logoImage] - Logo image URL for the linking page
    * @param {string} [options.redirectButtonText] - Text for redirect button
    * @param {string[]} [options.platforms] - Platforms to show for connection
+   * @param {boolean} [options.showCalendar] - Whether to show the calendar view
+   * @param {boolean} [options.readonlyCalendar] - Show only a read-only calendar (no editing, no account connection)
+   * @param {string} [options.connectTitle] - Custom title for the connection page
+   * @param {string} [options.connectDescription] - Custom description for the connection page
    * @returns {Promise<Object>} JWT and connection URL
    */
   async generateJwt(username, options = {}) {
@@ -693,6 +809,10 @@ export class UploadPost {
     if (options.logoImage) body.logo_image = options.logoImage;
     if (options.redirectButtonText) body.redirect_button_text = options.redirectButtonText;
     if (options.platforms && options.platforms.length > 0) body.platforms = options.platforms;
+    if (options.showCalendar !== undefined) body.show_calendar = options.showCalendar;
+    if (options.readonlyCalendar !== undefined) body.readonly_calendar = options.readonlyCalendar;
+    if (options.connectTitle) body.connect_title = options.connectTitle;
+    if (options.connectDescription) body.connect_description = options.connectDescription;
     return this._request('/uploadposts/users/generate-jwt', 'POST', body);
   }
 
@@ -740,6 +860,30 @@ export class UploadPost {
     const params = profile ? { profile } : {};
     return this._request('/uploadposts/pinterest/boards', 'GET', params);
   }
+
+  /**
+   * Get Google Business Profile locations for a connected account
+   *
+   * @param {string} [profile] - Profile username
+   * @returns {Promise<Object>} List of Google Business locations
+   */
+  async getGoogleBusinessLocations(profile) {
+    const params = profile ? { profile } : {};
+    return this._request('/uploadposts/google-business/locations', 'GET', params);
+  }
+
+  /**
+   * Select a specific Google Business Profile location for a profile
+   *
+   * @param {string} locationId - The location ID to select (e.g. "accounts/123/locations/456")
+   * @param {string} [profile] - Profile username
+   * @returns {Promise<Object>} Selection result with google_business_id and display_name
+   */
+  async selectGoogleBusinessLocation(locationId, profile) {
+    const data = { location_id: locationId };
+    if (profile) data.profile = profile;
+    return this._request('/uploadposts/google-business/locations/select', 'POST', data);
+  }
 }
 
 // Default export for CommonJS compatibility

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "upload-post",
-  "version": "2.0.3",
+  "version": "2.1.0",
   "description": "Official client library for Upload-Post API - Cross-platform social media upload for TikTok, Instagram, YouTube, LinkedIn, Facebook, Pinterest, Threads, Reddit, Bluesky, and X (Twitter)",
   "main": "index.js",
   "types": "index.d.ts",