upload-post 2.1.2 → 2.2.0

package/README.md

@@ -181,6 +181,22 @@ const analytics = await client.getAnalytics('my-profile', {
 console.log(analytics);
 ```
 
+### Get Media
+
+Retrieve recent posts from a connected social account. Supported platforms:
+`instagram`, `tiktok`, `youtube`, `linkedin`, `facebook`, `x`, `threads`,
+`pinterest`, `bluesky`, `reddit`.
+
+```javascript
+const { media } = await client.getMedia('linkedin', 'my-profile');
+
+// Force the personal LinkedIn profile of an account connected as an org admin:
+await client.getMedia('linkedin', 'my-profile', { pageUrn: 'me' });
+
+// Target a specific LinkedIn organization page:
+await client.getMedia('linkedin', 'my-profile', { pageUrn: '12345' });
+```
+
 ### Helper Methods
 
 ```javascript

package/index.d.ts

@@ -192,6 +192,17 @@ declare module 'upload-post' {
     youtubeHasPaidProductPlacement?: boolean;
     /** Recording date (ISO 8601) */
     youtubeRecordingDate?: string;
+    /** Subtitle/caption files to upload. Each entry needs a language code and either a file path or URL. */
+    youtubeSubtitles?: Array<{
+      /** BCP-47 language code (e.g. "en", "es") */
+      language: string;
+      /** Display name for the subtitle track (e.g. "English", "Español") */
+      name?: string;
+      /** Path to the subtitle file (SRT, VTT, SBV, SUB, ASS, SSA, TTML) */
+      file?: string;
+      /** URL to the subtitle file */
+      url?: string;
+    }>;
   }
 
   // ==================== LinkedIn Options ====================
@@ -589,6 +600,28 @@ declare module 'upload-post' {
       metric_labels: Record<string, string>;
     }>>;
 
+    /**
+     * Get recent media from a connected social account.
+     *
+     * @param options.pageUrn - LinkedIn only. Numeric org ID, full org URN, or "me" to force the personal profile.
+     */
+    getMedia(
+      platform: 'instagram' | 'tiktok' | 'youtube' | 'linkedin' | 'facebook' | 'x' | 'threads' | 'pinterest' | 'bluesky' | 'reddit' | string,
+      user: string,
+      options?: { pageUrn?: string }
+    ): Promise<{
+      success: boolean;
+      media: Array<{
+        id: string;
+        caption: string | null;
+        media_type: 'IMAGE' | 'VIDEO' | 'CAROUSEL_ALBUM' | 'TEXT' | string;
+        media_url: string | null;
+        permalink: string | null;
+        timestamp: string | null;
+        thumbnail_url: string | null;
+      }>;
+    }>;
+
     // Scheduled Posts
     /**
      * List scheduled posts

package/index.js

@@ -198,6 +198,24 @@ export class UploadPost {
     if (options.youtubeBlockedCountries) form.append('blockedCountries', options.youtubeBlockedCountries);
     if (options.youtubeHasPaidProductPlacement !== undefined) form.append('hasPaidProductPlacement', String(options.youtubeHasPaidProductPlacement));
     if (options.youtubeRecordingDate) form.append('recordingDate', options.youtubeRecordingDate);
+    if (options.youtubeSubtitles && Array.isArray(options.youtubeSubtitles)) {
+      options.youtubeSubtitles.forEach((sub, idx) => {
+        if (sub.language) {
+          form.append(`youtube_subtitle_language_${idx}`, sub.language);
+          if (sub.name) form.append(`youtube_subtitle_name_${idx}`, sub.name);
+          if (sub.file) {
+            // file can be a string path or a ReadableStream
+            if (typeof sub.file === 'string') {
+              form.append(`youtube_subtitle_file_${idx}`, createReadStream(sub.file));
+            } else {
+              form.append(`youtube_subtitle_file_${idx}`, sub.file);
+            }
+          } else if (sub.url) {
+            form.append(`youtube_subtitle_file_${idx}`, sub.url);
+          }
+        }
+      });
+    }
   }
 
   /**
@@ -744,6 +762,21 @@ export class UploadPost {
     return this._request('/uploadposts/platform-metrics', 'GET');
   }
 
+  /**
+   * Get recent media from a connected social account.
+   *
+   * @param {string} platform - instagram, tiktok, youtube, linkedin, facebook, x, threads, pinterest, bluesky, reddit
+   * @param {string} user - Profile username
+   * @param {Object} [options]
+   * @param {string} [options.pageUrn] - LinkedIn only. Numeric org ID, full URN, or "me" to force the personal profile.
+   * @returns {Promise<Object>}
+   */
+  async getMedia(platform, user, options = {}) {
+    const params = { platform, user };
+    if (options.pageUrn) params.page_urn = options.pageUrn;
+    return this._request('/uploadposts/media', 'GET', params);
+  }
+
   // ==================== Scheduled Posts ====================
 
   /**

package/package.json

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