upload-post 2.6.0 → 2.8.0

package/index.d.ts

@@ -145,6 +145,10 @@ declare module 'upload-post' {
     tiktokDisableComment?: boolean;
     /** Index of photo for cover (0-based) */
     tiktokPhotoCoverIndex?: number;
+    /** Privacy level, e.g. PUBLIC_TO_EVERYONE, SELF_ONLY, MUTUAL_FOLLOW_FRIENDS */
+    tiktokPrivacyLevel?: string;
+    /** Post mode, e.g. DIRECT_POST or MEDIA_UPLOAD (inbox) */
+    tiktokPostMode?: string;
     /** Branded content toggle */
     brandContentToggle?: boolean;
     /** Brand organic toggle */
@@ -782,7 +786,27 @@ declare module 'upload-post' {
     // Instagram Comments
 
     /**
-     * Get comments on an Instagram post
+     * Get comments on a post
+     * @param options - Query options
+     */
+    getPostComments(options: {
+      user: string;
+      platform?: 'instagram' | 'facebook' | 'youtube' | 'linkedin';
+      postId?: string;
+      postUrl?: string;
+      limit?: number;
+      after?: string;
+    }): Promise<{
+      success: boolean;
+      comments?: Array<{
+        id: string;
+        text: string;
+        timestamp: string;
+        user: { id: string; username: string };
+      }>;
+    }>;
+    /**
+     * Get comments on an Instagram post (legacy positional signature)
      * @param user - Profile username
      * @param options - Query options
      */
@@ -800,7 +824,7 @@ declare module 'upload-post' {
      * Send a private reply (DM) to the author of an Instagram comment
      * @param options - Reply options
      */
-    replyToComment(options: { user: string; commentId: string; message: string }): Promise<{
+    replyToComment(options: { user: string; commentId: string; message: string; buttons?: Array<{ title: string; url: string }> }): Promise<{
       success: boolean;
       recipient_id?: string;
       message_id?: string;
@@ -819,6 +843,68 @@ declare module 'upload-post' {
       error?: string;
     }>;
 
+    /**
+     * Create a comment on a post, or reply to an existing comment.
+     * One of postId, postUrl, or commentId is required.
+     * @param options - Comment options
+     */
+    createComment(options: {
+      user: string;
+      platform: 'instagram' | 'facebook' | 'youtube' | 'linkedin';
+      message: string;
+      postId?: string;
+      postUrl?: string;
+      commentId?: string;
+    }): Promise<{
+      success: boolean;
+      id?: string;
+      message?: string;
+      error?: string;
+    }>;
+
+    /**
+     * Delete a comment on a post
+     * @param options - Delete options
+     */
+    deleteComment(options: {
+      user: string;
+      platform: 'instagram' | 'facebook' | 'youtube' | 'linkedin';
+      commentId: string;
+      /** Post identifier (the post URN for LinkedIn) */
+      postId?: string;
+    }): Promise<{
+      success: boolean;
+      message?: string;
+      error?: string;
+    }>;
+
+    // Post Management
+    /**
+     * Retry a failed post. Provide requestId or jobId.
+     * @param options - Retry options
+     */
+    retryPost(options: { requestId?: string; jobId?: string }): Promise<{
+      success: boolean;
+      request_id?: string;
+      job_id?: string;
+      message?: string;
+      error?: string;
+    }>;
+
+    /**
+     * Unpublish (delete) a post from the platform
+     * @param options - Unpublish options
+     */
+    unpublishPost(options: {
+      user: string;
+      platform: 'facebook' | 'youtube' | 'x' | 'linkedin' | 'threads';
+      postId: string;
+    }): Promise<{
+      success: boolean;
+      message?: string;
+      error?: string;
+    }>;
+
     // Helper Endpoints
     /**
      * Get Facebook pages for a profile

package/index.js

@@ -160,13 +160,17 @@ export class UploadPost {
     if (options.brandContentToggle !== undefined) form.append('brand_content_toggle', String(options.brandContentToggle));
     if (options.brandOrganicToggle !== undefined) form.append('brand_organic_toggle', String(options.brandOrganicToggle));
 
+    // Shared by TikTok video AND photo uploads: the backend reads privacy_level and
+    // post_mode for both /upload and /upload_photos. Gating them behind isVideo made
+    // photo carousels always publish as PUBLIC_TO_EVERYONE / DIRECT_POST.
+    if (options.tiktokPrivacyLevel) form.append('privacy_level', options.tiktokPrivacyLevel);
+    if (options.tiktokPostMode) form.append('post_mode', options.tiktokPostMode);
+
     if (isVideo) {
-      if (options.tiktokPrivacyLevel) form.append('privacy_level', options.tiktokPrivacyLevel);
       if (options.tiktokDisableDuet !== undefined) form.append('disable_duet', String(options.tiktokDisableDuet));
       if (options.tiktokDisableStitch !== undefined) form.append('disable_stitch', String(options.tiktokDisableStitch));
       if (options.tiktokCoverTimestamp !== undefined) form.append('cover_timestamp', options.tiktokCoverTimestamp);
       if (options.tiktokIsAigc !== undefined) form.append('is_aigc', String(options.tiktokIsAigc));
-      if (options.tiktokPostMode) form.append('post_mode', options.tiktokPostMode);
     } else {
       // Photo-specific
       if (options.tiktokAutoAddMusic !== undefined) form.append('auto_add_music', String(options.tiktokAutoAddMusic));
@@ -749,7 +753,7 @@ export class UploadPost {
    * @param {Object} [options] - Query options
    * @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)
+   * @param {string} [options.pageUrn] - LinkedIn organization/company page URN or numeric ID. LinkedIn analytics are only available for pages you administer; personal profiles are not supported (LinkedIn exposes no member-level analytics). Defaults to the first administered organization page.
    * @returns {Promise<Object>} Analytics data per platform
    */
   async getAnalytics(profileUsername, options = {}) {
@@ -1023,18 +1027,27 @@ export class UploadPost {
   // ==================== Instagram Comments ====================
 
   /**
-   * Get comments on an Instagram post
+   * Get comments on a post
    *
-   * @param {string} user - Profile username
    * @param {Object} options - Query options
-   * @param {string} [options.postId] - Numeric media ID (provide postId or postUrl)
-   * @param {string} [options.postUrl] - Full Instagram post URL (provide postId or postUrl)
+   * @param {string} options.user - Profile username
+   * @param {string} [options.platform='instagram'] - Platform (instagram, facebook, youtube, linkedin)
+   * @param {string} [options.postId] - Native post/media ID (provide postId or postUrl)
+   * @param {string} [options.postUrl] - Full post URL (provide postId or postUrl)
+   * @param {number} [options.limit] - Max number of comments to return
+   * @param {string} [options.after] - Pagination cursor for the next page
    * @returns {Promise<Object>} Comments data
    */
-  async getPostComments(user, options = {}) {
-    const params = { platform: 'instagram', user };
+  async getPostComments(options = {}) {
+    // Backwards compatibility: getPostComments(user, { postId, postUrl })
+    if (typeof options === 'string') {
+      options = { user: options, ...(arguments[1] || {}) };
+    }
+    const params = { platform: options.platform || 'instagram', user: options.user };
     if (options.postId) params.post_id = options.postId;
     if (options.postUrl) params.post_url = options.postUrl;
+    if (options.limit !== undefined) params.limit = options.limit;
+    if (options.after) params.after = options.after;
     return this._request('/uploadposts/comments', 'GET', params);
   }
 
@@ -1045,15 +1058,19 @@ export class UploadPost {
    * @param {string} options.user - Profile username
    * @param {string} options.commentId - Comment ID from getPostComments
    * @param {string} options.message - Reply message text
+   * @param {Array<{title: string, url: string}>} [options.buttons] - Optional web_url
+   *   buttons (max 3) rendered in the Instagram DM. Each item is `{ title, url }`.
    * @returns {Promise<Object>} Reply result
    */
   async replyToComment(options) {
-    return this._request('/uploadposts/comments/reply', 'POST', {
+    const body = {
       platform: 'instagram',
       user: options.user,
       comment_id: options.commentId,
       message: options.message
-    });
+    };
+    if (options.buttons) body.buttons = options.buttons;
+    return this._request('/uploadposts/comments/reply', 'POST', body);
   }
 
   /**
@@ -1074,6 +1091,90 @@ export class UploadPost {
     });
   }
 
+  /**
+   * Create a comment on a post, or reply to an existing comment
+   *
+   * One of postId, postUrl, or commentId is required. Pass commentId to reply
+   * to an existing comment; pass postId/postUrl to comment on the post itself.
+   *
+   * @param {Object} options - Comment options
+   * @param {string} options.user - Profile username
+   * @param {string} options.platform - Platform (instagram, facebook, youtube, linkedin)
+   * @param {string} options.message - Comment text
+   * @param {string} [options.postId] - Native post/media ID to comment on
+   * @param {string} [options.postUrl] - Full post URL to comment on
+   * @param {string} [options.commentId] - Existing comment ID to reply to
+   * @returns {Promise<Object>} Created comment result
+   */
+  async createComment(options) {
+    const body = {
+      platform: options.platform,
+      user: options.user,
+      message: options.message
+    };
+    if (options.commentId) body.comment_id = options.commentId;
+    if (options.postId) body.post_id = options.postId;
+    if (options.postUrl) body.post_url = options.postUrl;
+    return this._request('/uploadposts/comments/create', 'POST', body);
+  }
+
+  /**
+   * Delete a comment on a post
+   *
+   * @param {Object} options - Delete options
+   * @param {string} options.user - Profile username
+   * @param {string} options.platform - Platform (instagram, facebook, youtube, linkedin)
+   * @param {string} options.commentId - Comment ID to delete
+   * @param {string} [options.postId] - Post identifier (the post URN for LinkedIn)
+   * @returns {Promise<Object>} Deletion result
+   */
+  async deleteComment(options) {
+    const body = {
+      platform: options.platform,
+      user: options.user,
+      comment_id: options.commentId
+    };
+    if (options.postId) body.post_id = options.postId;
+    return this._request('/uploadposts/comments/delete', 'DELETE', body);
+  }
+
+  // ==================== Post Management ====================
+
+  /**
+   * Retry a failed post
+   *
+   * Provide the request_id (from an async upload) or the job_id (from a
+   * scheduled/queued upload).
+   *
+   * @param {Object} options - Retry options
+   * @param {string} [options.requestId] - The request_id of the post to retry
+   * @param {string} [options.jobId] - The job_id of the post to retry
+   * @returns {Promise<Object>} Retry result
+   */
+  async retryPost(options = {}) {
+    const body = {};
+    if (options.requestId) body.request_id = options.requestId;
+    if (options.jobId) body.job_id = options.jobId;
+    return this._request('/uploadposts/posts/retry', 'POST', body);
+  }
+
+  /**
+   * Unpublish (delete) a post from the platform
+   *
+   * @param {Object} options - Unpublish options
+   * @param {string} options.user - Profile username
+   * @param {string} options.platform - Platform (facebook, youtube, x, linkedin, threads)
+   * @param {string} options.postId - Native post ID to unpublish
+   * @returns {Promise<Object>} Unpublish result
+   */
+  async unpublishPost(options) {
+    return this._request('/uploadposts/posts/unpublish', 'POST', {
+      platform: options.platform,
+      user: options.user,
+      post_id: options.postId
+    });
+  }
+
   // ==================== Helper Endpoints ====================
 
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "upload-post",
-  "version": "2.6.0",
+  "version": "2.8.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",