upload-post 1.0.1 → 1.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Upload-Post
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -23,13 +23,44 @@ import { UploadPost } from 'upload-post';
 const uploader = new UploadPost('your-api-key-here');
 
 // Upload video with options
-const result = await uploader.upload('/path/to/video.mp4', {
-  title: 'My Awesome Video',
-  user: 'test-user',
-  platforms: ['tiktok'] // Currently supported platforms
-});
+try {
+  const result = await uploader.upload(
+    '/path/to/your/local/video.mp4', // or "https://example.com/remote/video.mp4"
+    {
+      title: 'My Awesome Video',
+      user: 'test-user',
+      platforms: ['tiktok', 'youtube'],
+      // TikTok specific
+      privacy_level: 'PUBLIC_TO_EVERYONE',
+      disable_comment: false,
+      // YouTube specific
+      description: 'This is a great video about coding.',
+      tags: ['coding', 'nodejs', 'api'],
+      privacyStatus: 'public'
+    }
+  );
+  console.log('Upload successful:', result);
+} catch (error) {
+  console.error('Upload failed:', error.message);
+}
 
-console.log('Upload successful:', result);
+// Example: Upload video from a URL
+try {
+  const resultFromUrl = await uploader.upload(
+    null, // videoPath can be null or undefined if options.video is a URL
+    {
+      video: "https://example.com/remote/another_video.mp4",
+      title: 'Remote Video Fun',
+      user: 'test-user-url',
+      platforms: ['instagram'],
+      media_type: 'REELS',
+      share_to_feed: true
+    }
+  );
+  console.log('Upload from URL successful:', resultFromUrl);
+} catch (error) {
+  console.error('Upload from URL failed:', error.message);
+}
 ```
 
 ## API Documentation
@@ -40,11 +71,183 @@ console.log('Upload successful:', result);
 ### upload()
 `upload(videoPath: string, options: UploadOptions): Promise<object>`
 
-#### Options
-- `videoPath`: Path to video file (MP4, MOV, AVI, etc.)
-- `options.title`: Video title
-- `options.user`: User identifier
-- `options.platforms`: Array of target platforms (currently supports 'tiktok')
+#### Video Upload Options (`UploadOptions`)
+**Common Parameters:**
+- `videoPath`: (Required) Path to your local video file (e.g., MP4, MOV) OR a public URL to a video file. If providing a URL, you can also use the `options.video` field.
+- `options.title`: (Required) Title of the video.
+- `options.user`: (Required) User identifier.
+- `options.platforms`: (Required) Array of target platforms (e.g., `['tiktok', 'youtube', 'instagram']`). Supported: `tiktok`, `instagram`, `linkedin`, `youtube`, `facebook`, `x` (Twitter), `threads`, `pinterest`.
+- `options.video`: (Optional) Public URL of the video file. Use this if `videoPath` is not a local file.
+
+**Platform-Specific Parameters (all optional):**
+
+-   **TikTok:**
+    -   `options.privacy_level`: `'PUBLIC_TO_EVERYONE'`, `'MUTUAL_FOLLOW_FRIENDS'`, `'FOLLOWER_OF_CREATOR'`, or `'SELF_ONLY'`.
+    -   `options.disable_duet`: `boolean`.
+    -   `options.disable_comment`: `boolean`.
+    -   `options.disable_stitch`: `boolean`.
+    -   `options.cover_timestamp`: `number` (milliseconds for video cover).
+    -   `options.brand_content_toggle`: `boolean`.
+    -   `options.brand_organic`: `boolean`.
+    -   `options.branded_content`: `boolean`.
+    -   `options.brand_organic_toggle`: `boolean`.
+    -   `options.is_aigc`: `boolean` (AI-generated content).
+-   **Instagram:**
+    -   `options.media_type`: `'REELS'` or `'STORIES'`. Default: `'REELS'`.
+    -   `options.share_to_feed`: `boolean`.
+    -   `options.collaborators`: `string` (comma-separated usernames).
+    -   `options.cover_url`: `string` (URL for custom video cover).
+    -   `options.audio_name`: `string`.
+    -   `options.user_tags`: `string` (comma-separated user tags).
+    -   `options.location_id`: `string`.
+    -   `options.thumb_offset`: `string` (timestamp offset for thumbnail).
+-   **LinkedIn:**
+    -   `options.description`: `string` (post commentary, defaults to `title`).
+    -   `options.visibility`: `'CONNECTIONS'`, `'PUBLIC'`, `'LOGGED_IN'`, or `'CONTAINER'`. Default: `'PUBLIC'`.
+    -   `options.target_linkedin_page_id`: `string` (LinkedIn page ID for organization uploads).
+-   **YouTube:**
+    -   `options.description`: `string` (video description, defaults to `title`).
+    -   `options.tags`: `string[]` (array of tags).
+    -   `options.categoryId`: `string` (video category ID, default: `"22"`).
+    -   `options.privacyStatus`: `'public'`, `'unlisted'`, or `'private'`. Default: `'public'`.
+    -   `options.embeddable`: `boolean`.
+    -   `options.license`: `'youtube'` or `'creativeCommon'`.
+    -   `options.publicStatsViewable`: `boolean`.
+    -   `options.madeForKids`: `boolean`.
+-   **Facebook:**
+    -   `options.facebook_page_id`: (Required if `facebook` in `platforms`) Facebook Page ID.
+    -   `options.description`: `string` (video description, defaults to `title`).
+    -   `options.video_state`: `'DRAFT'`, `'PUBLISHED'`, or `'SCHEDULED'`. Default: `'PUBLISHED'`.
+-   **Threads:**
+    -   `options.description`: `string` (post commentary, defaults to `title`).
+-   **X (Twitter):**
+    -   `options.tagged_user_ids`: `string[]` (array of user IDs to tag).
+    -   `options.reply_settings`: `'following'`, `'mentionedUsers'`, or `'everyone'`.
+    -   `options.nullcast`: `boolean` (publish without broadcasting).
+    -   `options.place_id`: `string` (location place ID).
+    -   `options.poll_duration`: `number` (poll duration in minutes).
+    -   `options.poll_options`: `string[]` (array of poll options).
+    -   `options.poll_reply_settings`: `'following'`, `'mentionedUsers'`, or `'everyone'` (for poll replies).
+-   **Pinterest:**
+    -   `options.pinterest_board_id`: (Required if `pinterest` in `platforms`) Pinterest board ID.
+    -   `options.pinterest_link`: `string` (destination link for the Pin).
+    -   `options.pinterest_cover_image_url`: `string` (URL for cover image).
+    -   `options.pinterest_cover_image_content_type`: `string` (e.g., `image/jpeg`).
+    -   `options.pinterest_cover_image_data`: `string` (Base64 encoded cover image).
+    -   `options.pinterest_cover_image_key_frame_time`: `number` (milliseconds for video frame to use as cover).
+
+### uploadPhotos()
+`uploadPhotos(photos: string[], options: UploadPhotosOptions): Promise<object>`
+
+Uploads photos to various social media platforms.
+
+#### Photo Upload Options (`UploadPhotosOptions`)
+- `photos`: Array of strings, where each string is a local file path to a photo or a public URL of a photo.
+- `options.user`: (Required) User identifier.
+- `options.platforms`: (Required) Array of target platforms. Supported: `tiktok`, `instagram`, `linkedin`, `facebook`, `x`, `threads`, `pinterest`.
+- `options.title`: (Required) Title of the post.
+- `options.caption`: (Optional) Caption/description for the photos. This will be used as the post commentary.
+
+##### Platform-Specific Parameters (Optional unless stated otherwise):
+
+-   **LinkedIn:**
+    -   `options.visibility`: `'PUBLIC'` - Visibility setting for the post.
+    -   `options.target_linkedin_page_id`: LinkedIn page ID to upload photos to an organization.
+-   **Facebook:**
+    -   `options.facebook_page_id`: (Required if `facebook` in `platforms`) Facebook Page ID.
+-   **TikTok:**
+    -   `options.auto_add_music`: `boolean` - Automatically add background music.
+    -   `options.disable_comment`: `boolean` - Disable comments.
+    -   `options.branded_content`: `boolean` - Indicate branded content (requires `disclose_commercial` to be `true`).
+    -   `options.disclose_commercial`: `boolean` - Disclose commercial nature.
+    -   `options.photo_cover_index`: `number` - Index (0-based) of the photo to use as cover.
+    -   `options.description`: `string` - Description for TikTok (defaults to `title`).
+-   **Instagram:**
+    -   `options.media_type`: `'IMAGE'` or `'STORIES'` - Type of media. Defaults to `'IMAGE'`.
+-   **Pinterest:**
+    -   `options.pinterest_board_id`: (Required if `pinterest` in `platforms`) Pinterest board ID.
+    -   `options.pinterest_alt_text`: `string` - Alt text for the image.
+    -   `options.pinterest_link`: `string` - Destination link for the Pin.
+
+**X (Twitter) and Threads** do not require additional parameters.
+
+#### Example: Uploading Photos
+
+```javascript
+import { UploadPost } from 'upload-post';
+
+const uploader = new UploadPost('your-api-key-here');
+
+// Example: Upload photos to Instagram and Facebook
+try {
+  const photoResult = await uploader.uploadPhotos(
+    ['/path/to/your/image1.jpg', 'https://example.com/images/photo2.jpg'],
+    {
+      user: 'test-user',
+      platforms: ['instagram', 'facebook'],
+      title: 'My Beautiful Photos',
+      caption: 'Check out these amazing shots!',
+      facebook_page_id: 'your-facebook-page-id', // Required for Facebook
+      media_type: 'IMAGE' // Optional for Instagram
+    }
+  );
+  console.log('Photo upload successful:', photoResult);
+} catch (error) {
+  console.error('Photo upload failed:', error.message);
+}
+```
+
+### uploadText()
+`uploadText(options: UploadTextOptions): Promise<object>`
+
+Uploads text-only posts to supported social media platforms.
+
+#### Text Upload Options (`UploadTextOptions`)
+- `options.user`: (Required) User identifier.
+- `options.platforms`: (Required) Array of target platforms. Supported: `'linkedin'`, `'x'` (Twitter), `'facebook'`, `'threads'`.
+- `options.title`: (Required) The text content for the post. This field is used as the main content for all specified platforms.
+
+##### Platform-Specific Parameters:
+-   **LinkedIn:**
+    -   `options.target_linkedin_page_id`: (Optional) LinkedIn page ID to upload text to an organization's page. If not provided, posts to the user's personal profile.
+-   **Facebook:**
+    -   `options.facebook_page_id`: (Required if `'facebook'` is in `platforms`) Facebook Page ID where the text will be posted.
+
+**X (Twitter) and Threads** use the common `options.title` for the text content and do not require additional specific parameters for text posts.
+
+#### Example: Uploading a Text Post
+
+```javascript
+import { UploadPost } from 'upload-post';
+
+const uploader = new UploadPost('your-api-key-here');
+
+// Example: Upload a text post to X (Twitter) and LinkedIn
+try {
+  const textResult = await uploader.uploadText({
+    user: 'test-user',
+    platforms: ['x', 'linkedin'],
+    title: 'This is my awesome text post for X and LinkedIn!',
+    target_linkedin_page_id: 'your-linkedin-org-page-id' // Optional: for LinkedIn organization page
+  });
+  console.log('Text post successful:', textResult);
+} catch (error) {
+  console.error('Text post failed:', error.message);
+}
+
+// Example: Upload a text post to a Facebook Page
+try {
+  const fbTextResult = await uploader.uploadText({
+    user: 'test-user-fb',
+    platforms: ['facebook'],
+    title: 'Hello Facebook Page!',
+    facebook_page_id: 'your-facebook-page-id' // Required for Facebook
+  });
+  console.log('Facebook text post successful:', fbTextResult);
+} catch (error) {
+  console.error('Facebook text post failed:', error.message);
+}
+```
 
 ## Error Handling
 The library throws errors for:

package/index.d.ts

@@ -4,8 +4,140 @@ declare module 'upload-post' {
     title: string;
     /** User identifier */
     user: string;
-    /** Array of target platforms */
+    /** Array of target platforms. Supported: tiktok, instagram, linkedin, youtube, facebook, twitter, threads, pinterest */
     platforms: string[];
+    /** The video file to upload (can be a file upload or a video URL) */
+    video?: string; // Already handled by videoPath parameter, but good to have for consistency if API supports 'video' form field directly for URLs
+
+    // TikTok specific
+    privacy_level?: 'PUBLIC_TO_EVERYONE' | 'MUTUAL_FOLLOW_FRIENDS' | 'FOLLOWER_OF_CREATOR' | 'SELF_ONLY';
+    disable_duet?: boolean;
+    disable_comment?: boolean; // Note: also a common param for photos on TikTok
+    disable_stitch?: boolean;
+    cover_timestamp?: number;
+    brand_content_toggle?: boolean;
+    brand_organic?: boolean;
+    branded_content?: boolean; // Note: also a common param for photos on TikTok
+    brand_organic_toggle?: boolean;
+    is_aigc?: boolean;
+
+    // Instagram specific
+    media_type?: 'REELS' | 'STORIES'; // Note: also a param for photos, but with different values
+    share_to_feed?: boolean;
+    collaborators?: string; // Comma-separated list
+    cover_url?: string;
+    audio_name?: string;
+    user_tags?: string; // Comma-separated list
+    location_id?: string;
+    thumb_offset?: string;
+
+    // LinkedIn specific
+    description?: string; // Note: also a common param for photos on TikTok & FB videos
+    visibility?: 'CONNECTIONS' | 'PUBLIC' | 'LOGGED_IN' | 'CONTAINER'; // Note: different values than photo visibility
+    target_linkedin_page_id?: string; // Note: also a param for photos
+
+    // YouTube specific
+    // description?: string; // Already listed under LinkedIn, will be used if provided
+    tags?: string[];
+    categoryId?: string;
+    privacyStatus?: 'public' | 'unlisted' | 'private';
+    embeddable?: boolean;
+    license?: 'youtube' | 'creativeCommon';
+    publicStatsViewable?: boolean;
+    madeForKids?: boolean;
+
+    // Facebook specific
+    facebook_page_id?: string; // Note: also a param for photos
+    // description?: string; // Already listed under LinkedIn
+    video_state?: 'DRAFT' | 'PUBLISHED' | 'SCHEDULED';
+
+    // Threads specific
+    // description?: string; // Already listed under LinkedIn
+
+    // X (Twitter) specific
+    tagged_user_ids?: string[];
+    reply_settings?: 'following' | 'mentionedUsers' | 'everyone';
+    nullcast?: boolean;
+    place_id?: string;
+    poll_duration?: number; // in minutes
+    poll_options?: string[];
+    poll_reply_settings?: 'following' | 'mentionedUsers' | 'everyone';
+
+    // Pinterest specific
+    pinterest_board_id?: string; // Note: also a param for photos
+    pinterest_link?: string; // Note: also a param for photos
+    pinterest_cover_image_url?: string;
+    pinterest_cover_image_content_type?: string;
+    pinterest_cover_image_data?: string; // Base64 encoded
+    pinterest_cover_image_key_frame_time?: number; // in milliseconds
+  }
+
+  export interface UploadPhotosOptions {
+    /** User identifier */
+    user: string;
+    /** Array of target platforms. Supported: tiktok, instagram, linkedin, facebook, x, threads, pinterest */
+    platforms: string[];
+    /** Array of photo file paths or URLs */
+    photos: string[];
+    /** Title of the post */
+    title: string;
+    /** Caption/description for the photos (this will be used as the post commentary) */
+    caption?: string;
+
+    // LinkedIn specific
+    /** Visibility setting for the LinkedIn post (accepted value: "PUBLIC") */
+    visibility?: 'PUBLIC';
+    /** LinkedIn page ID to upload photos to an organization */
+    target_linkedin_page_id?: string;
+
+    // Facebook specific
+    /** Facebook Page ID where the photos will be posted */
+    facebook_page_id?: string;
+
+    // TikTok specific
+    /** Automatically add background music to photos */
+    auto_add_music?: boolean;
+    /** Disable comments on the post */
+    disable_comment?: boolean;
+    /** Indicate if the post is branded content (requires disclose_commercial=true) */
+    branded_content?: boolean;
+    /** Disclose the commercial nature of the post (used with branded_content) */
+    disclose_commercial?: boolean;
+    /** Index (starting at 0) of the photo to use as the cover/thumbnail for the TikTok photo post */
+    photo_cover_index?: number;
+    /** Description for the TikTok post. If not provided, the title value will be used by default. */
+    description?: string;
+
+    // Instagram specific
+    /** Type of media ("IMAGE" or "STORIES") */
+    media_type?: 'IMAGE' | 'STORIES';
+
+    // Pinterest specific
+    /** Pinterest board ID to publish the photo to. */
+    pinterest_board_id?: string;
+    /** Alt text for the image. */
+    pinterest_alt_text?: string;
+    /** Destination link for the photo Pin. */
+    pinterest_link?: string;
+  }
+
+  export interface UploadTextOptions {
+    /** User identifier */
+    user: string;
+    /** Array of target platforms. Supported: linkedin, x, facebook, threads */
+    platforms: ('linkedin' | 'x' | 'facebook' | 'threads')[];
+    /** The text content for the post. This will be used as the 'title' parameter for all supported platforms. */
+    title: string;
+
+    // LinkedIn specific
+    /** LinkedIn page ID to upload text to an organization's page. */
+    target_linkedin_page_id?: string;
+
+    // Facebook specific
+    /** Facebook Page ID where the text will be posted. Required if 'facebook' is in platforms. */
+    facebook_page_id?: string;
+
+    // X (Twitter) and Threads do not have additional specific parameters beyond 'title' for the text content.
   }
 
   /**
@@ -24,5 +156,20 @@ declare module 'upload-post' {
      * @returns Promise with API response
      */
     upload(videoPath: string, options: UploadOptions): Promise<object>;
+
+    /**
+     * Upload photos to social media platforms
+     * @param photos - Array of photo file paths or URLs
+     * @param options - Upload photos options
+     * @returns Promise with API response
+     */
+    uploadPhotos(photos: string[], options: UploadPhotosOptions): Promise<object>;
+
+    /**
+     * Upload text posts to social media platforms
+     * @param options - Upload text options
+     * @returns Promise with API response
+     */
+    uploadText(options: UploadTextOptions): Promise<object>;
   }
 }

package/index.js

@@ -7,7 +7,89 @@ import { createReadStream } from 'fs';
  * @typedef {Object} UploadOptions
  * @property {string} title - Video title
  * @property {string} user - User identifier
- * @property {string[]} platforms - Array of platforms (e.g. ['tiktok'])
+ * @property {string[]} platforms - Array of platforms (e.g. ['tiktok', 'youtube', 'instagram'])
+ * @property {string} [video] - The video file to upload (can be a file upload or a video URL) - typically handled by videoPath param.
+ *
+ * @property {'PUBLIC_TO_EVERYONE' | 'MUTUAL_FOLLOW_FRIENDS' | 'FOLLOWER_OF_CREATOR' | 'SELF_ONLY'} [privacy_level] - TikTok: Privacy setting
+ * @property {boolean} [disable_duet] - TikTok: Disable duet feature
+ * @property {boolean} [disable_comment] - TikTok: Disable comments
+ * @property {boolean} [disable_stitch] - TikTok: Disable stitch feature
+ * @property {number} [cover_timestamp] - TikTok: Timestamp in milliseconds for video cover
+ * @property {boolean} [brand_content_toggle] - TikTok: Enable branded content
+ * @property {boolean} [brand_organic] - TikTok: Enable organic branded content
+ * @property {boolean} [branded_content] - TikTok: Enable branded content with disclosure
+ * @property {boolean} [brand_organic_toggle] - TikTok: Enable organic branded content toggle
+ * @property {boolean} [is_aigc] - TikTok: Indicates if content is AI-generated
+ *
+ * @property {'REELS' | 'STORIES'} [media_type] - Instagram: Type of media
+ * @property {boolean} [share_to_feed] - Instagram: Whether to share to feed
+ * @property {string} [collaborators] - Instagram: Comma-separated list of collaborator usernames
+ * @property {string} [cover_url] - Instagram: URL for custom video cover
+ * @property {string} [audio_name] - Instagram: Name of the audio track
+ * @property {string} [user_tags] - Instagram: Comma-separated list of user tags
+ * @property {string} [location_id] - Instagram: Instagram location ID
+ * @property {string} [thumb_offset] - Instagram: Timestamp offset for video thumbnail
+ *
+ * @property {string} [description] - LinkedIn, YouTube, Facebook, Threads: Description or commentary
+ * @property {'CONNECTIONS' | 'PUBLIC' | 'LOGGED_IN' | 'CONTAINER'} [visibility] - LinkedIn: Visibility setting
+ * @property {string} [target_linkedin_page_id] - LinkedIn: Page ID for organization uploads
+ *
+ * @property {string[]} [tags] - YouTube: Array of tags
+ * @property {string} [categoryId] - YouTube: Video category ID
+ * @property {'public' | 'unlisted' | 'private'} [privacyStatus] - YouTube: Privacy setting
+ * @property {boolean} [embeddable] - YouTube: Whether video is embeddable
+ * @property {'youtube' | 'creativeCommon'} [license] - YouTube: Video license
+ * @property {boolean} [publicStatsViewable] - YouTube: Whether public stats are viewable
+ * @property {boolean} [madeForKids] - YouTube: Whether video is made for kids
+ *
+ * @property {string} [facebook_page_id] - Facebook: Page ID
+ * @property {'DRAFT' | 'PUBLISHED' | 'SCHEDULED'} [video_state] - Facebook: Desired state of the video
+ *
+ * @property {string[]} [tagged_user_ids] - X (Twitter): Array of user IDs to tag
+ * @property {'following' | 'mentionedUsers' | 'everyone'} [reply_settings] - X (Twitter): Who can reply
+ * @property {boolean} [nullcast] - X (Twitter): Whether to publish without broadcasting
+ * @property {string} [place_id] - X (Twitter): Location place ID
+ * @property {number} [poll_duration] - X (Twitter): Poll duration in minutes
+ * @property {string[]} [poll_options] - X (Twitter): Array of poll options
+ * @property {'following' | 'mentionedUsers' | 'everyone'} [poll_reply_settings] - X (Twitter): Who can reply to poll
+ *
+ * @property {string} [pinterest_board_id] - Pinterest: Board ID
+ * @property {string} [pinterest_link] - Pinterest: Destination link
+ * @property {string} [pinterest_cover_image_url] - Pinterest: URL of an image to use as the video cover
+ * @property {string} [pinterest_cover_image_content_type] - Pinterest: Content type of the cover image
+ * @property {string} [pinterest_cover_image_data] - Pinterest: Base64 encoded cover image data
+ * @property {number} [pinterest_cover_image_key_frame_time] - Pinterest: Time in ms of video frame for cover
+ */
+
+/**
+ * @typedef {Object} UploadPhotosOptions
+ * @property {string} user - User identifier
+ * @property {string[]} platforms - Array of target platforms. Supported: tiktok, instagram, linkedin, facebook, x, threads, pinterest
+ * @property {string[]} photos - Array of photo file paths or URLs
+ * @property {string} title - Title of the post
+ * @property {string} [caption] - Caption/description for the photos
+ * @property {'PUBLIC'} [visibility] - LinkedIn: Visibility setting ("PUBLIC")
+ * @property {string} [target_linkedin_page_id] - LinkedIn: Page ID for organization uploads
+ * @property {string} [facebook_page_id] - Facebook: Page ID
+ * @property {boolean} [auto_add_music] - TikTok: Automatically add background music
+ * @property {boolean} [disable_comment] - TikTok: Disable comments
+ * @property {boolean} [branded_content] - TikTok: Branded content (requires disclose_commercial=true)
+ * @property {boolean} [disclose_commercial] - TikTok: Disclose commercial nature
+ * @property {number} [photo_cover_index] - TikTok: Index of photo for cover
+ * @property {string} [description] - TikTok: Description (defaults to title)
+ * @property {'IMAGE' | 'STORIES'} [media_type] - Instagram: Media type ("IMAGE" or "STORIES")
+ * @property {string} [pinterest_board_id] - Pinterest: Board ID
+ * @property {string} [pinterest_alt_text] - Pinterest: Alt text
+ * @property {string} [pinterest_link] - Pinterest: Destination link
+ */
+
+/**
+ * @typedef {Object} UploadTextOptions
+ * @property {string} user - User identifier
+ * @property {('linkedin' | 'x' | 'facebook' | 'threads')[]} platforms - Array of target platforms.
+ * @property {string} title - The text content for the post.
+ * @property {string} [target_linkedin_page_id] - LinkedIn: Page ID for organization posts.
+ * @property {string} [facebook_page_id] - Facebook: Page ID. Required if 'facebook' is in platforms.
  */
 
 /**
@@ -38,6 +120,70 @@ export class UploadPost {
       form.append('platform[]', platform);
     });
 
+    // Add platform-specific parameters if they exist in options
+    // TikTok
+    if (options.privacy_level) form.append('privacy_level', options.privacy_level);
+    if (options.disable_duet !== undefined) form.append('disable_duet', options.disable_duet.toString());
+    if (options.disable_comment !== undefined) form.append('disable_comment', options.disable_comment.toString());
+    if (options.disable_stitch !== undefined) form.append('disable_stitch', options.disable_stitch.toString());
+    if (options.cover_timestamp !== undefined) form.append('cover_timestamp', options.cover_timestamp.toString());
+    if (options.brand_content_toggle !== undefined) form.append('brand_content_toggle', options.brand_content_toggle.toString());
+    if (options.brand_organic !== undefined) form.append('brand_organic', options.brand_organic.toString());
+    if (options.branded_content !== undefined) form.append('branded_content', options.branded_content.toString());
+    if (options.brand_organic_toggle !== undefined) form.append('brand_organic_toggle', options.brand_organic_toggle.toString());
+    if (options.is_aigc !== undefined) form.append('is_aigc', options.is_aigc.toString());
+
+    // Instagram
+    if (options.media_type) form.append('media_type', options.media_type); // Used by photos and videos
+    if (options.share_to_feed !== undefined) form.append('share_to_feed', options.share_to_feed.toString());
+    if (options.collaborators) form.append('collaborators', options.collaborators);
+    if (options.cover_url) form.append('cover_url', options.cover_url);
+    if (options.audio_name) form.append('audio_name', options.audio_name);
+    if (options.user_tags) form.append('user_tags', options.user_tags);
+    if (options.location_id) form.append('location_id', options.location_id);
+    if (options.thumb_offset) form.append('thumb_offset', options.thumb_offset);
+    
+    // LinkedIn
+    if (options.description) form.append('description', options.description); // Used by multiple platforms
+    if (options.visibility) form.append('visibility', options.visibility); // Used by multiple platforms
+    if (options.target_linkedin_page_id) form.append('target_linkedin_page_id', options.target_linkedin_page_id);
+
+    // YouTube
+    if (options.tags) options.tags.forEach(tag => form.append('tags[]', tag));
+    if (options.categoryId) form.append('categoryId', options.categoryId);
+    if (options.privacyStatus) form.append('privacyStatus', options.privacyStatus);
+    if (options.embeddable !== undefined) form.append('embeddable', options.embeddable.toString());
+    if (options.license) form.append('license', options.license);
+    if (options.publicStatsViewable !== undefined) form.append('publicStatsViewable', options.publicStatsViewable.toString());
+    if (options.madeForKids !== undefined) form.append('madeForKids', options.madeForKids.toString());
+
+    // Facebook
+    if (options.facebook_page_id) form.append('facebook_page_id', options.facebook_page_id);
+    if (options.video_state) form.append('video_state', options.video_state);
+
+    // X (Twitter)
+    if (options.tagged_user_ids) options.tagged_user_ids.forEach(id => form.append('tagged_user_ids[]', id));
+    if (options.reply_settings) form.append('reply_settings', options.reply_settings);
+    if (options.nullcast !== undefined) form.append('nullcast', options.nullcast.toString());
+    if (options.place_id) form.append('place_id', options.place_id);
+    if (options.poll_duration !== undefined) form.append('poll_duration', options.poll_duration.toString());
+    if (options.poll_options) options.poll_options.forEach(opt => form.append('poll_options[]', opt));
+    if (options.poll_reply_settings) form.append('poll_reply_settings', options.poll_reply_settings);
+    
+    // Pinterest
+    if (options.pinterest_board_id) form.append('pinterest_board_id', options.pinterest_board_id);
+    if (options.pinterest_link) form.append('pinterest_link', options.pinterest_link);
+    if (options.pinterest_cover_image_url) form.append('pinterest_cover_image_url', options.pinterest_cover_image_url);
+    if (options.pinterest_cover_image_content_type) form.append('pinterest_cover_image_content_type', options.pinterest_cover_image_content_type);
+    if (options.pinterest_cover_image_data) form.append('pinterest_cover_image_data', options.pinterest_cover_image_data);
+    if (options.pinterest_cover_image_key_frame_time !== undefined) form.append('pinterest_cover_image_key_frame_time', options.pinterest_cover_image_key_frame_time.toString());
+
+    // If video is passed as a URL in options.video (as per API docs for URL uploads)
+    if (options.video && (options.video.startsWith('http://') || options.video.startsWith('https://'))) {
+        form.append('video', options.video);
+    }
+
+
     try {
       const response = await axios.post(`${this.baseUrl}/upload`, form, {
         headers: {
@@ -57,4 +203,142 @@ export class UploadPost {
       throw new Error(`Upload failed: ${error.message}`);
     }
   }
+
+  /**
+   * Upload photos to social media platforms
+   * @param {string[]} photosPathsOrUrls - Array of photo file paths or URLs
+   * @param {UploadPhotosOptions} options - Upload photos options
+   * @returns {Promise<Object>} API response
+   */
+  async uploadPhotos(photosPathsOrUrls, options) {
+    const form = new FormData();
+
+    // Common parameters
+    form.append('user', options.user);
+    form.append('title', options.title);
+    if (options.caption) {
+      form.append('caption', options.caption);
+    }
+    options.platforms.forEach(platform => {
+      form.append('platform[]', platform);
+    });
+
+    photosPathsOrUrls.forEach(photoItem => {
+      if (typeof photoItem === 'string' && (photoItem.startsWith('http://') || photoItem.startsWith('https://'))) {
+        form.append('photos[]', photoItem); // Pass URL as string
+      } else if (typeof photoItem === 'string') {
+        if (!fs.existsSync(photoItem)) {
+          throw new Error(`Photo file not found: ${photoItem}`);
+        }
+        form.append('photos[]', createReadStream(photoItem)); // Pass file path as stream
+      } else {
+        throw new Error(`Invalid photo item: ${photoItem}. Must be a file path or URL string.`);
+      }
+    });
+    
+    // Platform-specific parameters
+    // LinkedIn
+    if (options.visibility) form.append('visibility', options.visibility);
+    if (options.target_linkedin_page_id) form.append('target_linkedin_page_id', options.target_linkedin_page_id);
+    
+    // Facebook
+    if (options.facebook_page_id) form.append('facebook_page_id', options.facebook_page_id);
+
+    // TikTok
+    if (options.auto_add_music !== undefined) form.append('auto_add_music', options.auto_add_music.toString());
+    if (options.disable_comment !== undefined) form.append('disable_comment', options.disable_comment.toString());
+    if (options.branded_content !== undefined) form.append('branded_content', options.branded_content.toString());
+    if (options.disclose_commercial !== undefined) form.append('disclose_commercial', options.disclose_commercial.toString());
+    if (options.photo_cover_index !== undefined) form.append('photo_cover_index', options.photo_cover_index.toString());
+    if (options.description) form.append('description', options.description);
+
+    // Instagram
+    if (options.media_type) form.append('media_type', options.media_type);
+
+    // Pinterest
+    if (options.pinterest_board_id) form.append('pinterest_board_id', options.pinterest_board_id);
+    if (options.pinterest_alt_text) form.append('pinterest_alt_text', options.pinterest_alt_text);
+    if (options.pinterest_link) form.append('pinterest_link', options.pinterest_link);
+
+    try {
+      const response = await axios.post(`${this.baseUrl}/upload_photos`, form, {
+        headers: {
+          ...form.getHeaders(),
+          'Authorization': `Apikey ${this.apiKey}`
+        },
+        maxContentLength: Infinity,
+        maxBodyLength: Infinity
+      });
+
+      if (response.status !== 200) {
+        throw new Error(`API request failed with status ${response.status}`);
+      }
+
+      return response.data;
+    } catch (error) {
+      let errorMessage = `Photo upload failed: ${error.message}`;
+      if (error.response && error.response.data && error.response.data.message) {
+        errorMessage += ` - ${error.response.data.message}`;
+      } else if (error.response && error.response.data && error.response.data.detail) {
+         errorMessage += ` - ${error.response.data.detail}`;
+      }
+      throw new Error(errorMessage);
+    }
+  }
+
+  /**
+   * Upload text posts to social media platforms
+   * @param {UploadTextOptions} options - Upload text options
+   * @returns {Promise<Object>} API response
+   */
+  async uploadText(options) {
+    const form = new FormData();
+
+    // Common parameters
+    form.append('user', options.user);
+    form.append('title', options.title); // 'title' is used as the text content field for all supported platforms
+
+    options.platforms.forEach(platform => {
+      form.append('platform[]', platform);
+    });
+
+    // Platform-specific parameters
+    // LinkedIn
+    if (options.target_linkedin_page_id && options.platforms.includes('linkedin')) {
+      form.append('target_linkedin_page_id', options.target_linkedin_page_id);
+    }
+
+    // Facebook
+    if (options.facebook_page_id && options.platforms.includes('facebook')) {
+      form.append('facebook_page_id', options.facebook_page_id);
+    }
+    // X (Twitter) and Threads use the common 'title' parameter for their text content.
+
+    try {
+      const response = await axios.post(`${this.baseUrl}/upload_text`, form, {
+        headers: {
+          ...form.getHeaders(),
+          'Authorization': `Apikey ${this.apiKey}`
+        },
+      });
+
+      if (response.status !== 200) {
+        throw new Error(`API request failed with status ${response.status}`);
+      }
+
+      return response.data;
+    } catch (error) {
+      let errorMessage = `Text post upload failed: ${error.message}`;
+      if (error.response && error.response.data) {
+        if (error.response.data.message) {
+          errorMessage += ` - ${error.response.data.message}`;
+        } else if (error.response.data.detail) {
+          errorMessage += ` - ${error.response.data.detail}`;
+        } else {
+          errorMessage += ` - ${JSON.stringify(error.response.data)}`;
+        }
+      }
+      throw new Error(errorMessage);
+    }
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "upload-post",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Official client library for Upload-Post API - cross-platform social media video upload",
   "main": "index.js",
   "types": "index.d.ts",