Upload Photos
Upload photos to various social media platforms using this endpoint.
Note: This feature is a work in progress. More parameters and social media platforms will be added in future updates.
Endpoint
POST /api/upload_photo
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. Supported values: tiktok, instagram, linkedin, facebook, x, threads |
| photos[] | Array | Yes | Array of photo files to upload |
| title | String | Yes | Title of the post |
| description | String | No | Caption/description for the photos (this will be used as the post commentary) |
This endpoint supports simultaneous photo uploads to multiple social media platforms.
Platform-Specific Parameters
LinkedIn
| Name | Type | Required | Description | Default |
|---|---|---|---|---|
| visibility | String | No | Visibility setting for the post (accepted value: "PUBLIC") | PUBLIC |
Note: The caption is used as the post commentary; no separate description is accepted.
Facebook
| Name | Type | Required | Description | Default |
|---|---|---|---|---|
| facebook_id | String | Yes | Facebook Page ID where the photos will be posted | - |
Note: The caption is applied only to the first photo uploaded.
X (Twitter)
No additional parameters are supported for photo uploads to X.
Note: For Twitter uploads, specify the platform as "x" in the platform[] array.
TikTok
| Name | Type | Required | Description | Default |
|---|---|---|---|---|
| auto_add_music | Boolean | No | Automatically add background music to photos | false |
| disable_comment | Boolean | No | Disable comments on the post | false |
| branded_content | Boolean | No | Indicate if the post is branded content (requires disclose_commercial=true) | false |
| disclose_commercial | Boolean | No | Disclose the commercial nature of the post (used with branded_content) | false |
Note: Setting branded_content along with disclose_commercial to true will enable specific branded content toggles on TikTok.
Instagram
No platform-specific parameters are required.
Threads
No platform-specific parameters are required.
Example Requests
Upload Photos to Instagram
curl \
-H 'Authorization: Apikey your-api-key-here' \
-F 'photos[]=@/path/to/your/image1.jpg' \
-F 'user="test"' \
-F 'platform[]=instagram' \
-F 'title="My Photo Title"' \
-F 'description="My photo description"' \
-X POST https://api.upload-post.com/api/upload_photos