Music Promotion on TikTok

Labels and artists can use TokPortal to organize TikTok content workflows by country. The API can create bundles, configure videos, include a TikTok sound URL, publish, and read analytics. It does not guarantee trending, virality, sound attribution outcomes, or reach.

Create a music-focused bundle

curl -X POST https://app.tokportal.com/api/ext/bundles \
  -H "X-API-Key: $TOKPORTAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bundle_type": "account_and_videos",
    "platform": "tiktok",
    "country": "US",
    "videos_quantity": 10,
    "title": "Track seed - US",
    "wants_niche_warming": true,
    "niche_warming_instructions": "Music, dance, pop culture, and creator content.",
    "external_ref": "track-summer-vibes-us"
  }'

Reference: Create Bundle

Configure videos with a TikTok sound URL

curl -X PUT https://app.tokportal.com/api/ext/bundles/bnd_abc123/videos/batch \
  -H "X-API-Key: $TOKPORTAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "videos": [
      {
        "position": 1,
        "video_type": "video",
        "description": "Studio clip from the new track #newmusic",
        "target_publish_date": "2026-06-05",
        "video_url": "https://cdn.example.com/music/studio-clip.mp4",
        "tiktok_sound_url": "https://www.tiktok.com/music/example-sound-123456789",
        "external_ref": "summer-vibes-studio-us"
      },
      {
        "position": 2,
        "video_type": "video",
        "description": "Dance idea for the chorus #dance",
        "target_publish_date": "2026-06-07",
        "video_url": "https://cdn.example.com/music/dance-idea.mp4",
        "tiktok_sound_url": "https://www.tiktok.com/music/example-sound-123456789",
        "external_ref": "summer-vibes-dance-us"
      }
    ]
  }'

For TikTok videos, tiktok_sound_url is optional. For TikTok carousels, it is required. See the field reference in Configure Videos.

Roll out by country

POST /bundles/bulk handles one country per request:

for country in US UK FR DE; do
  curl -X POST https://app.tokportal.com/api/ext/bundles/bulk \
    -H "X-API-Key: $TOKPORTAL_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{
      \"accounts_count\": 2,
      \"upload_accounts_count\": 1,
      \"platforms\": [\"tiktok\"],
      \"country\": \"$country\",
      \"videos_per_account\": 8,
      \"wants_niche_warming\": true,
      \"niche_warming_instructions\": \"Music, dance, and creator content.\",
      \"external_ref\": \"track-summer-vibes-$country\"
    }"
done

Reference: Create Bulk

Content ideas that fit the API

• Lyric clips uploaded as video_url
• Dance prompts with tiktok_sound_url
• Behind-the-scenes videos
• Short artist messages localized by country
• Carousel posts where supported by the video configuration contract

Track performance

curl -X GET "https://app.tokportal.com/api/ext/accounts/acc_abc123/analytics/videos?sort_by=views&sort_order=desc" \
  -H "X-API-Key: $TOKPORTAL_API_KEY"

Compare markets with the same metric definitions from Analytics. Treat analytics as measurement, not as a guarantee of future reach.

Related docs: Media Upload, Configure Videos, Analytics, MCP Server.