OpenClaw Twitter 🐦
Twitter/X data access and automation for autonomous agents. Powered by AIsa.
One API key. Full Twitter intelligence.
🔥 What Can You Do?
Monitor Influencers
"Get Elon Musk's latest tweets and notify me of any AI-related posts"
Track Trends
"What's trending on Twitter worldwide right now?"
Social Listening
"Search for tweets mentioning our product and analyze sentiment"
Automated Engagement
"Like and retweet posts from @OpenAI that mention GPT-5"
Competitor Intel
"Monitor @anthropic and @GoogleAI - alert me on new announcements"
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"
Trends, Lists, Communities & Spaces
# 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"
Write Operations (Requires Login)
⚠️ Warning: Write operations require logging in first to get login_cookies. All write endpoints also require a proxy parameter. Use responsibly to avoid rate limits or account suspension.
# Step 1: Login (returns login_cookies for subsequent calls)
curl -X POST "https://api.aisa.one/apis/v1/twitter/user_login_v2" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"user_name": "myaccount",
"email": "me@example.com",
"password": "xxx",
"proxy": "http://user:pass@ip:port",
"totp_secret": "optional-2fa-secret"
}'
# Step 2: Use login_cookies from login response for all write operations
# Create a tweet
curl -X POST "https://api.aisa.one/apis/v1/twitter/create_tweet_v2" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"login_cookies": "<cookies-from-login>",
"tweet_text": "Hello from OpenClaw!",
"proxy": "http://user:pass@ip:port"
}'
# Reply to a tweet
curl -X POST "https://api.aisa.one/apis/v1/twitter/create_tweet_v2" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"login_cookies": "<cookies-from-login>",
"tweet_text": "Great point!",
"reply_to_tweet_id": "1234567890",
"proxy": "http://user:pass@ip:port"
}'
# Upload media (multipart/form-data)
curl -X POST "https://api.aisa.one/apis/v1/twitter/upload_media_v2" \
-H "Authorization: Bearer $AISA_API_KEY" \
-F "file=@image.jpg" \
-F "login_cookies=<cookies-from-login>" \
-F "proxy=http://user:pass@ip:port"
# Like a tweet
curl -X POST "https://api.aisa.one/apis/v1/twitter/like_tweet_v2" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"login_cookies": "<cookies>", "tweet_id": "1234567890", "proxy": "http://user:pass@ip:port"}'
# Unlike a tweet
curl -X POST "https://api.aisa.one/apis/v1/twitter/unlike_tweet_v2" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"login_cookies": "<cookies>", "tweet_id": "1234567890", "proxy": "http://user:pass@ip:port"}'
# Retweet
curl -X POST "https://api.aisa.one/apis/v1/twitter/retweet_tweet_v2" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"login_cookies": "<cookies>", "tweet_id": "1234567890", "proxy": "http://user:pass@ip:port"}'
# Delete a tweet
curl -X POST "https://api.aisa.one/apis/v1/twitter/delete_tweet_v2" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"login_cookies": "<cookies>", "tweet_id": "1234567890", "proxy": "http://user:pass@ip:port"}'
# Follow a user
curl -X POST "https://api.aisa.one/apis/v1/twitter/follow_user_v2" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"login_cookies": "<cookies>", "user_id": "44196397", "proxy": "http://user:pass@ip:port"}'
# Unfollow a user
curl -X POST "https://api.aisa.one/apis/v1/twitter/unfollow_user_v2" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"login_cookies": "<cookies>", "user_id": "44196397", "proxy": "http://user:pass@ip:port"}'
# Send a direct message
curl -X POST "https://api.aisa.one/apis/v1/twitter/send_dm_to_user" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"login_cookies": "<cookies>", "user_id": "44196397", "text": "Hello!", "proxy": "http://user:pass@ip:port"}'
Python Client
# User operations
python3 {baseDir}/scripts/twitter_client.py user-info --username elonmusk
python3 {baseDir}/scripts/twitter_client.py user-about --username elonmusk
python3 {baseDir}/scripts/twitter_client.py tweets --username elonmusk
python3 {baseDir}/scripts/twitter_client.py mentions --username elonmusk
python3 {baseDir}/scripts/twitter_client.py followers --username elonmusk
python3 {baseDir}/scripts/twitter_client.py followings --username elonmusk
python3 {baseDir}/scripts/twitter_client.py verified-followers --user-id 44196397
python3 {baseDir}/scripts/twitter_client.py check-follow --source elonmusk --target BillGates
# Search & Discovery
python3 {baseDir}/scripts/twitter_client.py search --query "AI agents"
python3 {baseDir}/scripts/twitter_client.py search --query "AI agents" --type Top
python3 {baseDir}/scripts/twitter_client.py user-search --query "AI researcher"
python3 {baseDir}/scripts/twitter_client.py trends --woeid 1
# Tweet operations
python3 {baseDir}/scripts/twitter_client.py detail --tweet-ids 1895096451033985024
python3 {baseDir}/scripts/twitter_client.py replies --tweet-id 1895096451033985024
python3 {baseDir}/scripts/twitter_client.py quotes --tweet-id 1895096451033985024
python3 {baseDir}/scripts/twitter_client.py retweeters --tweet-id 1895096451033985024
python3 {baseDir}/scripts/twitter_client.py thread --tweet-id 1895096451033985024
# List operations
python3 {baseDir}/scripts/twitter_client.py list-members --list-id 1585430245762441216
python3 {baseDir}/scripts/twitter_client.py list-followers --list-id 1585430245762441216
# Community operations
python3 {baseDir}/scripts/twitter_client.py community-info --community-id 1708485837274263614
python3 {baseDir}/scripts/twitter_client.py community-members --community-id 1708485837274263614
python3 {baseDir}/scripts/twitter_client.py community-tweets --community-id 1708485837274263614
python3 {baseDir}/scripts/twitter_client.py community-search --query "AI"
# Write operations (requires login first)
python3 {baseDir}/scripts/twitter_client.py login --username myaccount --email me@example.com --password xxx --proxy "http://user:pass@ip:port"
python3 {baseDir}/scripts/twitter_client.py post --cookies "<login_cookies>" --text "Hello!" --proxy "http://user:pass@ip:port"
python3 {baseDir}/scripts/twitter_client.py like --cookies "<login_cookies>" --tweet-id 1234567890 --proxy "http://user:pass@ip:port"
python3 {baseDir}/scripts/twitter_client.py unlike --cookies "<login_cookies>" --tweet-id 1234567890 --proxy "http://user:pass@ip:port"
python3 {baseDir}/scripts/twitter_client.py retweet --cookies "<login_cookies>" --tweet-id 1234567890 --proxy "http://user:pass@ip:port"
python3 {baseDir}/scripts/twitter_client.py delete-tweet --cookies "<login_cookies>" --tweet-id 1234567890 --proxy "http://user:pass@ip:port"
python3 {baseDir}/scripts/twitter_client.py follow --cookies "<login_cookies>" --user-id 44196397 --proxy "http://user:pass@ip:port"
python3 {baseDir}/scripts/twitter_client.py unfollow --cookies "<login_cookies>" --user-id 44196397 --proxy "http://user:pass@ip:port"
python3 {baseDir}/scripts/twitter_client.py send-dm --cookies "<login_cookies>" --user-id 44196397 --text "Hello!" --proxy "http://user:pass@ip:port"
API Endpoints Reference
Read Endpoints (GET)
| Endpoint |
Description |
Key Params |
/twitter/user/info |
Get user profile |
userName |
/twitter/user_about |
Get user profile about |
userName |
/twitter/user/batch_info_by_ids |
Batch get users by IDs |
userIds |
/twitter/user/last_tweets |
Get user's recent tweets |
userName, cursor |
/twitter/user/mentions |
Get user mentions |
userName, cursor |
/twitter/user/followers |
Get user followers |
userName, cursor |
/twitter/user/followings |
Get user followings |
userName, cursor |
/twitter/user/verifiedFollowers |
Get verified followers |
user_id, cursor |
/twitter/user/check_follow_relationship |
Check follow relationship |
source_user_name, target_user_name |
/twitter/user/search |
Search users by keyword |
query, cursor |
/twitter/tweet/advanced_search |
Advanced tweet search |
query, queryType (Latest/Top), cursor |
/twitter/tweets |
Get tweets by IDs |
tweet_ids (comma-separated) |
/twitter/tweet/replies |
Get tweet replies |
tweetId, cursor |
/twitter/tweet/quotes |
Get tweet quotes |
tweetId, cursor |
/twitter/tweet/retweeters |
Get tweet retweeters |
tweetId, cursor |
/twitter/tweet/thread_context |
Get tweet thread context |
tweetId, cursor |
/twitter/article |
Get article by tweet |
tweet_id |
/twitter/trends |
Get trending topics |
woeid (1=worldwide) |
/twitter/list/members |
Get list members |
list_id, cursor |
/twitter/list/followers |
Get list followers |
list_id, cursor |
/twitter/community/info |
Get community info |
community_id |
/twitter/community/members |
Get community members |
community_id, cursor |
/twitter/community/moderators |
Get community moderators |
community_id, cursor |
/twitter/community/tweets |
Get community tweets |
community_id, cursor |
/twitter/community/get_tweets_from_all_community |
Search all community tweets |
query, cursor |
/twitter/spaces/detail |
Get Space detail |
space_id |
Write Endpoints (POST)
| Endpoint |
Description |
Key Params |
/twitter/user_login_v2 |
Login to account |
user_name, email, password, proxy, totp_secret |
/twitter/create_tweet_v2 |
Create a tweet |
login_cookies, tweet_text, proxy, reply_to_tweet_id?, media_ids? |
/twitter/upload_media_v2 |
Upload media (multipart) |
file, login_cookies, proxy |
/twitter/like_tweet_v2 |
Like a tweet |
login_cookies, tweet_id, proxy |
/twitter/unlike_tweet_v2 |
Unlike a tweet |
login_cookies, tweet_id, proxy |
/twitter/retweet_tweet_v2 |
Retweet |
login_cookies, tweet_id, proxy |
/twitter/delete_tweet_v2 |
Delete a tweet |
login_cookies, tweet_id, proxy |
/twitter/follow_user_v2 |
Follow a user |
login_cookies, user_id, proxy |
/twitter/unfollow_user_v2 |
Unfollow a user |
login_cookies, user_id, proxy |
/twitter/send_dm_to_user |
Send a direct message |
login_cookies, user_id, text, proxy |
Pricing
| API |
Cost |
| Twitter read query |
~$0.0004 |
| Twitter post/like/retweet |
~$0.003 |
Every response includes usage.cost and usage.credits_remaining.
Get Started
- Sign up at aisa.one
- Get your API key
- Add credits (pay-as-you-go)
- Set environment variable:
export AISA_API_KEY="your-key"
Full API Reference
See API Reference for complete endpoint documentation.
1---2name: twitter-command-center-search-post3description: "Search X (Twitter) in real time, extract relevant posts, and publish tweets/replies instantly—perfect for social listening, engagement, and rapid content ops."4homepage: https://openclaw.ai5metadata:6 source: https://skillmd.com/skills/claw-works/twitter-command-center-search-post7 openclaw:8 emoji: 🐦9 requires:10 bins:11 - curl12 - python313 env:14 - AISA_API_KEY15 primaryEnv: AISA_API_KEY16---1718# OpenClaw Twitter 🐦1920**Twitter/X data access and automation for autonomous agents. Powered by AIsa.**2122One API key. Full Twitter intelligence.2324## 🔥 What Can You Do?2526### Monitor Influencers27```28"Get Elon Musk's latest tweets and notify me of any AI-related posts"29```3031### Track Trends32```33"What's trending on Twitter worldwide right now?"34```3536### Social Listening37```38"Search for tweets mentioning our product and analyze sentiment"39```4041### Automated Engagement42```43"Like and retweet posts from @OpenAI that mention GPT-5"44```4546### Competitor Intel47```48"Monitor @anthropic and @GoogleAI - alert me on new announcements"49```5051## Quick Start5253```bash54export AISA_API_KEY="your-key"55```5657## Core Capabilities5859### Read Operations (No Login Required)6061#### User Endpoints6263```bash64# Get user info65curl "https://api.aisa.one/apis/v1/twitter/user/info?userName=elonmusk" \66 -H "Authorization: Bearer $AISA_API_KEY"6768# Get user profile about (account country, verification, username changes)69curl "https://api.aisa.one/apis/v1/twitter/user_about?userName=elonmusk" \70 -H "Authorization: Bearer $AISA_API_KEY"7172# Batch get user info by IDs73curl "https://api.aisa.one/apis/v1/twitter/user/batch_info_by_ids?userIds=44196397,123456" \74 -H "Authorization: Bearer $AISA_API_KEY"7576# Get user's latest tweets77curl "https://api.aisa.one/apis/v1/twitter/user/last_tweets?userName=elonmusk" \78 -H "Authorization: Bearer $AISA_API_KEY"7980# Get user mentions81curl "https://api.aisa.one/apis/v1/twitter/user/mentions?userName=elonmusk" \82 -H "Authorization: Bearer $AISA_API_KEY"8384# Get user followers85curl "https://api.aisa.one/apis/v1/twitter/user/followers?userName=elonmusk" \86 -H "Authorization: Bearer $AISA_API_KEY"8788# Get user followings89curl "https://api.aisa.one/apis/v1/twitter/user/followings?userName=elonmusk" \90 -H "Authorization: Bearer $AISA_API_KEY"9192# Get user verified followers (requires user_id, not userName)93curl "https://api.aisa.one/apis/v1/twitter/user/verifiedFollowers?user_id=44196397" \94 -H "Authorization: Bearer $AISA_API_KEY"9596# Check follow relationship between two users97curl "https://api.aisa.one/apis/v1/twitter/user/check_follow_relationship?source_user_name=elonmusk&target_user_name=BillGates" \98 -H "Authorization: Bearer $AISA_API_KEY"99100# Search users by keyword101curl "https://api.aisa.one/apis/v1/twitter/user/search?query=AI+researcher" \102 -H "Authorization: Bearer $AISA_API_KEY"103```104105#### Tweet Endpoints106107```bash108# Advanced tweet search (queryType is required: Latest or Top)109curl "https://api.aisa.one/apis/v1/twitter/tweet/advanced_search?query=AI+agents&queryType=Latest" \110 -H "Authorization: Bearer $AISA_API_KEY"111112# Search top tweets113curl "https://api.aisa.one/apis/v1/twitter/tweet/advanced_search?query=AI+agents&queryType=Top" \114 -H "Authorization: Bearer $AISA_API_KEY"115116# Get tweets by IDs (comma-separated)117curl "https://api.aisa.one/apis/v1/twitter/tweets?tweet_ids=1895096451033985024" \118 -H "Authorization: Bearer $AISA_API_KEY"119120# Get tweet replies121curl "https://api.aisa.one/apis/v1/twitter/tweet/replies?tweetId=1895096451033985024" \122 -H "Authorization: Bearer $AISA_API_KEY"123124# Get tweet quotes125curl "https://api.aisa.one/apis/v1/twitter/tweet/quotes?tweetId=1895096451033985024" \126 -H "Authorization: Bearer $AISA_API_KEY"127128# Get tweet retweeters129curl "https://api.aisa.one/apis/v1/twitter/tweet/retweeters?tweetId=1895096451033985024" \130 -H "Authorization: Bearer $AISA_API_KEY"131132# Get tweet thread context (full conversation thread)133curl "https://api.aisa.one/apis/v1/twitter/tweet/thread_context?tweetId=1895096451033985024" \134 -H "Authorization: Bearer $AISA_API_KEY"135136# Get article by tweet ID137curl "https://api.aisa.one/apis/v1/twitter/article?tweet_id=1895096451033985024" \138 -H "Authorization: Bearer $AISA_API_KEY"139```140141#### Trends, Lists, Communities & Spaces142143```bash144# Get trending topics (worldwide)145curl "https://api.aisa.one/apis/v1/twitter/trends?woeid=1" \146 -H "Authorization: Bearer $AISA_API_KEY"147148# Get list members149curl "https://api.aisa.one/apis/v1/twitter/list/members?list_id=1585430245762441216" \150 -H "Authorization: Bearer $AISA_API_KEY"151152# Get list followers153curl "https://api.aisa.one/apis/v1/twitter/list/followers?list_id=1585430245762441216" \154 -H "Authorization: Bearer $AISA_API_KEY"155156# Get community info157curl "https://api.aisa.one/apis/v1/twitter/community/info?community_id=1708485837274263614" \158 -H "Authorization: Bearer $AISA_API_KEY"159160# Get community members161curl "https://api.aisa.one/apis/v1/twitter/community/members?community_id=1708485837274263614" \162 -H "Authorization: Bearer $AISA_API_KEY"163164# Get community moderators165curl "https://api.aisa.one/apis/v1/twitter/community/moderators?community_id=1708485837274263614" \166 -H "Authorization: Bearer $AISA_API_KEY"167168# Get community tweets169curl "https://api.aisa.one/apis/v1/twitter/community/tweets?community_id=1708485837274263614" \170 -H "Authorization: Bearer $AISA_API_KEY"171172# Search tweets from all communities173curl "https://api.aisa.one/apis/v1/twitter/community/get_tweets_from_all_community?query=AI" \174 -H "Authorization: Bearer $AISA_API_KEY"175176# Get Space detail177curl "https://api.aisa.one/apis/v1/twitter/spaces/detail?space_id=1dRJZlbLkjexB" \178 -H "Authorization: Bearer $AISA_API_KEY"179```180181### Write Operations (Requires Login)182183> ⚠️ **Warning**: Write operations require logging in first to get `login_cookies`. All write endpoints also require a `proxy` parameter. Use responsibly to avoid rate limits or account suspension.184185```bash186# Step 1: Login (returns login_cookies for subsequent calls)187curl -X POST "https://api.aisa.one/apis/v1/twitter/user_login_v2" \188 -H "Authorization: Bearer $AISA_API_KEY" \189 -H "Content-Type: application/json" \190 -d '{191 "user_name": "myaccount",192 "email": "me@example.com",193 "password": "xxx",194 "proxy": "http://user:pass@ip:port",195 "totp_secret": "optional-2fa-secret"196 }'197198# Step 2: Use login_cookies from login response for all write operations199200# Create a tweet201curl -X POST "https://api.aisa.one/apis/v1/twitter/create_tweet_v2" \202 -H "Authorization: Bearer $AISA_API_KEY" \203 -H "Content-Type: application/json" \204 -d '{205 "login_cookies": "<cookies-from-login>",206 "tweet_text": "Hello from OpenClaw!",207 "proxy": "http://user:pass@ip:port"208 }'209210# Reply to a tweet211curl -X POST "https://api.aisa.one/apis/v1/twitter/create_tweet_v2" \212 -H "Authorization: Bearer $AISA_API_KEY" \213 -H "Content-Type: application/json" \214 -d '{215 "login_cookies": "<cookies-from-login>",216 "tweet_text": "Great point!",217 "reply_to_tweet_id": "1234567890",218 "proxy": "http://user:pass@ip:port"219 }'220221# Upload media (multipart/form-data)222curl -X POST "https://api.aisa.one/apis/v1/twitter/upload_media_v2" \223 -H "Authorization: Bearer $AISA_API_KEY" \224 -F "file=@image.jpg" \225 -F "login_cookies=<cookies-from-login>" \226 -F "proxy=http://user:pass@ip:port"227228# Like a tweet229curl -X POST "https://api.aisa.one/apis/v1/twitter/like_tweet_v2" \230 -H "Authorization: Bearer $AISA_API_KEY" \231 -H "Content-Type: application/json" \232 -d '{"login_cookies": "<cookies>", "tweet_id": "1234567890", "proxy": "http://user:pass@ip:port"}'233234# Unlike a tweet235curl -X POST "https://api.aisa.one/apis/v1/twitter/unlike_tweet_v2" \236 -H "Authorization: Bearer $AISA_API_KEY" \237 -H "Content-Type: application/json" \238 -d '{"login_cookies": "<cookies>", "tweet_id": "1234567890", "proxy": "http://user:pass@ip:port"}'239240# Retweet241curl -X POST "https://api.aisa.one/apis/v1/twitter/retweet_tweet_v2" \242 -H "Authorization: Bearer $AISA_API_KEY" \243 -H "Content-Type: application/json" \244 -d '{"login_cookies": "<cookies>", "tweet_id": "1234567890", "proxy": "http://user:pass@ip:port"}'245246# Delete a tweet247curl -X POST "https://api.aisa.one/apis/v1/twitter/delete_tweet_v2" \248 -H "Authorization: Bearer $AISA_API_KEY" \249 -H "Content-Type: application/json" \250 -d '{"login_cookies": "<cookies>", "tweet_id": "1234567890", "proxy": "http://user:pass@ip:port"}'251252# Follow a user253curl -X POST "https://api.aisa.one/apis/v1/twitter/follow_user_v2" \254 -H "Authorization: Bearer $AISA_API_KEY" \255 -H "Content-Type: application/json" \256 -d '{"login_cookies": "<cookies>", "user_id": "44196397", "proxy": "http://user:pass@ip:port"}'257258# Unfollow a user259curl -X POST "https://api.aisa.one/apis/v1/twitter/unfollow_user_v2" \260 -H "Authorization: Bearer $AISA_API_KEY" \261 -H "Content-Type: application/json" \262 -d '{"login_cookies": "<cookies>", "user_id": "44196397", "proxy": "http://user:pass@ip:port"}'263264# Send a direct message265curl -X POST "https://api.aisa.one/apis/v1/twitter/send_dm_to_user" \266 -H "Authorization: Bearer $AISA_API_KEY" \267 -H "Content-Type: application/json" \268 -d '{"login_cookies": "<cookies>", "user_id": "44196397", "text": "Hello!", "proxy": "http://user:pass@ip:port"}'269```270271## Python Client272273```bash274# User operations275python3 {baseDir}/scripts/twitter_client.py user-info --username elonmusk276python3 {baseDir}/scripts/twitter_client.py user-about --username elonmusk277python3 {baseDir}/scripts/twitter_client.py tweets --username elonmusk278python3 {baseDir}/scripts/twitter_client.py mentions --username elonmusk279python3 {baseDir}/scripts/twitter_client.py followers --username elonmusk280python3 {baseDir}/scripts/twitter_client.py followings --username elonmusk281python3 {baseDir}/scripts/twitter_client.py verified-followers --user-id 44196397282python3 {baseDir}/scripts/twitter_client.py check-follow --source elonmusk --target BillGates283284# Search & Discovery285python3 {baseDir}/scripts/twitter_client.py search --query "AI agents"286python3 {baseDir}/scripts/twitter_client.py search --query "AI agents" --type Top287python3 {baseDir}/scripts/twitter_client.py user-search --query "AI researcher"288python3 {baseDir}/scripts/twitter_client.py trends --woeid 1289290# Tweet operations291python3 {baseDir}/scripts/twitter_client.py detail --tweet-ids 1895096451033985024292python3 {baseDir}/scripts/twitter_client.py replies --tweet-id 1895096451033985024293python3 {baseDir}/scripts/twitter_client.py quotes --tweet-id 1895096451033985024294python3 {baseDir}/scripts/twitter_client.py retweeters --tweet-id 1895096451033985024295python3 {baseDir}/scripts/twitter_client.py thread --tweet-id 1895096451033985024296297# List operations298python3 {baseDir}/scripts/twitter_client.py list-members --list-id 1585430245762441216299python3 {baseDir}/scripts/twitter_client.py list-followers --list-id 1585430245762441216300301# Community operations302python3 {baseDir}/scripts/twitter_client.py community-info --community-id 1708485837274263614303python3 {baseDir}/scripts/twitter_client.py community-members --community-id 1708485837274263614304python3 {baseDir}/scripts/twitter_client.py community-tweets --community-id 1708485837274263614305python3 {baseDir}/scripts/twitter_client.py community-search --query "AI"306307# Write operations (requires login first)308python3 {baseDir}/scripts/twitter_client.py login --username myaccount --email me@example.com --password xxx --proxy "http://user:pass@ip:port"309python3 {baseDir}/scripts/twitter_client.py post --cookies "<login_cookies>" --text "Hello!" --proxy "http://user:pass@ip:port"310python3 {baseDir}/scripts/twitter_client.py like --cookies "<login_cookies>" --tweet-id 1234567890 --proxy "http://user:pass@ip:port"311python3 {baseDir}/scripts/twitter_client.py unlike --cookies "<login_cookies>" --tweet-id 1234567890 --proxy "http://user:pass@ip:port"312python3 {baseDir}/scripts/twitter_client.py retweet --cookies "<login_cookies>" --tweet-id 1234567890 --proxy "http://user:pass@ip:port"313python3 {baseDir}/scripts/twitter_client.py delete-tweet --cookies "<login_cookies>" --tweet-id 1234567890 --proxy "http://user:pass@ip:port"314python3 {baseDir}/scripts/twitter_client.py follow --cookies "<login_cookies>" --user-id 44196397 --proxy "http://user:pass@ip:port"315python3 {baseDir}/scripts/twitter_client.py unfollow --cookies "<login_cookies>" --user-id 44196397 --proxy "http://user:pass@ip:port"316python3 {baseDir}/scripts/twitter_client.py send-dm --cookies "<login_cookies>" --user-id 44196397 --text "Hello!" --proxy "http://user:pass@ip:port"317```318319## API Endpoints Reference320321### Read Endpoints (GET)322323| Endpoint | Description | Key Params |324|----------|-------------|------------|325| `/twitter/user/info` | Get user profile | `userName` |326| `/twitter/user_about` | Get user profile about | `userName` |327| `/twitter/user/batch_info_by_ids` | Batch get users by IDs | `userIds` |328| `/twitter/user/last_tweets` | Get user's recent tweets | `userName`, `cursor` |329| `/twitter/user/mentions` | Get user mentions | `userName`, `cursor` |330| `/twitter/user/followers` | Get user followers | `userName`, `cursor` |331| `/twitter/user/followings` | Get user followings | `userName`, `cursor` |332| `/twitter/user/verifiedFollowers` | Get verified followers | `user_id`, `cursor` |333| `/twitter/user/check_follow_relationship` | Check follow relationship | `source_user_name`, `target_user_name` |334| `/twitter/user/search` | Search users by keyword | `query`, `cursor` |335| `/twitter/tweet/advanced_search` | Advanced tweet search | `query`, `queryType` (Latest/Top), `cursor` |336| `/twitter/tweets` | Get tweets by IDs | `tweet_ids` (comma-separated) |337| `/twitter/tweet/replies` | Get tweet replies | `tweetId`, `cursor` |338| `/twitter/tweet/quotes` | Get tweet quotes | `tweetId`, `cursor` |339| `/twitter/tweet/retweeters` | Get tweet retweeters | `tweetId`, `cursor` |340| `/twitter/tweet/thread_context` | Get tweet thread context | `tweetId`, `cursor` |341| `/twitter/article` | Get article by tweet | `tweet_id` |342| `/twitter/trends` | Get trending topics | `woeid` (1=worldwide) |343| `/twitter/list/members` | Get list members | `list_id`, `cursor` |344| `/twitter/list/followers` | Get list followers | `list_id`, `cursor` |345| `/twitter/community/info` | Get community info | `community_id` |346| `/twitter/community/members` | Get community members | `community_id`, `cursor` |347| `/twitter/community/moderators` | Get community moderators | `community_id`, `cursor` |348| `/twitter/community/tweets` | Get community tweets | `community_id`, `cursor` |349| `/twitter/community/get_tweets_from_all_community` | Search all community tweets | `query`, `cursor` |350| `/twitter/spaces/detail` | Get Space detail | `space_id` |351352### Write Endpoints (POST)353354| Endpoint | Description | Key Params |355|----------|-------------|------------|356| `/twitter/user_login_v2` | Login to account | `user_name`, `email`, `password`, `proxy`, `totp_secret` |357| `/twitter/create_tweet_v2` | Create a tweet | `login_cookies`, `tweet_text`, `proxy`, `reply_to_tweet_id`?, `media_ids`? |358| `/twitter/upload_media_v2` | Upload media (multipart) | `file`, `login_cookies`, `proxy` |359| `/twitter/like_tweet_v2` | Like a tweet | `login_cookies`, `tweet_id`, `proxy` |360| `/twitter/unlike_tweet_v2` | Unlike a tweet | `login_cookies`, `tweet_id`, `proxy` |361| `/twitter/retweet_tweet_v2` | Retweet | `login_cookies`, `tweet_id`, `proxy` |362| `/twitter/delete_tweet_v2` | Delete a tweet | `login_cookies`, `tweet_id`, `proxy` |363| `/twitter/follow_user_v2` | Follow a user | `login_cookies`, `user_id`, `proxy` |364| `/twitter/unfollow_user_v2` | Unfollow a user | `login_cookies`, `user_id`, `proxy` |365| `/twitter/send_dm_to_user` | Send a direct message | `login_cookies`, `user_id`, `text`, `proxy` |366367## Pricing368369| API | Cost |370|-----|------|371| Twitter read query | ~$0.0004 |372| Twitter post/like/retweet | ~$0.003 |373374Every response includes `usage.cost` and `usage.credits_remaining`.375376## Get Started3773781. Sign up at [aisa.one](https://aisa.one)3792. Get your API key3803. Add credits (pay-as-you-go)3814. Set environment variable: `export AISA_API_KEY="your-key"`382383## Full API Reference384385See [API Reference](https://docs.aisa.one/reference/) for complete endpoint documentation.