twitterscore

name	twitterscore
description	Research, analyze, and track Twitter influence with TwitterScore.io API. Get scores, analyze followers, track growth, and compare accounts.

TwitterScore Skill

Use twitterscore to research Twitter accounts, analyze influence scores, track follower growth, and compare accounts using the TwitterScore.io API.

Setup

Requires a TwitterScore API key. Get one at twitterscore.io/api/prices.

# Set API key
export TWITTERSCORE_API_KEY="your_api_key"

# Or configure via OpenClaw
openclaw config set twitterscore.api_key your_api_key

Commands

score

Get TwitterScore for an account.

# By username (default)
twitterscore score elonmusk

# By Twitter ID
twitterscore score --id 44196397

# Output as JSON
twitterscore score elonmusk --json

Output:

@elonmusk (Elon Musk)
Twitter ID: 44196397
Twitter Score: 1000.0/1000

info

Get detailed account information.

twitterscore info elonmusk

Output:

@elonmusk
Name: Elon Musk
Description: ...
Followers: 199,987,720
Profile: [image URL]

bulk

Check up to 50 accounts at once.

twitterscore bulk coinbase binance paradigm a16zcrypto

# From file
twitterscore bulk --file accounts.txt

followers

Get and analyze followers.

# Top followers by score
twitterscore followers elonmusk --top 10

# Paginated list
twitterscore followers elonmusk --page 1 --size 25

# Filter by category (1=Venture Capitals)
twitterscore followers elonmusk --category 1

# Filter by tag (22=Ethereum)
twitterscore followers elonmusk --tag 22

# Filter by tag category (3=Ecosystems)
twitterscore followers elonmusk --tag-category 3

diff

Track score changes.

twitterscore diff elonmusk

Output:

Score Changes for @elonmusk:
Week: [phone] → 2024-10-03)
Month: [phone] → 2024-10-03)

history

Get follower count history.

# Last 30 days (default)
twitterscore history elonmusk

# Custom periods
twitterscore history elonmusk --period 7d    # 7 days
twitterscore history elonmusk --period 180d  # 6 months
twitterscore history elonmusk --period 1y    # 1 year
twitterscore history elonmusk --period all   # All time

# Export to CSV
twitterscore history elonmusk --export growth.csv

categories

List all follower categories.

twitterscore categories

Output:

ID  Name
1   Venture Capitals
2   Founders
3   Projects
4   Exchanges
5   Auditors
7   Media
8   Influencers
9   Angels
10  Trading

tags

List all available tags.

# All tags
twitterscore tags

# Paginated
twitterscore tags --page 1 --size 25

analyze

Analyze followers by categories and tags.

# Followers by category
twitterscore analyze elonmusk --by-category

# Followers by tag
twitterscore analyze elonmusk --by-tag

limits

Check your API usage and limits.

twitterscore limits

Output:

Plan: Pro
Monthly: 10,700 / 200,000 (189,300 remaining)
Resets: 2025-05-12
Per minute: 60 requests

Options

Global Flags

Flag	Description
--api-key KEY	Override API key
--json	Output as JSON
--csv	Output as CSV
--quiet	Minimal output

Common Parameters

Parameter	Description	Default
--page N	Page number	1
--size N	Items per page (max 50)	10
--category ID	Filter by category ID	-
--tag ID	Filter by tag ID	-
--tag-category ID	Filter by tag category	-

Environment Variables

Variable	Description
TWITTERSCORE_API_KEY	Your TwitterScore API key
TWITTERSCORE_BASE_URL	API base URL (optional)

Tips

Rate Limiting

• Max 60 requests/minute
• Use bulk operations when checking multiple accounts
• Cache results for frequently checked accounts

Efficient Queries

# ❌ Slow: Individual requests
for user in coinbase binance paradigm; do
  twitterscore score $user
done

# ✅ Fast: Bulk request
twitterscore bulk coinbase binance paradigm

Exporting Data

# Export follower analysis to CSV
twitterscore followers elonmusk --top 100 --csv > top_followers.csv

# Export growth history
twitterscore history elonmusk --period 1y --export yearly_growth.csv

API Reference

Base URL: https://twitterscore.io/api/v1

See TwitterScore API Documentation for full API details.

Troubleshooting

"API key not configured"

Set your API key:

export TWITTERSCORE_API_KEY="your_key"

"Rate limit exceeded"

Wait a minute or check your plan limits:

twitterscore limits

"Account not found"

The account may be deleted, private, or suspended. Try using Twitter ID instead of username.

Examples

Research Competitors

# Get scores for top VCs
twitterscore bulk a16zcrypto paradigm coinbasecms dragonfly_xyz

# Analyze their followers
for vc in a16zcrypto paradigm; do
  echo "=== $VC ==="
  twitterscore analyze $vc --by-category
done

Track Growth

# Save current state
twitterscore history myaccount --period all --export before_campaign.csv

# ... run marketing campaign ...

# Compare after
twitterscore history myaccount --period 30d --export after_campaign.csv

Find Influencers

# Get top followers of major accounts
twitterscore followers elonmusk --top 100 --category 8 > influencers.txt