https://github.com/oxnr/twitter-checker
https://github.com/oxnr/twitter-checker
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/oxnr/twitter-checker
- Owner: oxnr
- Created: 2025-06-03T15:57:57.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-06-04T13:00:21.000Z (7 months ago)
- Last Synced: 2025-06-04T17:47:19.360Z (7 months ago)
- Language: TypeScript
- Homepage: https://twitter-checker-six.vercel.app
- Size: 134 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Twitter Username History Checker
A sleek Next.js application to check Twitter/X users' historical usernames and current profile data.
## Features
- 🔍 **Real-time user lookup** - Get current Twitter profile data including followers, bio, verification status
- 📊 **Historical username tracking** - View past usernames (when available)
- ⚡ **Fast autocomplete** - Smart suggestions as you type
- 🎨 **Clean UI** - Modern, responsive design
- 🔒 **Server-side API keys** - Secure environment variable handling
## Tech Stack
- **Next.js 15** - React framework with App Router
- **TypeScript** - Type safety
- **Tailwind CSS** - Styling
- **TwitterAPI.io** - Real-time Twitter data
- **Memory.lol** - Historical username data
## Setup
1. Clone the repository:
```bash
git clone git@github.com:oxnr/twitter-checker.git
cd twitter-checker
```
2. Install dependencies:
```bash
yarn install
```
3. Set up environment variables:
```bash
cp .env.example .env.local
```
4. Get your TwitterAPI.io API key:
- Sign up at [twitterapi.io](https://twitterapi.io)
- Get $1 free credit
- Add your API key to `.env.local`:
```bash
TWITTER_API_IO_KEY=your_api_key_here
```
5. Run the development server:
```bash
yarn dev
```
Visit [http://localhost:3000](http://localhost:3000) to use the app.
## API Endpoints
- `GET /api/search?username=USERNAME` - Search for user with historical data
- `GET /api/twitter-user?username=USERNAME` - Get current user profile
- `GET /api/autocomplete?q=QUERY` - Get username suggestions
## Deployment
### Vercel (Recommended)
1. Push to GitHub
2. Connect repository to Vercel
3. Add environment variables in Vercel dashboard
4. Deploy
Environment variables needed for production:
- `TWITTER_API_IO_KEY` - Your TwitterAPI.io API key
## Cost
- TwitterAPI.io: $0.15 per 1k requests (very affordable)
- Vercel: Free tier available
## Contributing
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request
## License
MIT License