Skip to main content

Channels

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

List Connected Channels​

GET /channels

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

Headers​

NameTypeDescription
X-API-KeystringYour 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).
  • Pinterest: Pins (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 youtube.channels array 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 instagram.accounts array 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 tiktok.accounts array 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 linkedin.accounts array 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 pinterest.accounts array 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 within the platform-specific nested configuration:

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

# Step 2: Use the channelId/accountId in your upload via nested config
curl -X POST https://api.xenonflare.com/media/videos \
  -H "X-API-Key: your_api_key" \
  -F "[email protected]" \
  -F "platforms=[\"youtube\"]" \
  -F "youtube={\"channels\": [\"UC...\"], \"autoPublish\": true}"

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.