Production-ready Twitter/X data and automation for autonomous agents

OpenClaw Twitter 🐦

Twitter/X data access and automation for autonomous agents. Powered by AIsa.

One API key. Full Twitter intelligence.

⚠️ IMPORTANT SECURITY NOTICE

This skill provides two types of operations:

✅ Read Operations (SAFE - Recommended for Most Users)

⚠️ Write Operations (HIGH RISK - Use Only with Dedicated Accounts)

⚠️ CRITICAL: Never use write operations with your primary Twitter account. Create dedicated automation accounts only.

🔥 What Can You Do? (Safe Read Operations)

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"

Competitor Intelligence

"Monitor @anthropic and @GoogleAI - alert me on new announcements"

User Research

"Find AI researchers in the Bay Area and show their recent work"

Quick Start

export AISA_API_KEY="your-key"

Get your API key at aisa.one

Core Capabilities

✅ Read Operations (No Login Required - Safe)

All read operations are safe and require only your AIsa API key. No Twitter credentials needed.

#### Get User Information

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

#### Get User's Latest Tweets

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

#### Search Tweets (Advanced)

Important: queryType parameter is required (Latest or Top)

# Search latest tweets
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 Trending Topics

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

#### Search Users

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

#### Get Tweet Details by ID

curl "https://api.aisa.one/apis/v1/twitter/tweet/tweetById?tweet_ids=123456789" \
  -H "Authorization: Bearer $AISA_API_KEY"

#### Get User Followers

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

#### Get User Followings

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

⚠️ Write Operations (High Risk - Requires Authentication)

🚨 CRITICAL SECURITY WARNING

Write operations require you to: 1. Send your Twitter email, password, and proxy credentials to api.aisa.one 2. Trust a third-party service with full account access 3. Accept responsibility for account security

NEVER use these operations with:

ONLY use with:

You acknowledge and accept all risks by using write operations.

Write Operations API Reference

> ⚠️ Warning: All write operations require prior authentication via login endpoint.

#### Step 1: Account Login (Async Operation)

curl -X POST "https://api.aisa.one/apis/v1/twitter/user_login_v3" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_name": "test_automation_account",
    "email": "test@example.com",
    "password": "unique_password_here",
    "proxy": "http://user:pass@proxy-ip:port"
  }'

Login is asynchronous - check status after submission.

#### Step 2: Check Login Status

curl "https://api.aisa.one/apis/v1/twitter/get_my_x_account_detail_v3?user_name=test_automation_account" \
  -H "Authorization: Bearer $AISA_API_KEY"

#### Post a Tweet

curl -X POST "https://api.aisa.one/apis/v1/twitter/send_tweet_v3" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_name": "test_automation_account",
    "text": "Hello from OpenClaw!"
  }'

#### Like a Tweet

curl -X POST "https://api.aisa.one/apis/v1/twitter/like_tweet_v3" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_name": "test_automation_account",
    "tweet_id": "1234567890"
  }'

#### Retweet

curl -X POST "https://api.aisa.one/apis/v1/twitter/retweet_v3" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_name": "test_automation_account",
    "tweet_id": "1234567890"
  }'

#### Update Profile

curl -X POST "https://api.aisa.one/apis/v1/twitter/update_profile_v3" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_name": "test_automation_account",
    "name": "New Name",
    "bio": "New bio"
  }'

Python Client

Safe Read Operations

# User operations (safe)
python3 {baseDir}/scripts/twitter_client.py user-info --username elonmusk
python3 {baseDir}/scripts/twitter_client.py tweets --username elonmusk
python3 {baseDir}/scripts/twitter_client.py followers --username elonmusk
python3 {baseDir}/scripts/twitter_client.py followings --username elonmusk
Search & Discovery (safe)
python3 {baseDir}/scripts/twitter_client.py search --query "AI agents"
python3 {baseDir}/scripts/twitter_client.py user-search --keyword "AI researcher"
python3 {baseDir}/scripts/twitter_client.py trends --woeid 1

⚠️ Write Operations (High Risk)

Only use with dedicated test accounts:

# Login (use test account only!)
python3 {baseDir}/scripts/twitter_client.py login \
  --username test_automation_account \
  --email test@example.com \
  --password unique_password \
  --proxy "http://user:pass@ip:port"
Check account status
python3 {baseDir}/scripts/twitter_client.py account --username test_automation_account
Post operations (after login)
python3 {baseDir}/scripts/twitter_client.py post \
  --username test_automation_account \
  --text "Test post"
python3 {baseDir}/scripts/twitter_client.py like \
  --username test_automation_account \
  --tweet-id 1234567890
python3 {baseDir}/scripts/twitter_client.py retweet \
  --username test_automation_account \
  --tweet-id 1234567890

API Endpoints Reference

Read Operations (Safe)

| Endpoint | Method | Description | |----------|--------|-------------| | /twitter/user/info | GET | Get user profile | | /twitter/user/user_last_tweet | GET | Get user's recent tweets | | /twitter/user/user_followers | GET | Get user followers | | /twitter/user/user_followings | GET | Get user followings | | /twitter/user/search_user | GET | Search users by keyword | | /twitter/tweet/advanced_search | GET | Advanced tweet search | | /twitter/tweet/tweetById | GET | Get tweets by IDs | | /twitter/trends | GET | Get trending topics |

Write Operations (⚠️ High Risk)

| Endpoint | Method | Description | |----------|--------|-------------| | /twitter/user_login_v3 | POST | Login to account ⚠️ | | /twitter/send_tweet_v3 | POST | Send a tweet ⚠️ | | /twitter/like_tweet_v3 | POST | Like a tweet ⚠️ | | /twitter/retweet_v3 | POST | Retweet ⚠️ |

Pricing

| Operation | Cost per Request | |-----------|-----------------| | Read operations | ~$0.0004 | | Write operations | ~$0.001 |

Every API response includes usage.cost and usage.credits_remaining fields.

Getting Started

Step 1: Get API Key

Step 2: Add Credits

Step 3: Set Environment Variable

export AISA_API_KEY="your-key-here"

Step 4: Start with Read Operations

Only proceed to write operations if you have a specific need and dedicated test account.

Security Best Practices

1. Default to read-only - Most use cases don't need write access 2. Separate accounts - Never mix automation with personal accounts 3. Unique credentials - Use unique passwords for automation accounts 4. Environment variables - Never hardcode credentials in scripts 5. Monitor activity - Regularly check your AIsa dashboard 6. Rotate keys - Periodically rotate API keys 7. Minimal permissions - Only use write operations when absolutely necessary 8. Test thoroughly - Always test with test accounts first 9. Review ToS - Understand both Twitter and AIsa terms of service 10. Have a backup plan - Be prepared for account suspension

Documentation

Support

Disclaimer

This skill facilitates access to Twitter data through AIsa's API. Write operations require transmitting credentials to a third-party service. Users assume all responsibility and risk. The authors and AIsa are not liable for account suspension, data loss, or security breaches. Use at your own risk.

export AISA_API_KEY="your-key"

Get your API key at aisa.one