Connecting X (Twitter)

Step-by-step guide to connecting your X (formerly Twitter) account to bluekona.ai for post analytics and engagement insights.

Connect your X (Twitter) account to bluekona.ai and unlock AI-powered insights about your tweets, engagement, and audience growth.

Prerequisites

Account Requirements

Active X (Twitter) account (Personal or Professional/Business)
Published tweets for analysis
Account in good standing (not suspended or restricted)

Account Types Supported

Personal accounts
Professional accounts
Business accounts
Creator accounts
Verified accounts (Blue/Gold checkmarks)

Good news: Any X account type works - no special requirements!

Connection Process

Step 1: Initiate Connection

From your bluekona.ai dashboard:

Go to Settings > Social Connections or
Click Connect Platform
Select X (Twitter)
Click Connect X

Step 2: OAuth Authorization

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

Log in to X
- Enter your X username/email and password
- Or authenticate if already logged in
Review App Permissions
- X shows what bluekona.ai is requesting
- Review the read-only permissions
Authorize App
- Click Authorize app button
- Confirm you're connecting the correct account

Step 3: Permissions Requested

bluekona.ai requests these read-only permissions via X API v2:

Read Permissions

Read tweets - Access your published posts
Read user profile - View account information
Read engagement metrics - Access likes, retweets, replies
Read follower information - View follower count and growth

What these permissions allow:

Retrieve tweet performance data
Analyze engagement patterns
Track follower growth
View impressions and reach
Access profile information

What we CANNOT do:

Post tweets on your behalf
Delete or edit your tweets
Follow/unfollow accounts
Like, retweet, or reply to tweets
Access direct messages
Change account settings

Step 4: Complete Connection

After authorization:

You're redirected back to bluekona.ai
Success message confirms connection
X account appears in your connected platforms
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 tweet count
Account creation date

Tweet Performance (Last 14 Days)

Individual tweet metrics
Impressions (how many times seen)
Engagement rate
Likes, retweets, replies, bookmarks
Quote tweets
Link clicks
Profile visits from tweets

Engagement Analysis

Tweet types (text, images, videos, links)
Best performing content
Hashtag effectiveness
Mention patterns
Reply conversations

Audience Insights

Follower growth trends
Engagement patterns
Active hours
Tweet frequency analysis

Understanding the Dashboard

After connecting, your X account appears in Social Connections:

Status Indicators

Connected (Green) - Active and collecting data
Syncing - Retrieving latest tweets
Token Valid - Authorization active
Error (Red) - Connection issue

Account Display

Profile picture
Username (@handle)
Display name
Follower count
Last sync time
Connection status

Quick Actions

View Analytics - Jump to X insights
Refresh Data - Manually sync latest tweets
Reconnect - Update authorization
Disconnect - Remove connection

Token Management

X (Twitter) access tokens are generally long-lived and don't expire automatically.

When Tokens Become Invalid

You manually revoke access from X settings
Account password is changed
Account security settings change
X detects unusual activity

Reconnecting

If your token becomes invalid:

Click Reconnect button
Re-authorize through X OAuth
Connection restored immediately
Historical data preserved

Running X Audits

Single Platform Audit

Navigate to Dashboard or Analysis
Click Start Single Platform Audit
Select X (Twitter)
Audit processes your recent tweets
Results ready in 2-5 minutes

The AI analyzes:

Tweet performance by content type
Best times to post
Hashtag strategy effectiveness
Engagement patterns
Content themes that resonate
Reply and conversation quality
Thread performance
Link sharing effectiveness

Cross-Platform Audit

With multiple platforms connected:

Click Start Cross-Platform Audit
X data analyzed alongside other platforms
Identify content that works across channels
Cross-promotion opportunities

Content Types Analyzed

Text Tweets

Plain text posts
Character count optimization
Hook effectiveness

Key metrics:

Impressions
Engagement rate
Replies and conversations

Media Tweets

Images
Videos
GIFs

Key metrics:

Media views
Media engagement rate
Click-through to profile

Link Tweets

Tweets with URLs
Blog post shares
External content

Key metrics:

Link clicks
Impression to click ratio
Engagement despite link

Threads

Multi-tweet threads
Storytelling sequences

Key metrics:

Thread completion rate
Per-tweet engagement
Overall thread performance

Quote Tweets & Retweets

Shared content with commentary
Engagement on shared content

Troubleshooting

Connection Issues

"Unable to authorize app"

