Twitter API

Search Twitter/X and post tweets. All read functions return users with smart_followers count via Frontrun API.

Setup

Before running any functions, source the prod environment and venv. Use bash -c 'source /home/dev0xx/Documents/repos/tellr/tellrbot_env/prod.env && source /home/dev0xx/Documents/venvs/tellrbot/bin/activate && ...' to wrap commands. NEVER read the env file directly — it contains secrets.

Script location: /home/dev0xx/Documents/repos/tellr/tellrbot-skills/twitter_search.py

Read Functions

1. Search Tweets

python /home/dev0xx/Documents/repos/tellr/tellrbot-skills/twitter_search.py search_tweets "query here"

2. Get User Info

python /home/dev0xx/Documents/repos/tellr/tellrbot-skills/twitter_search.py get_user_info "username"

3. Get User Tweets

python /home/dev0xx/Documents/repos/tellr/tellrbot-skills/twitter_search.py get_user_tweets "username"

4. Get User Mentions

python /home/dev0xx/Documents/repos/tellr/tellrbot-skills/twitter_search.py get_user_mentions "username"

5. Search Users

python /home/dev0xx/Documents/repos/tellr/tellrbot-skills/twitter_search.py search_users "keyword"

Write Functions

IMPORTANT: ALWAYS show the full tweet text to the user and get explicit approval before sending. Never send without confirmation.

6. Send Tweet to Telegram

Sends the tweet draft to the Telegram channel for manual posting. Supports replies and quote tweets.

# Simple tweet
python /home/dev0xx/Documents/repos/tellr/tellrbot-skills/twitter_search.py send_tweet_to_telegram "Hello world"

# Reply to a tweet
python /home/dev0xx/Documents/repos/tellr/tellrbot-skills/twitter_search.py send_tweet_to_telegram "Nice take" --reply-to 1234567890

# Quote a tweet
python /home/dev0xx/Documents/repos/tellr/tellrbot-skills/twitter_search.py send_tweet_to_telegram "Check this out" --quote 1234567890

7. Create Tweet (disabled — for future use)

Directly posts a tweet via Tweepy. Currently not in use — use send_tweet_to_telegram instead.

python /home/dev0xx/Documents/repos/tellr/tellrbot-skills/twitter_search.py create_tweet "text" --reply-to <id> --quote <id>

Output Format

User object (returned by read functions):

{
  "username": "handle",
  "name": "Display Name",
  "followers": 12345,
  "smart_followers": 89,
  "verified": true,
  "bio": "User bio text"
}

Tweet object (returned by search/tweet functions):

{
  "id": "123456789",
  "text": "Tweet content",
  "timestamp": "2026-02-11T12:00:00Z",
  "likes": 42,
  "retweets": 7,
  "replies": 3,
  "views": 1500,
  "author": { "...user object..." }
}