Skip to main content

API Reference

The Upload-Post API provides comprehensive endpoints for content management across multiple social media platforms. All endpoints require authentication via API key in the Authorization header.

Core Upload APIs​

Video Upload API​

Upload videos to TikTok, Instagram, LinkedIn, YouTube, Facebook, X (Twitter), Threads, and Pinterest. Supports both synchronous and asynchronous uploads with scheduling capabilities.

Endpoint: POST /api/upload_videos

Supported Platforms: TikTok, Instagram, LinkedIn, YouTube, Facebook, X (Twitter), Threads, Pinterest

Photo Upload API​

Upload photos and image carousels to LinkedIn, Facebook, X (Twitter), Instagram, TikTok, Threads, and Pinterest. Perfect for visual content distribution across platforms.

Endpoint: POST /api/upload_photos

Supported Platforms: LinkedIn, Facebook, X (Twitter), Instagram, TikTok, Threads, Pinterest

Text Upload API​

Create and distribute text-only posts across social platforms. Ideal for announcements, updates, and text-based content.

Endpoint: POST /api/upload_text

Supported Platforms: X (Twitter), LinkedIn, Facebook, Threads, Reddit

Upload Management APIs​

Upload Status​

Track the progress and results of asynchronous uploads initiated with async_upload=true. Essential for monitoring long-running upload operations.

Endpoint: GET /api/uploadposts/status

Use Case: Check status of background uploads, get detailed results per platform

Upload History​

Retrieve a paginated history of all your past uploads across platforms. Includes detailed metadata, success/failure status, and platform-specific information.

Endpoint: GET /api/uploadposts/history

Features: Pagination, filtering, comprehensive upload metadata

Schedule Management​

Schedule posts for future publication across supported platforms. Manage your content calendar programmatically.

Endpoint: Various scheduling endpoints

Supported Platforms: X (Twitter), LinkedIn, Facebook, Instagram, TikTok

Platform Integration APIs​

Analytics API​

Retrieve detailed analytics and performance metrics for your social media profiles across connected platforms.

Endpoint: GET /api/analytics/{profile_username}

Supported Platforms: Instagram, LinkedIn, Facebook, X (Twitter)

Metrics: Followers, impressions, reach, profile views, time-series data

Get Facebook Pages​

Retrieve all Facebook pages accessible through connected accounts. Required for posting to specific Facebook pages.

Endpoint: GET /api/uploadposts/facebook/pages

Returns: Page IDs, names, profile pictures, account associations

Get LinkedIn Pages​

Fetch LinkedIn company pages associated with your connected accounts. Essential for business page posting.

Endpoint: GET /api/uploadposts/linkedin/pages

Returns: Organization URNs, company names, vanity URLs, page logos

Get Pinterest Boards​

List all Pinterest boards (public and secret) from connected accounts. Required for targeting specific boards when pinning content.

Endpoint: GET /api/uploadposts/pinterest/boards

Returns: Board IDs, names, associated Pinterest accounts

User Management APIs​

User Profiles API​

Manage user profiles and generate JWTs for linking social accounts when integrating Upload-Post into your own platform. Essential for white-label integrations and multi-user applications.

Endpoints:

  • POST /api/uploadposts/users - Create user profiles
  • GET /api/uploadposts/users - Retrieve user profiles
  • DELETE /api/uploadposts/users - Delete user profiles
  • POST /api/uploadposts/users/generate-jwt - Generate authentication tokens
  • POST /api/uploadposts/users/validate-jwt - Validate tokens

See the User Profile Integration Guide for implementation workflow.

Content Requirements​

Photo Requirements​

Comprehensive format specifications, file size limits, aspect ratios, and technical requirements for photo uploads across all supported platforms.

Covers: Instagram, TikTok, Facebook, X (Twitter), LinkedIn, Threads, Pinterest, Reddit

Video Requirements​

Detailed video format requirements, codec specifications, resolution limits, and encoding guidelines for optimal compatibility across platforms.

Covers: TikTok, Instagram, YouTube, LinkedIn, Facebook, X (Twitter), Threads, Pinterest

Includes: FFmpeg re-encoding solutions for compatibility issues

Getting Started​

  1. Authentication: All requests require an API key in the Authorization: Apikey your-api-key-here header
  2. Base URL: https://api.upload-post.com/api
  3. Rate Limits: Free tier includes 10 uploads per month
  4. Content Guidelines: Review platform-specific requirements before uploading

For implementation examples and integration guides, see our SDK Examples and Integration Guides.