TweeterLens is a powerful Twitter analytics and visualization tool that helps you explore and analyze any Twitter profile with beautiful, interactive dashboards. Get detailed insights into posting patterns, engagement metrics, and content performance.
- Profile Analysis: Enter any Twitter username to analyze their posting history and engagement patterns
- Detailed Analytics: View engagement metrics, hashtag usage, and interactive heatmaps of activity patterns
- GitHub-Style Contribution Graph: Visualize posting frequency with a beautiful contribution heatmap
- Engagement Metrics: Track likes, retweets, replies, and views with detailed breakdowns
- Posting Patterns: Discover optimal posting times and consistency metrics
- Fast & Efficient: Smart caching and optimized data fetching for quick results
- Shareable Stats: Copy and download visualizations to share on social media
- Server-Side Rendering: Optimized performance with Next.js SSR
Check out the live demo at https://tweeterlens.vercel.app
TweeterLens provides comprehensive analytics including:
- Posting consistency and streaks
- Engagement efficiency metrics
- Optimal posting time analysis
- Content performance insights
- Conversation metrics
- Twitter personality type
- Viral tweet identification
- Source analysis (which apps are used for tweeting)
- Framework: Next.js 15
- Styling: Tailwind CSS
- UI Components: Shadcn UI
- State Management: TanStack Query
- Animation: Framer Motion
- Data Fetching: Social Data API
- Caching: Upstash Redis
- Deployment: Vercel
- Node.js (v18 or newer)
- Bun (recommended) or npm/yarn
- Social Data API key
-
Clone the repository:
git clone https://github.com/UtkarshTheDev/TweeterLens.git cd TweeterLens -
Install dependencies:
bun install # or npm install -
Create a
.env.localfile in the root directory with the following variables:UPSTASH_REDIS_REST_URL=your_upstash_redis_url UPSTASH_REDIS_REST_TOKEN=your_upstash_redis_token -
Start the development server:
bun dev # or npm run dev -
Open http://localhost:3000 in your browser to see the application.
TweeterLens uses the Social Data API to fetch Twitter data. Here's how to get your API key:
- Visit SocialData.tools and sign up for a free account
- Navigate to Dashboard → API Keys
- Copy your API key
- Paste it in the API key input field in the TweeterLens app
- Free tier: The Social Data API provides a limited number of free credits
- Credit calculation: The API provides 1000 tweets for $0.20
- For accounts with 250+ tweets: You may need additional credits. Contact SocialData.tools support and request additional credits based on your tweet count
- Request formula: Request
(Your total tweets ÷ 1000) × $0.20in credits - Best for small creators: TweeterLens works best for accounts with 250-1000 tweets. For larger accounts, consider using Twitter Analytics if you can't get additional credits
- Enter a Twitter username in the search box
- Configure your API key if prompted
- Explore the analytics dashboard with various metrics and visualizations
- Share insights by copying or downloading the visualizations
- Switch between years to analyze posting patterns over time
TweeterLens implements smart caching to minimize API calls:
- Twitter profiles are cached for 8 hours
- Tweets are cached for 8 hours
- Tweet stats are cached for 8 hours
- The app will show cached data when available and only fetch fresh data when necessary
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Social Data API for providing Twitter data access
- Shadcn UI for the beautiful UI components
- Vercel for hosting and deployment
- Next.js for the amazing React framework
- Twitter: @UtkarshTheDev
- GitHub: UtkarshTheDev
Built with ❤️ by Utkarsh