upload-post

Upload-Post SDK for Node.js

Official Node.js client for the Upload-Post API - Cross-platform social media upload.

Upload videos, photos, text posts, and documents to TikTok, Instagram, YouTube, LinkedIn, Facebook, Pinterest, Threads, Reddit, Bluesky, and X (Twitter) with a single API.

Installation

npm install upload-post

Quick Start

import { UploadPost } from 'upload-post';

const client = new UploadPost('YOUR_API_KEY');

// Upload a video to multiple platforms
const response = await client.upload('./video.mp4', {
  title: 'Check out this awesome video! 🎬',
  user: 'my-profile',
  platforms: ['tiktok', 'instagram', 'youtube']
});

console.log(response);

Features

• ✅ Video Upload - TikTok, Instagram, YouTube, LinkedIn, Facebook, Pinterest, Threads, Bluesky, X
• ✅ Photo Upload - TikTok, Instagram, LinkedIn, Facebook, Pinterest, Threads, Reddit, Bluesky, X
• ✅ Text Posts - X, LinkedIn, Facebook, Threads, Reddit, Bluesky
• ✅ Document Upload - LinkedIn (PDF, PPT, PPTX, DOC, DOCX)
• ✅ Scheduling - Schedule posts for later
• ✅ Posting Queue - Add posts to your configured queue
• ✅ First Comments - Auto-post first comment after publishing
• ✅ Analytics - Get engagement metrics
• ✅ Full TypeScript Support

API Reference

Upload Video

const response = await client.upload('./video.mp4', {
  title: 'My awesome video',
  user: 'my-profile',
  platforms: ['tiktok', 'instagram', 'youtube'],
  
  // Optional: Schedule for later
  scheduledDate: '2024-12-25T10:00:00Z',
  timezone: 'Europe/Madrid',
  
  // Optional: Add first comment
  firstComment: 'Thanks for watching! 🙏',
  
  // Optional: Platform-specific settings
  tiktokPrivacyLevel: 'PUBLIC_TO_EVERYONE',
  instagramMediaType: 'REELS',
  youtubePrivacyStatus: 'public',
  youtubeTags: ['tutorial', 'coding'],
});

Upload Photos

// Upload single or multiple photos
const response = await client.uploadPhotos(
  ['./photo1.jpg', './photo2.jpg', 'https://example.com/photo3.jpg'],
  {
    title: 'Check out these photos! 📸',
    user: 'my-profile',
    platforms: ['instagram', 'facebook', 'x'],
    
    // Optional: Add to queue instead of posting immediately
    addToQueue: true,
    
    // Platform-specific
    instagramMediaType: 'IMAGE', // or 'STORIES'
    facebookPageId: 'your-page-id',
  }
);

Upload Text Posts

const response = await client.uploadText({
  title: 'Just shipped a new feature! 🚀 Check it out at example.com',
  user: 'my-profile',
  platforms: ['x', 'linkedin', 'threads'],
  
  // Optional: Create a poll on X
  xPollOptions: ['Option A', 'Option B', 'Option C'],
  xPollDuration: 1440, // 24 hours in minutes
  
  // Optional: Post to a LinkedIn company page
  targetLinkedinPageId: 'company-page-id',
});

Upload Documents (LinkedIn)

const response = await client.uploadDocument('./presentation.pdf', {
  title: 'Q4 2024 Report',
  user: 'my-profile',
  description: 'Check out our latest quarterly results!',
  linkedinVisibility: 'PUBLIC',
  targetLinkedinPageId: 'company-page-id', // Optional: post to company page
});

Check Upload Status

For async uploads, check the status using the request_id:

const status = await client.getStatus('request_id_from_upload');
console.log(status);

For scheduled or queued posts, check the status using the job_id:

const status = await client.getJobStatus('job_id_from_scheduled_post');
console.log(status);

Get Upload History

const history = await client.getHistory({ page: 1, limit: 20 });
console.log(history.uploads);

Scheduled Posts

// List all scheduled posts
const scheduled = await client.listScheduled();

// Edit a scheduled post
await client.editScheduled('job-id', {
  scheduledDate: '2024-12-26T15:00:00Z',
  timezone: 'America/New_York',
});

// Cancel a scheduled post
await client.cancelScheduled('job-id');

User Management

// List all profiles
const users = await client.listUsers();

// Create a new profile
await client.createUser('new-profile');

// Delete a profile
await client.deleteUser('old-profile');

// Generate JWT for platform integration (white-label)
const jwt = await client.generateJwt('my-profile', {
  redirectUrl: 'https://yourapp.com/callback',
  platforms: ['tiktok', 'instagram'],
});

