Upload Video

Upload video to various social media platforms using this endpoint.

Endpoint

POST /api/upload

Headers

Name	Value	Description
Authorization	Apikey your-api-key-here	Your API key for authentication

Common Parameters

Name	Type	Required	Description
user	String	Yes	User identifier
platform[]	Array	Yes	Platform(s) to upload to (e.g., "tiktok", "instagram", "linkedin", "youtube", "facebook", "twitter", "threads")
video	File	Yes	The video file to upload (can be a file upload or a video URL)
title	String	Yes	Title of the video

Platform-Specific Parameters

TikTok

For more information about Tiktok API parameters, visit the Tiktok API documentation.

Name	Type	Required	Description	Default
privacy_level	String	No	Privacy setting ("PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "FOLLOWER_OF_CREATOR", "SELF_ONLY")	"PUBLIC_TO_EVERYONE"
disable_duet	Boolean	No	Disable duet feature	false
disable_comment	Boolean	No	Disable comments	false
disable_stitch	Boolean	No	Disable stitch feature	false
cover_timestamp	Integer	No	Timestamp in milliseconds for video cover	1000
brand_content_toggle	Boolean	No	Enable branded content	false
brand_organic	Boolean	No	Enable organic branded content	false
branded_content	Boolean	No	Enable branded content with disclosure	false
brand_organic_toggle	Boolean	No	Enable organic branded content toggle	false
is_aigc	Boolean	No	Indicates if content is AI-generated	false

Instagram

For more information about Instagram API parameters, visit the Instagram Graph API documentation.

Name	Type	Required	Description	Default
media_type	String	No	Type of media ("REELS" or "STORIES")	"REELS"
share_to_feed	Boolean	No	Whether to share to feed	true
collaborators	String	No	Comma-separated list of collaborator usernames	-
cover_url	String	No	URL for custom video cover	-
audio_name	String	No	Name of the audio track	-
user_tags	String	No	Comma-separated list of user tags	-
location_id	String	No	Instagram location ID	-
thumb_offset	String	No	Timestamp offset for video thumbnail	-

LinkedIn

For more information about LinkedIn API parameters, visit the LinkedIn Marketing API documentation.

Name	Type	Required	Description	Default
description	String	No	The user generated commentary for the post	Title param
visibility	String	Yes	Visibility setting ("CONNECTIONS", "PUBLIC", "LOGGED_IN", "CONTAINER")	"PUBLIC"
target_linkedin_page_id	String	No	LinkedIn page ID to upload videos to an organization	"107579166"

YouTube

For more information about YouTube API parameters, visit the YouTube Data API documentation.

Name	Type	Required	Description	Default
description	String	No	Description of the video	Title param
tags	Array	No	Array of tags	[]
categoryId	String	No	Video category	"22"
privacyStatus	String	No	Privacy setting ("public", "unlisted", "private")	"public"
embeddable	Boolean	No	Whether video is embeddable	true
license	String	No	Video license ("youtube", "creativeCommon")	"youtube"
publicStatsViewable	Boolean	No	Whether public stats are viewable	true
madeForKids	Boolean	No	Whether video is made for kids	false

Facebook

For more information about Facebook API parameters, visit the Facebook Graph API documentation.

Name	Type	Required	Description	Default
facebook_page_id	String	Yes	Facebook Page ID where the video will be posted	-
description	String	No	Description of the video	Title param
video_state	String	No	Desired state of the video ("DRAFT", "PUBLISHED", "SCHEDULED")	"PUBLISHED"

Note: For correct posting on Facebook, ensure the Page is directly associated with your personal profile and not managed through a Business Portfolio.

Threads

For more information about Threads API parameters, visit the Threads API documentation.

Name	Type	Required	Description	Default
description	String	No	The user generated commentary for the post	Title param

X (Twitter)

For more information about X API parameters, visit the X API Post Creation documentation.

Name	Type	Required	Description	Default
tagged_user_ids	Array	No	Array of user IDs to tag	[]
reply_settings	String	No	Who can reply ("following", "mentionedUsers", "everyone")	"following"
nullcast	Boolean	No	Whether to publish without broadcasting	false
place_id	String	No	Location place ID	-
poll_duration	Integer	No	Poll duration in minutes	1440
poll_options	Array	No	Array of poll options	[]
poll_reply_settings	String	No	Who can reply to poll ("following", "mentionedUsers", "everyone")	"following"

Example Requests

Upload a Video to TikTok

curl \
  -H 'Authorization: Apikey your-api-key-here' \
  -F 'video=@/path/to/your/video.mp4' \
  -F 'title="Your Video Title"' \
  -F 'description="Your video description"' \
  -F 'user="test"' \
  -F 'platform[]=tiktok' \
  -F 'tags[]=hashtag1' \
  -F 'tags[]=hashtag2' \
  -X POST https://api.upload-post.com/api/upload

Upload a Video to YouTube Using URL

curl \
  -H 'Authorization: Apikey your-api-key-here' \
  -F 'video="https://example.com/videos/myvideo.mp4"' \
  -F 'title="Your Video Title"' \
  -F 'description="Your video description"' \
  -F 'user="test"' \
  -F 'platform[]=youtube' \
  -F 'tags[]=tutorial' \
  -F 'tags[]=howto' \
  -F 'categoryId="22"' \
  -X POST https://api.upload-post.com/api/upload