Connecting TikTok

Connect your TikTok account to bluekona.ai and discover AI-powered insights about your video performance, audience engagement, and content strategy.

Prerequisites

Account Requirements

• TikTok Business Account (formerly TikTok Pro)
• Active TikTok profile with published videos
• Account in good standing (not banned or restricted)

Converting to Business Account

If you have a personal TikTok account, you'll need to switch to Business (it's free):

1. Open TikTok app
2. Go to Profile
3. Tap Menu (three lines) → Settings and privacy
4. Select Account
5. Tap Switch to Business Account
6. Choose your business category
7. Complete the setup

Benefits of Business Account:

• ✅ Access to analytics
• ✅ API access for tools like bluekona.ai
• ✅ Commercial music library
• ✅ Additional features for creators
• ✅ Keeps all your followers and videos

Connection Process

Step 1: Initiate Connection

From your bluekona.ai dashboard:

1. Navigate to Settings > Social Connections or
2. Click Connect Platform
3. Select TikTok
4. Click Connect TikTok

Step 2: TikTok OAuth Authorization

You'll be redirected to TikTok's official authorization page:

1. Log in to TikTok

   • Enter your credentials or authenticate
   • Or use phone number login

2. Review Permissions

   • TikTok shows what bluekona.ai is requesting
   • All permissions are read-only

3. Authorize Application

   • Review the requested scopes
   • Click Authorize or Confirm
   • Agree to terms if prompted

Step 3: Permissions Requested

bluekona.ai requests these read-only permissions via TikTok Marketing API:

TikTok API Scopes

• user.info.basic - Access basic profile information
• video.list - View your published videos
• video.insights - Read video analytics and metrics
• user.insights - Access account-level analytics

What these permissions allow:

• Retrieve account information (username, bio, followers)
• Access video list and metadata
• Read video performance metrics (views, likes, shares)
• View audience demographics
• Track follower growth

What we CANNOT do:

• Upload or post videos
• Delete or edit your videos
• Comment or interact with other users
• Follow or unfollow accounts
• Access private messages
• Modify account settings

Step 4: Complete Connection

After authorization:

1. You're redirected back to bluekona.ai
2. Success message confirms connection
3. TikTok account appears in connected platforms
4. Initial data sync begins (2-5 minutes)

What Data is Collected?

Account Metrics

• Username and display name
• Profile bio and description
• Follower count
• Following count
• Total video count
• Profile views

Video Performance (Last 14 Days)

• Individual video metrics
• Views and reach
• Likes, comments, shares
• Video completion rate
• Average watch time
• Traffic sources
• Audience territories

Content Analysis

• Video captions and descriptions
• Hashtags used
• Sounds and music
• Video length
• Posting times
• Content categories

Audience Insights

• Demographics (age, gender)
• Geographic locations
• Active times
• Follower growth trends
• Audience interests

Understanding the Dashboard

After connecting, your TikTok account appears in Social Connections:

Status Indicators

• Connected (Green) - Active and syncing data
• Syncing - Retrieving latest videos
• Token Valid - Authorization active
• Token Expired (Orange) - Needs reconnection
• Error (Red) - Connection issue

Account Display

• Profile picture
• Username (@handle)
• Follower count
• Total videos
• Last sync time
• Connection status

Quick Actions

• View Analytics - Jump to TikTok insights
• Refresh Data - Manual sync
• Reconnect - Update authorization
• Disconnect - Remove connection

Token Management

TikTok access tokens have varying expiration periods based on TikTok's API policies.

Token Expiration

• Tokens typically expire after 30-90 days
• Varies based on API access level
• Platform security updates may affect tokens

When Token Expires

• Status changes to "Expired"
• You receive a notification
• Cannot run new audits
• Historical data remains safe

Reconnecting

1. Click Reconnect button
2. Re-authorize through TikTok OAuth
3. Connection restored
4. Resume audits immediately

Running TikTok Audits

Single Platform Audit

1. Go to Dashboard or Analysis
2. Click Start Single Platform Audit
3. Select TikTok
4. Audit analyzes your recent videos
5. Results ready in 3-5 minutes

The AI analyzes:

• Video performance patterns
• Best performing content types
• Optimal posting times
• Trending audio usage
• Hashtag effectiveness
• Hook effectiveness (first 3 seconds)
• Completion rates
• Audience engagement patterns
• For You Page (FYP) success factors

Cross-Platform Audit

With multiple platforms connected:

1. Click Start Cross-Platform Audit
2. TikTok analyzed alongside other platforms
3. Compare short-form performance (TikTok vs Instagram Reels vs YouTube Shorts)
4. Identify content adaptation opportunities

Content Types Analyzed

Standard Videos

• Videos up to 10 minutes
• Various lengths and formats
• Different content themes

Key metrics:

• Total views
• Unique viewers
• Average watch time
• Completion rate
• Engagement rate

Short-Form Content

• 15-60 second videos
• Quick entertainment or info
• Trend participation

Key metrics:

• FYP exposure
• Share rate
• Replay rate
• Time spent on video

Long-Form Content

• Videos over 1 minute
• Educational or storytelling content
• In-depth topics

Key metrics:

• Watch time
• Retention curve
• Engagement throughout video
• Follower conversion

Trending Content