Get Analytics

const analytics = await client.getAnalytics('my-profile', {
  platforms: ['instagram', 'tiktok'],
});
console.log(analytics);

Helper Methods

// Get Facebook pages for a profile
const fbPages = await client.getFacebookPages('my-profile');

// Get LinkedIn pages for a profile
const liPages = await client.getLinkedinPages('my-profile');

// Get Pinterest boards for a profile
const boards = await client.getPinterestBoards('my-profile');

Platform-Specific Options

TikTok (Video)

• tiktokPrivacyLevel - PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY
• tiktokDisableDuet - Disable duet
• tiktokDisableComment - Disable comments
• tiktokDisableStitch - Disable stitch
• tiktokCoverTimestamp - Timestamp in ms for cover
• tiktokIsAigc - AI-generated content flag
• tiktokPostMode - DIRECT_POST or MEDIA_UPLOAD
• brandContentToggle - Branded content toggle
• brandOrganicToggle - Brand organic toggle

TikTok (Photos)

• tiktokAutoAddMusic - Auto add music
• tiktokPhotoCoverIndex - Index of photo for cover (0-based)
• tiktokDisableComment - Disable comments

Instagram

• instagramMediaType - REELS, STORIES, IMAGE
• instagramShareToFeed - Share to feed (for Reels/Stories)
• instagramCollaborators - Comma-separated collaborator usernames
• instagramCoverUrl - Custom cover URL
• instagramAudioName - Audio track name
• instagramUserTags - Comma-separated user tags
• instagramLocationId - Location ID
• instagramThumbOffset - Thumbnail offset

YouTube

• youtubeTags - Array or comma-separated tags
• youtubeCategoryId - Category ID (default: "22" People & Blogs)
• youtubePrivacyStatus - public, unlisted, private
• youtubeEmbeddable - Allow embedding
• youtubeLicense - youtube, creativeCommon
• youtubePublicStatsViewable - Show public stats
• youtubeThumbnailUrl - Custom thumbnail URL
• youtubeSelfDeclaredMadeForKids - Made for kids (COPPA)
• youtubeContainsSyntheticMedia - AI/synthetic content flag
• youtubeDefaultLanguage - Title/description language (BCP-47)
• youtubeDefaultAudioLanguage - Audio language (BCP-47)
• youtubeAllowedCountries / youtubeBlockedCountries - Country restrictions
• youtubeHasPaidProductPlacement - Paid placement flag
• youtubeRecordingDate - Recording date (ISO 8601)

LinkedIn

• linkedinVisibility - PUBLIC, CONNECTIONS, LOGGED_IN, CONTAINER
• targetLinkedinPageId - Page ID for organization posts

Facebook

• facebookPageId - Facebook Page ID (required)
• facebookVideoState - PUBLISHED, DRAFT
• 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

• pinterestBoardId - Board ID
• pinterestLink - Destination link
• pinterestAltText - Alt text for photos
• pinterestCoverImageUrl - Cover image URL (video)
• pinterestCoverImageKeyFrameTime - Key frame time in ms

X (Twitter)

• xReplySettings - everyone, following, mentionedUsers, subscribers, verified
• xNullcast - Promoted-only post
• xTaggedUserIds - User IDs to tag
• xPlaceId / xGeoPlaceId - Location place ID
• xQuoteTweetId - Tweet ID to quote
• xPollOptions - Poll options (2-4)
• xPollDuration - Poll duration in minutes (5-10080)
• xForSuperFollowersOnly - Exclusive for super followers
• xCommunityId - Community ID
• 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/)
• redditFlairId - Flair template ID

Common Options

These options work across all upload methods:

Option	Description
title	Post title/caption (required)
user	Profile name (required)
platforms	Target platforms array (required)
firstComment	First comment to post
altText	Alt text for accessibility
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

Full TypeScript support with comprehensive type definitions:

import { UploadPost, UploadVideoOptions, UploadResponse } from 'upload-post';

const client = new UploadPost('YOUR_API_KEY');

const options: UploadVideoOptions = {
  title: 'My video',
  user: 'my-profile',
  platforms: ['tiktok', 'instagram'],
  tiktokPrivacyLevel: 'PUBLIC_TO_EVERYONE',
};

const response: UploadResponse = await client.upload('./video.mp4', options);

Error Handling

try {
  const response = await client.upload('./video.mp4', options);
  console.log('Upload successful:', response);
} catch (error) {
  console.error('Upload failed:', error.message);
}

Links

• Upload-Post Website
• API Documentation
• Dashboard

License

MIT