Skip to main content
View on GitHub → Full Twitter intelligence for autonomous agents. One AISA_API_KEY unlocks every read endpoint; OAuth unlocks write actions (post, like, follow).

​
Install

aisa skills install twitter-autopilot

​
What can agents do with it?

Monitor influencers

“Get Elon Musk’s latest tweets and notify me of AI-related posts.”

Track trends

“What’s trending on Twitter worldwide right now?”

Social listening

“Search for tweets mentioning our product and analyze sentiment.”

Competitor intel

“Monitor @anthropic and @GoogleAI — alert me on new announcements.”

Thread context

“Fetch the full conversation thread around a viral tweet.”

Engagement workflows

“Like, unlike, follow, or unfollow via OAuth (requires user consent).”

​
Core capabilities

  • Users — profile info, “about” metadata, batch lookup by IDs, latest tweets, mentions, followers, followings, verified followers, follow-relationship check, keyword search
  • Tweets — advanced search (Latest/Top), by IDs, replies, quotes, retweeters, full thread context, article extraction
  • Trends — worldwide and regional trending topics by WOEID
  • Lists — members and followers
  • Communities — info, members, moderators, tweets, cross-community search
  • Spaces — Space detail lookup
  • Engagement (OAuth) — like / unlike / follow / unfollow / post / reply / quote via the local relay

​
Quick start

export AISA_API_KEY="your-key"

​
User endpoints

# Profile
curl "https://api.aisa.one/apis/v1/twitter/user/info?userName=elonmusk" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Latest tweets
curl "https://api.aisa.one/apis/v1/twitter/user/last_tweets?userName=elonmusk" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Mentions
curl "https://api.aisa.one/apis/v1/twitter/user/mentions?userName=elonmusk" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Followers / followings
curl "https://api.aisa.one/apis/v1/twitter/user/followers?userName=elonmusk" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Verified followers (note: requires numeric user_id, not userName)
curl "https://api.aisa.one/apis/v1/twitter/user/verifiedFollowers?user_id=44196397" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Follow-relationship check
curl "https://api.aisa.one/apis/v1/twitter/user/check_follow_relationship?source_user_name=elonmusk&target_user_name=BillGates" \
  -H "Authorization: Bearer $AISA_API_KEY"

# User search
curl "https://api.aisa.one/apis/v1/twitter/user/search?query=AI+researcher" \
  -H "Authorization: Bearer $AISA_API_KEY"

​
Tweet endpoints

# Advanced search (queryType is required: Latest or Top)
curl "https://api.aisa.one/apis/v1/twitter/tweet/advanced_search?query=AI+agents&queryType=Latest" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Tweets by IDs
curl "https://api.aisa.one/apis/v1/twitter/tweets?tweet_ids=1895096451033985024" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Replies, quotes, retweeters, thread context
curl "https://api.aisa.one/apis/v1/twitter/tweet/replies?tweetId=1895096451033985024" \
  -H "Authorization: Bearer $AISA_API_KEY"
curl "https://api.aisa.one/apis/v1/twitter/tweet/thread_context?tweetId=1895096451033985024" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Worldwide trends
curl "https://api.aisa.one/apis/v1/twitter/trends?woeid=1" \
  -H "Authorization: Bearer $AISA_API_KEY"

# List members
curl "https://api.aisa.one/apis/v1/twitter/list/members?list_id=1585430245762441216" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Community tweets
curl "https://api.aisa.one/apis/v1/twitter/community/tweets?community_id=1708485837274263614" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Space detail
curl "https://api.aisa.one/apis/v1/twitter/spaces/detail?space_id=1dRJZlbLkjexB" \
  -H "Authorization: Bearer $AISA_API_KEY"

​
Python client

# User
python3 scripts/twitter_client.py user-info --username elonmusk
python3 scripts/twitter_client.py user-about --username elonmusk
python3 scripts/twitter_client.py tweets --username elonmusk
python3 scripts/twitter_client.py mentions --username elonmusk
python3 scripts/twitter_client.py followers --username elonmusk
python3 scripts/twitter_client.py followings --username elonmusk
python3 scripts/twitter_client.py verified-followers --user-id 44196397
python3 scripts/twitter_client.py check-follow --source elonmusk --target BillGates
python3 scripts/twitter_client.py user-search --query "AI researcher"

# Search & trends
python3 scripts/twitter_client.py search --query "AI agents"
python3 scripts/twitter_client.py search --query "AI agents" --type Top
python3 scripts/twitter_client.py trends --woeid 1

# Tweets
python3 scripts/twitter_client.py detail --tweet-ids 1895096451033985024
python3 scripts/twitter_client.py replies --tweet-id 1895096451033985024
python3 scripts/twitter_client.py quotes --tweet-id 1895096451033985024
python3 scripts/twitter_client.py retweeters --tweet-id 1895096451033985024
python3 scripts/twitter_client.py thread --tweet-id 1895096451033985024

# Lists & communities
python3 scripts/twitter_client.py list-members --list-id 1585430245762441216
python3 scripts/twitter_client.py community-info --community-id 1708485837274263614
python3 scripts/twitter_client.py community-tweets --community-id 1708485837274263614

# Engagement (OAuth-gated; use the local relay)
python3 scripts/twitter_engagement_client.py like-latest --user "@elonmusk"
python3 scripts/twitter_engagement_client.py follow-user --user "@elonmusk"

​
Endpoint reference

EndpointMethodPurpose
/twitter/user/infoGETUser profile
/twitter/user_aboutGETUser about
/twitter/user/batch_info_by_idsGETBatch user info
/twitter/user/last_tweetsGETUser last tweets
/twitter/user/mentionsGETUser mentions
/twitter/user/followersGETUser followers
/twitter/user/followingsGETUser followings
/twitter/user/verifiedFollowersGETVerified followers
/twitter/user/check_follow_relationshipGETFollow relationship
/twitter/user/searchGETUser search
/twitter/tweet/advanced_searchGETTweet advanced search
/twitter/tweetsGETTweets by IDs
/twitter/tweet/repliesGETTweet replies
/twitter/tweet/quotesGETTweet quotes
/twitter/tweet/retweetersGETTweet retweeters
/twitter/tweet/thread_contextGETThread context
/twitter/articleGETArticle by tweet
/twitter/trendsGETTrends
/twitter/list/membersGETList members
/twitter/list/followersGETList followers
/twitter/community/infoGETCommunity info
/twitter/community/membersGETCommunity members
/twitter/community/moderatorsGETCommunity moderators
/twitter/community/tweetsGETCommunity tweets
/twitter/community/get_tweets_from_all_communityGETAll-community search
/twitter/spaces/detailGETSpace detail

​
Get started

  1. Sign up at aisa.one (new accounts start with $2 free credit).
  2. Generate an API key from the console.
  3. export AISA_API_KEY="your-key" and install the skill: 
    aisa skills install twitter-autopilot
  4. For write actions (post, like, follow), complete OAuth via the local relay — see ./references/post_twitter.md and ./references/engage_twitter.md in the skill folder.

Twitter API reference

Every read endpoint with interactive playgrounds.

Authentication

Bearer-token auth plus OAuth for write actions.

Rate Limits

Twitter RPM caps per key.