AttentionVC

User Lookup (Batch)

Batch lookup Twitter/X user profiles — followers, bio, verification status, and more.

Request Body

{
  "usernames": ["elonmusk", "sama", "vitalikbuterin", "naval"]
}

Response

{
  "users": [{ "id": "44196397", "userName": "elonmusk", "name": "Elon Musk",
    "followers": 210000000, "isBlueVerified": true, ... }],
  "not_found": [],
  "total_requested": 4,
  "total_found": 4
}

Notes

• -Accepts array or comma-separated string
• -@ prefix auto-stripped, duplicates removed
• -< 10 users: charged minimum $0.02
• -> 100 users: first 100 queried, charged $0.20 max

User Info

Get detailed profile info for a single Twitter/X user.

Request Body

{
  "username": "vitalikbuterin"
}

Response

{
  "data": { "id": "...", "userName": "vitalikbuterin", "name": "vitalik.eth",
    "followers": 5800000, "isBlueVerified": true, ... },
  "username": "vitalikbuterin"
}

Notes

• -Returns raw API data from AttentionVC
• -Returns 404 (not charged) if user not found

Follower List

Fetch a Twitter/X user's follower list — ~200 followers per page with cursor-based pagination.

Request Body

{
  "username": "elonmusk",
  "cursor": "optional — from previous next_cursor"
}

Response

{
  "followers": [{ "id": "12345678", "userName": "alicesmith",
    "followers_count": 1200, ... }],
  "has_next_page": true,
  "next_cursor": "1234567890",
  "total_returned": 200,
  "username": "elonmusk"
}

Notes

• -Returns ~200 followers per page
• -Pass next_cursor as cursor param to paginate
• -Charged $0.05 per page; not charged if no followers returned

Following List

Fetch the list of accounts a Twitter/X user follows — ~200 per page with cursor-based pagination.

Request Body

{
  "username": "elonmusk",
  "cursor": "optional — from previous next_cursor"
}

Response

{
  "followings": [{ "id": "12345678", "userName": "someone",
    "followers_count": 500, ... }],
  "has_next_page": true,
  "next_cursor": "9876543210",
  "total_returned": 200,
  "username": "elonmusk"
}

Notes

• -Returns ~200 followings per page
• -Also accessible at /users/following (alias)
• -Charged $0.05 per page; not charged if no followings returned

Verified Followers

Fetch verified (blue-check) followers of a Twitter/X user by user ID.

Request Body

{
  "userId": "44196397",
  "cursor": "optional"
}

Response

{
  "followers": [{ ... }],
  "has_next_page": true,
  "next_cursor": "...",
  "total_returned": 50
}

Notes

• -Requires user ID (not username)
• -Only returns verified/blue-check followers

User Tweets

Fetch tweets posted by a Twitter/X user with optional pagination.

Request Body

{
  "username": "jessepollak",
  "includeReplies": false,
  "cursor": "optional"
}

Response

{
  "tweets": [{ "id": "...", "text": "...", "created_at": "...", ... }],
  "has_next_page": true,
  "next_cursor": "...",
  "total_returned": 20
}

Notes

• -Accepts username or userId
• -Set includeReplies: true to include reply tweets

User Mentions

Fetch tweets that mention a specific Twitter/X user.

Request Body

{
  "username": "jessepollak",
  "sinceTime": "optional ISO8601 or Unix timestamp",
  "untilTime": "optional",
  "cursor": "optional"
}

Response

{
  "tweets": [{ "id": "...", "text": "...", ... }],
  "has_next_page": true,
  "next_cursor": "...",
  "total_returned": 20,
  "username": "jessepollak"
}

Notes

• -Optional time filters: sinceTime, untilTime
• -Cursor-based pagination supported

Tweet Lookup (Batch)

Fetch full tweet data for up to 200 tweet IDs in a single request.

Request Body

{
  "tweet_ids": ["1234567890", "9876543210", "..."]
}

Response

{
  "tweets": [{ "id": "1234567890", "text": "...", ... }],
  "not_found": [],
  "total_requested": 3,
  "total_found": 3
}

Notes

• -Accepts array or comma-separated string of IDs
• -Up to 200 IDs per request
• -Not charged if zero tweets returned

Tweet Replies

Fetch replies to a specific tweet with optional sort order.

Request Body

{
  "tweetId": "1234567890",
  "queryType": "Latest",
  "cursor": "optional"
}

Response

{
  "replies": [{ "id": "...", "text": "...", ... }],
  "has_next_page": true,
  "next_cursor": "...",
  "total_returned": 20
}

Notes

• -queryType: 'Latest' or 'Default'
• -Cursor-based pagination supported

Tweet Thread

Fetch the full thread context for a tweet.

Request Body

{
  "tweetId": "1234567890",
  "cursor": "optional"
}

Response

{
  "tweets": [{ "id": "...", "text": "...", ... }],
  "has_next_page": false,
  "next_cursor": null,
  "total_returned": 5
}

Notes

• -Returns all tweets in the thread
• -Not charged if no thread found

Search

Advanced Twitter/X search with Latest, Top, or Default sort.

Request Body

{
  "query": "base blockchain",
  "queryType": "Latest",
  "cursor": "optional"
}

Response

{
  "tweets": [{ "id": "...", "text": "...", ... }],
  "has_next_page": true,
  "next_cursor": "...",
  "total_returned": 20
}

Notes

• -queryType: 'Latest', 'Top', or 'Default'
• -Supports full Twitter search operators

Trending Topics

Get current trending topics on Twitter/X.

Request Body

{}

Response

{
  "data": { "trends": [{ "name": "#Bitcoin", "tweet_volume": 125000 }, ...] }
}

Notes

• -No body required
• -Returns trending topics in real-time

Articles: Rising

Get rising Twitter/X articles — viral content detection from AttentionVC's intelligence layer.

Request Body

{}

Response

{
  "data": { "articles": [{ "url": "...", "title": "...", "score": 9.8 }, ...] }
}

Notes

• -No body required
• -AttentionVC proprietary intelligence signal

Author Analytics

Get author analytics and intelligence metrics for a Twitter/X handle.

Request Body

{
  "handle": "jessepollak"
}

Response

{
  "data": { "handle": "jessepollak", "score": 8.5, "categories": [...], ... },
  "handle": "jessepollak"
}

Notes

• -@ prefix auto-stripped
• -Returns 404 (not charged) if author not found

Compare Authors

Compare two Twitter/X authors side-by-side with intelligence metrics.

Request Body

{
  "handle1": "jessepollak",
  "handle2": "vitalikbuterin"
}

Response

{
  "data": { "handle1": { ... }, "handle2": { ... }, "comparison": { ... } }
}

Notes

• -@ prefix auto-stripped on both handles
• -Returns AttentionVC's comparative intelligence data