Twitter Retweet Checker

A Twitter Retweet Checker that checks if a specific Twitter user has retweeted a particular tweet. Built with intelligent strategy selection based on tweet age and comprehensive fallback mechanisms.

Features

• Smart Strategy Selection: Automatically adapts checking strategy based on tweet age
• Multiple Authentication Methods: Supports both cookie-based and credential-based login
• Optimized Performance: Uses parallel processing and intelligent batching
• Comprehensive Coverage: Multiple fallback methods ensure maximum accuracy
• Rate Limit Friendly: Built-in delays and smart pagination to respect Twitter's limits
• Detailed Logging: Comprehensive logging for debugging and monitoring

Configuration

Input Schema

The tool accepts the following input parameters:

{
  "username": "twitter_username_to_check",
  "tweet_url": "https://twitter.com/user/status/1234567890",
  "cookies": "cookie_data_or_file_path"
}

Required Cookies

For cookie authentication, ensure you have these essential cookies:

• auth_token (Critical)
• ct0 (Critical)
• twid (Recommended)

Usage Examples

Usage

{
  "username": "elonmusk",
  "tweet_url": "https://twitter.com/twitter/status/1234567890123456789",
  "cookies": ""
}

Smart Strategy Details

For Recent Tweets (≤7 days old)

• Priority: Retweeters list check
• Secondary: Quick timeline scan (200 tweets max)
• Fallback: Enhanced search queries

For Medium-Age Tweets (8-30 days old)

• Priority: Retweeters list check
• Secondary: Smart timeline scan (500 tweets max)
• Optimization: Time-based stopping when reaching older tweets

For Old Tweets (>30 days old)

• Priority: Retweeters list check
• Secondary: Deep timeline scan (up to 2000 tweets)
• Optimization: Intelligent batching and timestamp checking

Output Format

The tool returns a structured result:

{
  "username": "elonmusk",
  "tweet_url": "https://twitter.com/twitter/status/1234567890",
  "has_retweeted": true,
  "execution_time_seconds": 15.23,
  "checked_at": "2024-06-26 10:30:45"
}

Performance Optimization

• Parallel Processing: Multiple checks run concurrently where possible
• Smart Batching: Batch sizes adapt to tweet age and API limits
• Early Termination: Stops as soon as a match is found
• Rate Limit Management: Built-in delays prevent API throttling
• Memory Efficient: Processes data in chunks to handle large datasets

Error Handling

The tool includes comprehensive error handling:

• Authentication Failures: Clear error messages for login issues
• API Rate Limits: Automatic retry with exponential backoff
• Network Issues: Graceful handling of connection problems
• Invalid URLs: Tweet ID extraction validation
• Missing Data: Handles missing or malformed tweet data

Legal & Ethical Usage

• Respect Rate Limits: Don't overwhelm Twitter's servers
• Follow Twitter's Terms: Use in accordance with Twitter's API Terms of Service
• Privacy Considerations: Only check public tweets and interactions
• Responsible Usage: Use for legitimate research, verification, or monitoring purposes

⚖️ Legal Notice

This tool is for educational and analytical purposes only. Users are responsible for complying with Twitter's Terms of Service and applicable laws. The tool should be used respectfully and within reasonable limits.