✓ Verified 🌐 Web Scrapers ✓ Enhanced Data

Asia Twitter Api V1

Search X (Twitter) in real time, monitor trends, extract posts, and analyze social media data—perfec

Rating: 4 (210 reviews)
Downloads: 909 downloads
Version: 1.0.0

Overview

Search X (Twitter) in real time, monitor trends, extract posts, and analyze social media data—perfect for social.

✨Key Features

Account Login (Async Operation)

Check Login Status

Get API Key

Add Credits

Set Environment Variable

Start with Read Operations

Complete Documentation

View Source →

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)

User profiles, tweets, search, trends, followers
No authentication required
No credentials transmitted
Safe for production use

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

Posting, liking, retweeting
Requires transmitting email + password + proxy to third-party API
Security Risk: Full account access granted to api.aisa.one

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

🔥 What Can You Do? (Safe Read Operations)

Monitor Influencers

text

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

Track Trends

text

"What's trending on Twitter worldwide right now?"

Social Listening

text

"Search for tweets mentioning our product and analyze sentiment"

Competitor Intelligence

text

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

User Research

text

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

Quick Start

bash

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

bash

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

#### Get User's Latest Tweets

bash

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)

bash

# 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

bash

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

#### Search Users

bash

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

bash

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

#### Get User Followers

bash

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

#### Get User Followings

bash

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:

Send your Twitter email, password, and proxy credentials to api.aisa.one
Trust a third-party service with full account access
Accept responsibility for account security

NEVER use these operations with:

❌ Your primary Twitter account
❌ Accounts with sensitive data
❌ Verified or high-value accounts
❌ Accounts you cannot afford to lose

ONLY use with:

✅ Dedicated test/automation accounts
✅ Unique passwords not used elsewhere
✅ Accounts created specifically for this purpose
✅ After reviewing AIsa's security policies

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)

bash

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": "[email protected]",
    "password": "unique_password_here",
    "proxy": "http://user:pass@proxy-ip:port"
  }'

Login is asynchronous - check status after submission.

#### Step 2: Check Login Status

bash

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

bash

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

bash

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

bash

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

bash

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

bash

# 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:

bash

# Login (use test account only!)
python3 {baseDir}/scripts/twitter_client.py login \
  --username test_automation_account \
  --email [email protected] \
  --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

AIsa uses pay-as-you-go pricing. Add credits to your account.

Step 3: Set Environment Variable

bash

export AISA_API_KEY="your-key-here"

Step 4: Start with Read Operations

Begin with safe read operations to familiarize yourself with the API.

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

Security Best Practices

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

Documentation

Support

API Issues: Contact AIsa support at aisa.one
Skill Issues: Open issue on GitHub
Security Concerns: Review AIsa security documentation

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.

Installation

Terminal bash


openclaw install asia-twitter-api-v1

Copied!

💻Code Examples

export AISA_API_KEY="your-key"

export-aisaapikeyyour-key.txt

Get your API key at [aisa.one](https://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

-H "Authorization: Bearer $AISA_API_KEY"

--h-authorization-bearer-aisaapikey.txt

#### Search Tweets (Advanced)

**Important**: `queryType` parameter is required (Latest or Top)

-H "Authorization: Bearer $AISA_API_KEY"

--h-authorization-bearer-aisaapikey.txt

---

## ⚠️ 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:**
- ❌ Your primary Twitter account
- ❌ Accounts with sensitive data
- ❌ Verified or high-value accounts
- ❌ Accounts you cannot afford to lose

**ONLY use with:**
- ✅ Dedicated test/automation accounts
- ✅ Unique passwords not used elsewhere
- ✅ Accounts created specifically for this purpose
- ✅ After reviewing AIsa's security policies

**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)

}'

-.txt

**Login is asynchronous** - check status after submission.

#### Step 2: Check Login Status

}'

-.txt

---

## Python Client

### Safe Read Operations

python3 {baseDir}/scripts/twitter_client.py trends --woeid 1

python3-basedirscriptstwitterclientpy-trends---woeid-1.txt

### ⚠️ Write Operations (High Risk)

**Only use with dedicated test accounts:**

--tweet-id 1234567890

---tweet-id-1234567890.txt

---

## 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
Sign up at [aisa.one](https://aisa.one) and obtain your API key.

### Step 2: Add Credits
AIsa uses pay-as-you-go pricing. Add credits to your account.

### Step 3: Set Environment Variable

example.sh

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

example.sh

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

example.sh

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": "[email protected]",
    "password": "unique_password_here",
    "proxy": "http://user:pass@proxy-ip:port"
  }'