Channels

The Channels API allows you to retrieve a list of your connected social media accounts, which you'll need for targeting specific channels when uploading videos.

List Connected Channels

GET /api/v1/channels

Returns all connected social media accounts (YouTube, Instagram, TikTok, LinkedIn, Pinterest) connected to your XenonFlare account.

Headers

Name	Type	Description
X-API-Key	string	Your API Key.

Response Body

Returns an object containing arrays of connected accounts grouped by platform.

{
  "youtube": [
    {
      "id": "67a2a5f...",
      "channelId": "UC...",
      "title": "My Gaming Channel",
      "thumbnail": "https://..."
    }
  ],
  "instagram": [
    {
      "id": "67a2a6b...",
      "accountId": "1784...",
      "username": "xenonflare_io",
      "thumbnail": "https://..."
    }
  ],
  "tiktok": [
    {
      "id": "67a2a7c...",
      "accountId": "XXXXX",
      "username": "xenonflare_tiktok",
      "thumbnail": "https://..."
    }
  ],
  "linkedin": [
    {
      "id": "67a2a8d...",
      "accountId": "urn:li:person:XXXXX",
      "name": "Jane Doe",
      "thumbnail": "https://..."
    }
  ],
  "pinterest": [
    {
      "id": "67a2a9e...",
      "accountId": "XXXXX",
      "username": "xenonflare_pins",
      "thumbnail": "https://..."
    }
  ]
}

Supported Platforms

• YouTube: Shorts and long-form videos.
• Instagram: Reels and square posts (Image & Video).
• TikTok: Short-form vertical videos.
• LinkedIn: Professional posts (Image & Video).

To connect a new channel:

1. Navigate to Social Channels in settings.
2. Click Add Channel.
3. Select your platform (YouTube, Instagram, TikTok, LinkedIn, or Pinterest).
4. Authorize the application.

Field Descriptions

YouTube Objects:

• id: The internal XenonFlare database ID.
• channelId: The native YouTube Channel ID. Use this value in selectedYoutubeChannels when uploading.
• title: The display name of the channel.
• thumbnail: URL to the channel's profile picture.

Instagram Objects:

• id: The internal XenonFlare database ID.
• accountId: The native Instagram Business Account ID. Use this value in selectedInstagramAccounts when uploading.
• username: The Instagram handle.
• thumbnail: URL to the account's profile picture.

TikTok Objects:

• id: The internal XenonFlare database ID.
• accountId: The native TikTok Account ID. Use this value in selectedTiktokAccounts when uploading.
• username: The TikTok handle.
• thumbnail: URL to the account's avatar.

LinkedIn Objects:

• id: The internal XenonFlare database ID.
• accountId: The native LinkedIn ID (URN). Use this value in selectedLinkedinAccounts when uploading.
• name: The display name of the LinkedIn profile/page.
• thumbnail: URL to the profile picture.

Pinterest Objects:

• id: The internal XenonFlare database ID.
• accountId: The native Pinterest User ID. Use this value in selectedPinterestAccounts when uploading.
• username: The Pinterest handle.
• thumbnail: URL to the profile picture.

Usage Example

To upload a video to specific accounts, first fetch your channels, then use the channelId or accountId values:

# Step 1: Get your channels
curl -X GET https://xenonflare.com/api/v1/channels \
  -H "X-API-Key: your_api_key"

# Step 2: Use the channelId/accountId in your upload
curl -X POST https://xenonflare.com/api/v1/video/upload \
  -H "X-API-Key: your_api_key" \
  -F "[email protected]" \
  -F "platforms=[\"youtube\"]" \
  -F "selectedYoutubeChannels=[\"UC...\"]"

See the Video Upload documentation for more details.

Errors

• 401 Unauthorized: Missing or invalid API key.
• 500 Internal Server Error: An unexpected error occurred on the server.