Skip to main content

Documentation Index

Fetch the complete documentation index at: https://aisa.one/docs/llms.txt

Use this file to discover all available pages before exploring further.

View on GitHub -> Twitter/X search and posting in one workflow. Research profiles and tweets, then move into OAuth-approved posting when needed.

​
Install

aisa skills install twitter-command-center-search-post

​
What can agents do with it?

Social listening

Search users, tweets, trends, communities, and lists.

Post drafting

Draft and prepare posts from research context.

Engage safely

Use linked-account actions only after authorization.

DM-aware workflows

Include DM context when the workflow needs it.

​
What Can You Do?

​
Monitor Influencers

"Get Elon Musk's latest tweets and notify me of any AI-related posts"

"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"

​
Posting Workflows

This file does not define publishing logic. If the user asks to send, publish, or reply, or quote on X/Twitter, handle that workflow with ./references/post_twitter.md.

​
Quick Start

export AISA_API_KEY="your-key"

​
Core Capabilities

​
Read Operations (No Login Required)

​
User Endpoints

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

# Get user profile about (account country, verification, username changes)
curl "https://api.aisa.one/apis/v1/twitter/user_about?userName=elonmusk" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Batch get user info by IDs
curl "https://api.aisa.one/apis/v1/twitter/user/batch_info_by_ids?userIds=44196397,123456" \
  -H "Authorization: Bearer $AISA_API_KEY"

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

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

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

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

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

# Check follow relationship between two users
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"

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

​
Tweet Endpoints

# Advanced tweet 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"

# Search top tweets
curl "https://api.aisa.one/apis/v1/twitter/tweet/advanced_search?query=AI+agents&queryType=Top" \
  -H "Authorization: Bearer $AISA_API_KEY"

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

# Get tweet replies
curl "https://api.aisa.one/apis/v1/twitter/tweet/replies?tweetId=1895096451033985024" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get tweet quotes
curl "https://api.aisa.one/apis/v1/twitter/tweet/quotes?tweetId=1895096451033985024" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get tweet retweeters
curl "https://api.aisa.one/apis/v1/twitter/tweet/retweeters?tweetId=1895096451033985024" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get tweet thread context (full conversation thread)
curl "https://api.aisa.one/apis/v1/twitter/tweet/thread_context?tweetId=1895096451033985024" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get article by tweet ID
curl "https://api.aisa.one/apis/v1/twitter/article?tweet_id=1895096451033985024" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get trending topics (worldwide)
curl "https://api.aisa.one/apis/v1/twitter/trends?woeid=1" \
  -H "Authorization: Bearer $AISA_API_KEY"

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

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

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

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

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

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

# Search tweets from all communities
curl "https://api.aisa.one/apis/v1/twitter/community/get_tweets_from_all_community?query=AI" \
  -H "Authorization: Bearer $AISA_API_KEY"

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

​
Python Client

# User operations
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

# Search & discovery
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 user-search --query "AI researcher"
python3 scripts/twitter_client.py trends --woeid 1

# Tweet operations
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

# List operations
python3 scripts/twitter_client.py list-members --list-id 1585430245762441216
python3 scripts/twitter_client.py list-followers --list-id 1585430245762441216

# Community operations
python3 scripts/twitter_client.py community-info --community-id 1708485837274263614
python3 scripts/twitter_client.py community-members --community-id 1708485837274263614
python3 scripts/twitter_client.py community-tweets --community-id 1708485837274263614
python3 scripts/twitter_client.py community-search --query "AI"

​
API Endpoints Reference

​
Read Endpoints (GET)

EndpointDescriptionKey Params
/twitter/user/infoGet user profileuserName
/twitter/user_aboutGet user profile aboutuserName
/twitter/user/batch_info_by_idsBatch get users by IDsuserIds
/twitter/user/last_tweetsGet user’s recent tweetsuserName, cursor
/twitter/user/mentionsGet user mentionsuserName, cursor
/twitter/user/followersGet user followersuserName, cursor
/twitter/user/followingsGet user followingsuserName, cursor
/twitter/user/verifiedFollowersGet verified followersuser_id, cursor
/twitter/user/check_follow_relationshipCheck follow relationshipsource_user_name, target_user_name
/twitter/user/searchSearch users by keywordquery, cursor
/twitter/tweet/advanced_searchAdvanced tweet searchquery, queryType (Latest/Top), cursor
/twitter/tweetsGet tweets by IDstweet_ids (comma-separated)
/twitter/tweet/repliesGet tweet repliestweetId, cursor
/twitter/tweet/quotesGet tweet quotestweetId, cursor
/twitter/tweet/retweetersGet tweet retweeterstweetId, cursor
/twitter/tweet/thread_contextGet tweet thread contexttweetId, cursor
/twitter/articleGet article by tweettweet_id
/twitter/trendsGet trending topicswoeid (1=worldwide)
/twitter/list/membersGet list memberslist_id, cursor
/twitter/list/followersGet list followerslist_id, cursor
/twitter/community/infoGet community infocommunity_id
/twitter/community/membersGet community memberscommunity_id, cursor
/twitter/community/moderatorsGet community moderatorscommunity_id, cursor
/twitter/community/tweetsGet community tweetscommunity_id, cursor
/twitter/community/get_tweets_from_all_communitySearch all community tweetsquery, cursor
/twitter/spaces/detailGet Space detailspace_id

​
Pricing

APICost
Twitter read query~$0.0004
Every response includes usage.cost and usage.credits_remaining.

​
Get Started

  1. Sign up at aisa.one
  2. Get your API key
  3. Add credits (pay-as-you-go)
  4. Set environment variable: export AISA_API_KEY="your-key"

​
Full API Reference

See API Reference for complete endpoint documentation.

​
Get started

  1. Sign up at aisa.one (new accounts start with $2 free credit).
  2. Generate an API key from the console.
  3. Set your key and install the skill: 
    export AISA_API_KEY="your-key"
aisa skills install twitter-command-center-search-post
  4. Start a new agent session so the runtime loads the updated skill instructions.

AIsa Twitter Command Center

Full command-center workflow.

AIsa Twitter API

X/Twitter data and intelligence access.

Twitter Autopilot

Broad X/Twitter automation skill.