• Videos using trending sounds
• Challenge participation
• Hashtag trends

Key metrics:

• Trend participation effectiveness
• Virality potential
• Audience growth from trends

Troubleshooting

Connection Issues

"Must have Business Account"

• Switch from personal to Business account
• Go to TikTok Settings → Account → Switch to Business
• Then retry connection in bluekona.ai

"Authorization failed"

• Grant all requested permissions
• Don't skip permission screens
• Try different browser
• Clear cache and retry

"Account not found"

• Verify account is active and published
• Check you're logged into correct TikTok account
• Ensure account is not banned or restricted

"Region not supported"

• TikTok API availability varies by region
• Some countries have limited API access
• Check TikTok's API availability for your location

Data Issues

No videos showing:

• Ensure you have published videos in last 14 days
• Wait 5-10 minutes for initial sync
• Check videos are public (not private)
• Verify Business account is fully activated

Missing analytics:

• New videos need 24-48 hours for full metrics
• Very new Business accounts may have limited data
• Some metrics require minimum view thresholds

Incomplete metrics:

• TikTok API has some limitations
• Not all Studio analytics available via API
• Real-time data may have delays

API Limitations

TikTok's Marketing API has restrictions:

• Limited historical data access
• Rate limits on requests
• Some advanced metrics not available
• Regional API availability differences

Privacy & Security

What We Access

• Public profile information
• Published video content and metadata
• Video analytics and metrics
• Audience insights (aggregated)

What We Don't Access

• Private or draft videos
• Direct messages
• Account password
• Payment information
• Private account interactions

Data Storage

• Video metrics stored for analysis
• OAuth tokens encrypted
• Used only for your insights
• Complies with TikTok's data policies

TikTok API Compliance

bluekona.ai follows:

• TikTok Developer Terms
• Marketing API Guidelines
• Content and Community Guidelines
• Privacy and data protection laws

Disconnecting TikTok

From bluekona.ai

1. Go to Settings > Social Connections
2. Find your TikTok account
3. Click Disconnect or Remove
4. Confirm action

Result:

• Connection removed immediately
• Authorization revoked
• Historical audits preserved
• Can reconnect anytime

From TikTok Settings

Revoke access from TikTok:

1. Open TikTok app
2. Go to Profile → Menu
3. Select Settings and privacy
4. Tap Security and login
5. Select Apps and websites
6. Find bluekona.ai
7. Tap Remove access

Best Practices

For Maximum Insights

• Run audits weekly during growth phases
• Post consistently (3-5 times per week recommended)
• Connect early to track growth trajectory
• Use insights to refine content strategy

Content Strategy

• Test different video lengths
• Experiment with trending sounds vs original audio
• Track hook effectiveness
• Monitor completion rates
• Analyze FYP performance factors

Engagement Optimization

• Focus on videos with high completion rates
• Identify content that drives follows
• Track comment and share rates
• Monitor watch time patterns

Multi-Account Management

• Connect multiple TikTok accounts
• Compare performance across accounts
• Track personal vs brand accounts
• Useful for agency or multi-brand strategies

Understanding TikTok Metrics

Views

Total number of times your video was watched.

Total Watch Time

Cumulative time spent watching your video across all views.

Average Watch Time

Average duration each viewer watched your video.

Completion Rate

Percentage of viewers who watched your entire video.

Traffic Source Territory

Where your views came from (FYP, profile, following feed, search).

Engagement Rate

(Likes + Comments + Shares) ÷ Views × 100

Content Optimization Tips

Based on AI Analysis

Hook Optimization:

• First 3 seconds are critical
• Test different opening strategies
• Monitor retention curves

Sound Selection:

• Trending vs original audio performance
• Sound match with content type
• Audio engagement patterns

Hashtag Strategy:

• Mix of trending and niche hashtags
• Optimal number of hashtags
• Hashtag performance tracking

Posting Timing:

• When your audience is most active
• Timezone considerations
• Day of week patterns

Video Length:

• Optimal length for your content type
• Completion rate by duration
• Audience preferences

Advanced Features

FYP Analysis

• Factors contributing to For You Page exposure
• Content characteristics of FYP-successful videos
• Virality patterns

Trend Participation

• Trending sounds effectiveness
• Challenge participation ROI
• Trend timing strategies

Audience Growth

• Content that drives follows
• Follower retention patterns
• Growth velocity analysis

Completion Rate Optimization

• Where viewers drop off
• Content pacing analysis
• Hook to close optimization

Common Questions

Q: Can I connect a personal account? A: No, you need a TikTok Business Account. Switching is free and keeps all your content.

Q: Will bluekona.ai post videos for me? A: No, we only have read-only access. We cannot upload, edit, or delete videos.

Q: How often should I run audits? A: Weekly for active accounts, bi-weekly for less frequent posters.

Q: Can I see competitor analytics? A: No, you can only analyze accounts you own and have connected.

Q: Does this work with TikTok Creator Fund? A: Yes, Business accounts with Creator Fund can connect normally.

Q: What about TikTok Shop data? A: Currently, bluekona.ai focuses on content performance, not e-commerce metrics.

Next Steps

• Run your first TikTok audit
• Compare with YouTube Shorts and Instagram Reels
• Understanding video metrics
• Manage your connections

Need help? Visit our troubleshooting guide or contact support.