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)
npm install upload-postOfficial 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.
``bash`
npm install upload-post
`javascript
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);
`
- ✅ 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
`javascript`
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'],
});
`javascript`
// 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',
}
);
`javascript`
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',
});
`javascript`
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
});
For async uploads, check the status using the request_id:
`javascript`
const status = await client.getStatus('request_id_from_upload');
console.log(status);
`javascript`
const history = await client.getHistory({ page: 1, limit: 20 });
console.log(history.uploads);
`javascript
// 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');
`
`javascript
// 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'],
});
`
`javascript`
const analytics = await client.getAnalytics('my-profile', {
platforms: ['instagram', 'tiktok'],
});
console.log(analytics);
`javascript
// 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');
`
- 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$3
- tiktokAutoAddMusic - Auto add music
- tiktokPhotoCoverIndex - Index of photo for cover (0-based)
- tiktokDisableComment - Disable comments$3
- 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$3
- 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)$3
- linkedinVisibility - PUBLIC, CONNECTIONS, LOGGED_IN, CONTAINER
- targetLinkedinPageId - Page ID for organization posts$3
- facebookPageId - Facebook Page ID (required)
- facebookVideoState - PUBLISHED, DRAFT
- facebookMediaType - REELS, STORIES
- facebookLinkUrl - URL for text posts$3
- pinterestBoardId - Board ID
- pinterestLink - Destination link
- pinterestAltText - Alt text for photos
- pinterestCoverImageUrl - Cover image URL (video)
- pinterestCoverImageKeyFrameTime - Key frame time in ms$3
- 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$3
- threadsLongTextAsPost - Post long text as single post (vs thread)$3
- redditSubreddit - Subreddit name (without r/)
- redditFlairId - Flair template IDCommon 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 |
| asyncUpload | Process asynchronously (default: true) |TypeScript Support
Full TypeScript support with comprehensive type definitions:
`typescript
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
javascript
try {
const response = await client.upload('./video.mp4', options);
console.log('Upload successful:', response);
} catch (error) {
console.error('Upload failed:', error.message);
}
``- Upload-Post Website
- API Documentation
- Dashboard
MIT