LeoYeAI Twitter Analysis — Social Data
Base URL: https://crab-skill.opsat.io
All endpoints are POST. Body is JSON. Requires Crab signature headers.
1. General Endpoints (auto data-source selection)
| Endpoint | Description | Required Fields |
|---|---|---|
/api/twitter/user |
User profile | username |
/api/twitter/tweets |
User tweets (no replies/retweets) | username |
/api/twitter/replies |
User tweets + replies | username |
/api/twitter/search |
Search tweets with filters | at least one filter |
/api/twitter/kol-followers |
KOL followers (6551 only) | username |
/api/twitter/deleted-tweets |
Deleted tweet history (6551 only) | username |
/api/twitter/follower-events |
Follow/unfollow events | username |
Common Optional Fields
| Field | Endpoints | Description |
|---|---|---|
maxResults |
tweets, replies, search, deleted-tweets, follower-events | Number of results (default 20) |
product |
tweets, replies, search | Latest / Top (default Latest for tweets/replies, Top for search) |
Search Filters (/api/twitter/search)
| Field | Description |
|---|---|
keywords |
Search keywords |
fromUser |
Filter by author |
toUser |
Filter by reply target |
mentionUser |
Mentioned user |
hashtag |
Hashtag |
excludeReplies |
Exclude replies |
excludeRetweets |
Exclude retweets |
minLikes |
Minimum likes |
minRetweets |
Minimum retweets |
minReplies |
Minimum replies |
sinceDate |
Start date (YYYY-MM-DD) |
untilDate |
End date (YYYY-MM-DD) |
lang |
Language code |
Follower Events Filter
| Field | Description |
|---|---|
isFollow |
true = new follows, false = unfollows (default true) |
2. ReadX Direct Endpoints
ReadX endpoints provide deep tweet-level analysis capabilities.
Tweet Detail & Content
| Endpoint | Description | Required Fields |
|---|---|---|
/api/readx/tweet-detail |
Tweet detail (minimal) | tweet_id |
/api/readx/tweet-detail-v2 |
Tweet detail (recommended, includes views/source) | tweet_id |
/api/readx/tweet-detail-v3 |
Tweet detail (includes view_count) | tweet_id |
/api/readx/tweet-article |
Long-form article attached to tweet | tweet_id |
/api/readx/tweet-results-by-ids |
Batch fetch multiple tweets | tweet_ids (comma-separated) |
Conversation & Replies
| Endpoint | Description | Required Fields |
|---|---|---|
/api/readx/tweet-detail-conversation |
Tweet + reply thread (single page) | tweet_id |
/api/readx/tweet-detail-conversation-v2 |
Tweet + full reply thread (paginated) | tweet_id, optional cursor |
Engagement & Spread
| Endpoint | Description | Required Fields |
|---|---|---|
/api/readx/tweet-quotes |
Who quoted this tweet | tweet_id, optional cursor |
/api/readx/tweet-retweeters |
Who retweeted this tweet | tweet_id, optional cursor |
/api/readx/tweet-favoriters |
Who liked this tweet | tweet_id, optional cursor |
User Relationships
| Endpoint | Description | Required Fields |
|---|---|---|
/api/readx/followers-light |
Follower list (light fields) | username, optional count |
/api/readx/following-light |
Following list (light fields) | username, optional count |
/api/readx/user-verified-followers |
Verified followers (blue check) | user_id (rest_id), optional cursor |
/api/readx/friendships-show |
Relationship between two users | source_screen_name, target_screen_name |
Advanced Search
| Endpoint | Description | Required Fields |
|---|---|---|
/api/readx/search2 |
Twitter advanced search syntax | q (full query string) |
Optional fields for search2: count (default 20), type (Top/Latest, default Top), cursor, safe_search
search2 query examples:
bitcoin from:elonmusk min_faves:100"project name" -filter:replies min_faves:50@username OR #hashtag since:2025-01-01
When to Use Which
| Goal | Use |
|---|---|
| Basic user info | /api/twitter/user |
| User's recent posts | /api/twitter/tweets |
| Search for mentions/discussions | /api/twitter/search or /api/readx/search2 (advanced) |
| KOL following the project | /api/twitter/kol-followers |
| Read tweet replies/comments | /api/readx/tweet-detail-conversation-v2 |
| Who quoted a tweet (KOL amplification) | /api/readx/tweet-quotes |
| Who retweeted (spread network) | /api/readx/tweet-retweeters |
| Who the project follows back | /api/readx/following-light |
| Verified/notable followers | /api/readx/user-verified-followers |
| Check if two people follow each other | /api/readx/friendships-show |
| Deleted tweets | /api/twitter/deleted-tweets |
| Follow/unfollow events | /api/twitter/follower-events |
Fallback Behavior
| Scenario | Behavior |
|---|---|
| All data sources fail | Return an error |
| Primary source fails | Automatically fall back to backup source |
| ReadX not configured | Skip ReadX endpoints, use general endpoints only |