Ensure you're logged into the correct X account
Check that your account is not restricted
Try a different browser
Clear cookies and cache

"Authorization denied"

You must approve all permissions
Try connecting again
Ensure you clicked "Authorize app"

"Account not found"

Verify account is active and not suspended
Check that username is correct
Ensure account is public or has tweets

"API rate limit exceeded"

X has API rate limits
Wait 15 minutes and try again
This is temporary

Data Issues

No tweets showing:

Ensure you have published tweets in last 14 days
Wait 5-10 minutes for initial sync
Protected/private accounts may have limited data
Check that tweets are public

Missing engagement metrics:

Some metrics require X Premium features
Very new tweets may not have full data yet
Deleted tweets won't appear

Follower count not updating:

Follower data updates during each audit
Manual refresh available in dashboard
Real-time updates not supported by API

API Limitations

X API v2 has some restrictions:

Historical data limited to recent periods
Rate limits on requests
Some advanced metrics require elevated access
Real-time streaming not available in basic tier

Privacy & Security

What We Access

Public tweets and engagement
Public profile information
Follower counts and growth
Tweet impressions and metrics

What We Don't Access

Direct messages
Protected tweets (unless authorized)
Account password
Payment information
Login sessions

Data Storage

Tweet metrics stored for analysis
OAuth tokens encrypted
Used only for your insights
Complies with X's data policies

X Developer Terms

bluekona.ai complies with:

X API Terms of Service
Developer Agreement
Display Requirements
Privacy standards

Disconnecting X

From bluekona.ai

Go to Settings > Social Connections
Find your X account
Click Disconnect or Remove
Confirm action

Result:

Connection removed immediately
Authorization revoked
Historical audits remain accessible
Can reconnect anytime

From X Settings

You can also revoke access from X:

Log in to X (Twitter)
Go to Settings and privacy
Select Security and account access
Click Apps and sessions
Find bluekona.ai
Click Revoke app permissions

Best Practices

For Maximum Insights

Run audits weekly to track trends
Maintain consistent posting schedule
Connect early to build historical data
Use audits to refine content strategy

Content Strategy

Compare tweet types (text vs media vs links)
Identify optimal posting times
Track hashtag performance
Monitor engagement patterns
Analyze thread effectiveness

Engagement Optimization

Focus on content that drives conversations
Test different formats
Track reply rates
Monitor quote tweet vs retweet ratios

Multiple Accounts

Connect each account separately
Compare performance across accounts
Track brand accounts vs personal accounts
Useful for agency management

Understanding X Metrics

Impressions

Number of times your tweet was viewed. Includes:

Timeline views
Search results
Profile visits
Retweets by others

Engagements

Total interactions with your tweet:

Likes
Retweets
Replies
Link clicks
Profile clicks
Hashtag clicks
Detail expands

Engagement Rate

Percentage calculation: (Engagements ÷ Impressions) × 100

Higher engagement rate indicates content resonates with audience.

Profile Visits

How many users clicked to view your profile from this tweet.

Content Optimization Tips

Based on AI Analysis

Tweet Timing:

Identify when your audience is most active
Schedule important tweets during peak hours
Adjust for timezone differences

Content Format:

Discover which formats perform best
Balance text, media, and link tweets
Test thread vs single tweet performance

Hashtag Strategy:

Find effective hashtags for your niche
Optimal number of hashtags
Trending vs evergreen hashtags

Hook Writing:

First line importance
Character count optimization
Call-to-action effectiveness

Advanced Features

Thread Analysis

Thread completion rates
Best performing tweets in threads
Optimal thread length
Engagement drop-off points

Link Performance

Which external content gets clicks
Link positioning effectiveness
Preview card optimization

Conversation Quality

Reply rate analysis
Quality of engagement
Community building effectiveness

Common Questions

Q: Can I connect multiple X accounts? A: Yes, connect each account separately. Switch between them in your dashboard.

Q: Will bluekona.ai tweet from my account? A: No, we only have read-only access. We cannot post, edit, or delete tweets.

Q: What if I have a protected account? A: Protected accounts can connect, but data access may be limited by X's API.

Q: Do I need X Premium/Blue? A: No, any account type works. Premium accounts may have additional metrics available.

Q: How often is data updated? A: Data syncs when you run an audit or every 24 hours for active connections.

Q: Will this affect my API rate limits? A: bluekona.ai uses its own API access. Your personal rate limits are not affected.

Next Steps

Need help? Visit our troubleshooting guide or contact support.