# TwitterScore (X smart followers)

Gateway provider `twitterscore` · call `https://fetchapi.co/api/gw/twitterscore/<path>` with header `x-api-key` (get a key at https://fetchapi.co/keys) · MCP: tools `search_endpoints`, `get_endpoint`, `call_endpoint` at https://fetchapi.co/api/mcp · listing: https://twitterscore.gitbook.io/twitterscore/developers/api-documentation

22 working endpoints, each tested live through this gateway. Endpoints that returned no data in our latest test, write actions and endpoints that need the end user's own login are not listed.

## `twitterscore.bulk_scores_check` — Get the Twitter Score of up to 50 X accounts at once

`GET /bulk_scores_check` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 177 ms

One call returns Twitter Scores for up to 50 X accounts at once. Each item in the answer is one account with its username, ID, profile URL, and Twitter Score (0-1000). The answer held 2 items in our call.

| param | required | example / default |
|---|---|---|
| `ids` | yes | 295218901,44196397 |
| `size` | no | 50 |

Fields: `data[].twitter_id` X account ID; `data[].username` X username; `data[].twitter_url` Link to X profile; `data[].twitter_score` TwitterScore influence score (0-1000); `total` Total accounts in this batch

```bash
curl "https://fetchapi.co/api/gw/twitterscore/bulk_scores_check?ids=295218901,44196397&size=50" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "data": [
  {
   "username": "VitalikButerin",
   "twitter_id": "295218901",
   "twitter_url": "https://x.com/VitalikButerin",
   "twitter_score": 1000
  },
  {
   "username": "elonmusk",
   "twitter_id": "44196397",
   "twitter_url": "https://x.com/elonmusk",
   "twitter_score": 1000
  }
 ],
 "page": 1,
 "size": 2,
 "pages": 1,
 "total": 2,
 "success": true
}
```

## `twitterscore.followers_count_history` — List an X account's daily follower counts (history)

`GET /followers_count_history` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 193 ms

One call returns daily follower counts for an X account over a time period (default 1 month, or all history if period=all). Each item is one day's follower count. The answer held 30 items (one per day in the last month). Get the next page by passing the `page` parameter.

| param | required | example / default |
|---|---|---|
| `username` | no | VitalikButerin |
| `twitter_id` | no |  |
| `period` | no | 1m |
| `page` | no |  |

Fields: `followers_count[].date` Date (YYYY-MM-DD); `followers_count[].followers_count` Follower count on that date; `total` Total days in the period

```bash
curl "https://fetchapi.co/api/gw/twitterscore/followers_count_history?period=1m&username=VitalikButerin" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "page": 1,
 "size": 30,
 "pages": 1,
 "total": 30,
 "success": true,
 "followers_count": [
  {
   "date": "2026-10-08",
   "followers_count": 7983358
  },
  {
   "date": "2026-10-07",
   "followers_count": 7977193
  },
  {
   "date": "2026-10-06",
   "followers_count": 7994321
  }
 ]
}
```

## `twitterscore.friendship_history_followed` — List the notable accounts that followed an X account on a given day

`GET /friendshipHistory/followed` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 3432 ms

One call returns the notable tracked accounts that followed a given X account on a specific date. Each item is one account that followed (or unfollowed) on that date. The answer held 2 items in our call. Get the next page by passing the `page` parameter.

| param | required | example / default |
|---|---|---|
| `username` | no | VitalikButerin |
| `twitter_id` | no |  |
| `date` | yes | 2026-10-06 |
| `tag_ids` | no |  |
| `size` | no | 10 |

Fields: `data[].twitter_id` Follower's X account ID; `data[].username` Follower's X username; `data[].name` Follower's display name; `data[].action` Action on date: 'Followed' or 'Unfollowed'; `data[].twitter_score` Follower's TwitterScore (0-1000); `data[].followers_count` Follower's follower count; `data[].categories` Follower's categories (VCs, Founders, etc.); `data[].description` Follower's bio

```bash
curl "https://fetchapi.co/api/gw/twitterscore/friendshipHistory/followed?date=2026-10-06&size=10&username=VitalikButerin" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "data": [
  {
   "name": "Together AI",
   "tags": [],
   "action": "Unfollowed",
   "username": "togethercompute",
   "categories": [
    {
     "id": 3,
     "name": "Projects"
    }
   ],
   "created_at": "2026-10-06",
   "twitter_id": "1592266692528197632",
   "description": "Accelerate inference, model shaping, and pre-training on a research-optimized platform.",
   "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/1592266692528197632.jpg",
   "twitter_score": 97.63885879449109,
   "followers_count": 63923
  },
  {
   "name": "Peggy",
   "tags": [],
   "action": "Followed",
   "username": "0xPeggy_",
   "categories": [
    {
     "id": 2,
     "name": "Founders"
    },
    {
     "id": 8,
     "name": "Influencers"
    }
   ],
   "created_at": "2026-10-06",
   "twitter_id": "2016309131666456576",
   "description": "📈Showcasing high-potential web3-game & trends\n👑Guides, Insights & Game Discovery 👀\n📩https://t.co/wkoRMaZMjE\n👑GoMining Code: https://t.co/EokRdobZSa",
   "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/2016309131666456576.jpg",
   "twitter_score": 15.835683707732349,
   "followers_count": 23319
  }
 ],
 "page": 1,
 "size": 2,
 "pages": 1,
 "total": 2,
 "success": true
}
```

## `twitterscore.friendship_history_following` — List the accounts an X account started following on a given day

`GET /friendshipHistory/following` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 253 ms

One call returns the accounts a given X account started following on a specific date. Each item is one account that was followed on that date. The answer was empty (total: 0), meaning no follows occurred on that date.

| param | required | example / default |
|---|---|---|
| `username` | no | VitalikButerin |
| `twitter_id` | no |  |
| `date` | yes | 2026-10-06 |
| `tag_ids` | no |  |
| `size` | no | 10 |

```bash
curl "https://fetchapi.co/api/gw/twitterscore/friendshipHistory/following?date=2026-10-06&size=10&username=VitalikButerin" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "data": [],
 "page": 1,
 "size": 0,
 "pages": 1,
 "total": 0,
 "success": true
}
```

## `twitterscore.get_alpha` — List X accounts gaining the most new smart followers (Smart Follows)

`GET /get_alpha` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 195 ms

One call returns X accounts ranked by new smart followers (high-score followers) gained over a period (default 7 days). Each item is one account with its follower gains and the top smart followers who followed it. The answer held 3 items. Get the next page by passing the `page` parameter (100 pages total, 1000 accounts).

| param | required | example / default |
|---|---|---|
| `period` | no |  |
| `page` | no | 1 |
| `size` | no | 10 |

Fields: `data[].twitter_id` X account ID; `data[].username` X username; `data[].name` Display name; `data[].twitter_score` Account's TwitterScore; `data[].followers_diff` Net follower change in period; `data[].current_followers` Current follower count; `data[].new_alpha_followers_diff` New smart followers gained; `data[].top_alpha_followers` Top 3 smart followers who followed; `days` Period in days

```bash
curl "https://fetchapi.co/api/gw/twitterscore/get_alpha" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "data": [
  {
   "name": "Jadoodoo 🍑",
   "username": "jadoodoo_",
   "twitter_id": "1620664028107530240",
   "description": "🇰🇷 Korean Crypto trader Jadoodoo / https://t.co/mNGDRgYLBX, https://t.co/cMGKxUpWFg Ambassador / Crypto GEEK Youtube live on weekday",
   "profile_url": "/twitter/jadoodoo_",
   "blue_verified": true,
   "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/1620664028107530240.jpg",
   "twitter_score": 117,
   "followers_diff": 14560,
   "current_followers": 39682,
   "twitter_score_diff": 65,
   "top_alpha_followers": [
    {
     "name": "toly 🇺🇸",
     "image": "https://twitterscore.s3.amazonaws.com/media/profiles/2327407569.jpg",
     "score": 1000,
     "username": "toly",
     "verified": true
    },
    {
     "name": "Frank Chaparro 🇸🇬",
     "image": "https://twitterscore.s3.amazonaws.com/media/profiles/2933805082.jpg",
     "score": 769,
     "username": "fintechfrank",
     "verified": true
    },
    {
     "name": "raj 🖤",
     "image": "https://twitterscore.s3.amazonaws.com/media/profiles/101833150.jpg",
     "score": 752,
     "username": "rajgokal",
     "verified": true
    }
   ],
   "total_alpha_followers": 397,
   "new_alpha_followers_diff": 233
  },
  {
   "name": "PaperDAO",
   "username": "paperdao_xyz",
   "twitter_id": "2105765863886409728",
   "description": "https://t.co/UrBbrxJxLX",
   "profile_url": "/twitter/paperdao_xyz",
   "blue_verified": true,
   "profile_image": "https://twitterscore.s3.amazonaws.
…
```

## `twitterscore.get_categories` — List TwitterScore's follower categories

`GET /get_categories` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 172 ms

One call returns all follower categories TwitterScore tracks. Each item is one category with its ID and name. Use the category ID in other endpoints like get_followers?category_id=.

Fields: `categories[].id` Category ID; `categories[].name` Category name (e.g. 'Venture Capitals', 'Founders')

```bash
curl "https://fetchapi.co/api/gw/twitterscore/get_categories" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "page": 1,
 "size": 10,
 "pages": 1,
 "total": 10,
 "success": true,
 "categories": [
  {
   "id": 1,
   "name": "Venture Capitals"
  },
  {
   "id": 2,
   "name": "Founders"
  },
  {
   "id": 3,
   "name": "Projects"
  }
 ]
}
```

## `twitterscore.get_categorized_followers_count` — Count an X account's smart followers by category (VCs, founders, influencers...)

`GET /get_categorized_followers_count` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 578 ms

One call returns counts of an X account's smart followers broken down by category (VCs, Founders, Projects, etc.). Each item is one category with its follower count.

| param | required | example / default |
|---|---|---|
| `username` | no | VitalikButerin |
| `twitter_id` | no |  |

Fields: `categories[].id` Category ID (null for 'All'); `categories[].name` Category name; `categories[].cnt` Count of smart followers in category

```bash
curl "https://fetchapi.co/api/gw/twitterscore/get_categorized_followers_count?username=VitalikButerin" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "success": true,
 "categories": [
  {
   "id": null,
   "cnt": 17582,
   "name": "All"
  },
  {
   "id": 3,
   "cnt": 3290,
   "name": "Projects"
  },
  {
   "id": 1,
   "cnt": 354,
   "name": "Venture Capitals"
  }
 ]
}
```

## `twitterscore.get_followers` — List an X account's smart followers, highest score first

`GET /get_followers` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 521 ms

One call returns an X account's smart followers sorted by Twitter Score (highest first), optionally filtered by category or tag. Each item is one follower. The answer held 5 items in our call. Get the next page by passing the `page` parameter (3509 pages total, 17543 followers).

| param | required | example / default |
|---|---|---|
| `username` | no | VitalikButerin |
| `twitter_id` | no |  |
| `page` | no | 1 |
| `size` | no | 5 |
| `category_id` | no |  |
| `tag_id` | no |  |
| `tag_category_id` | no |  |

Fields: `top_followers[].twitter_id` Follower's X account ID; `top_followers[].username` Follower's X username; `top_followers[].name` Follower's display name; `top_followers[].twitter_score` Follower's TwitterScore (0-1000); `top_followers[].followers_count` Follower's follower count; `top_followers[].categories` Follower's categories (VCs, Founders, etc.); `top_followers[].tags` Follower's tags (e.g. a16z, Solana); `top_followers[].subscribed_at` When follower started being tracked; `total` Total smart followers

```bash
curl "https://fetchapi.co/api/gw/twitterscore/get_followers?page=1&size=5&username=VitalikButerin" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "page": 1,
 "size": 5,
 "pages": 3509,
 "total": 17543,
 "success": true,
 "top_followers": [
  {
   "name": "Ansem 🐂🀄️",
   "tags": [],
   "username": "blknoiz06",
   "categories": [
    {
     "id": 2,
     "name": "Founders"
    },
    {
     "id": 8,
     "name": "Influencers"
    }
   ],
   "twitter_id": "973261472",
   "description": "coldest nigga breathing | @BullpenFi @MarketBubble",
   "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/973261472.jpg",
   "subscribed_at": "2024-05-20T15:02:13.822Z",
   "twitter_score": 1000,
   "followers_count": 1444306
  },
  {
   "name": "Balaji",
   "tags": [
    {
     "id": 1,
     "name": "a16z"
    }
   ],
   "username": "balajis",
   "categories": [
    {
     "id": 2,
     "name": "Founders"
    },
    {
     "id": 9,
     "name": "Angels"
    }
   ],
   "twitter_id": "2178012643",
   "description": "Author of the Network State. Founder of the Network School.",
   "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/2178012643.jpg",
   "subscribed_at": "2021-08-03T01:17:13.339Z",
   "twitter_score": 1000,
   "followers_count": 2254355
  },
  {
   "name": "toly 🇺🇸",
   "tags": [
    {
     "id": 13,
     "name": "Solana"
    }
   ],
   "username": "toly",
   "categories": [
    {
     "id": 2,
     "name": "Founders"
    },
    {
     "id": 9,
     "name": "Angels"
    }
   ],
   "twitter_id": "2327407569",
   "description": "Co-Founder of Solana Labs. Award winning phone creator. NFA
…
```

## `twitterscore.get_followers_diff` — Get how an X account's follower count changed over a week and a month

`GET /get_followers_diff` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 195 ms

One call returns how an X account's follower count changed over the last week and month. The answer shows the follower count difference (diff) and the reference date for each period, plus today's date.

| param | required | example / default |
|---|---|---|
| `username` | no | VitalikButerin |
| `twitter_id` | no |  |

Fields: `week.date` Date one week ago; `week.diff` Follower count change over the week; `month.date` Date one month ago; `month.diff` Follower count change over the month; `today` Today's date

```bash
curl "https://fetchapi.co/api/gw/twitterscore/get_followers_diff?username=VitalikButerin" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "week": {
  "date": "2026-10-01",
  "diff": 25701,
  "diff_str": "+25701"
 },
 "month": {
  "date": "2026-09-08",
  "diff": 176866,
  "diff_str": "+176866"
 },
 "today": "2026-10-08",
 "success": true
}
```

## `twitterscore.get_followers_score_sum` — Get the total Twitter Score of an X account's smart followers

`GET /get_followers_score_sum` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 342 ms

One call returns an X account's profile info and the total Twitter Score summed across all its smart followers. One item in the answer is the account's basic profile (name, username, description, follower count) plus aggregated metrics like followers_score_sum and smart_followers_count.

| param | required | example / default |
|---|---|---|
| `username` | no | VitalikButerin |
| `twitter_id` | no |  |

Fields: `username` X username; `twitter_id` X account ID; `name` Display name; `twitter_score` Account's Twitter Score; `followers_count` Total follower count; `followers_score_sum` Sum of Twitter Scores of smart followers; `smart_followers_count` Count of smart followers; `tags[]` Tags assigned to account (e.g. Ethereum); `categories[]` Categories assigned to account (e.g. Founders)

```bash
curl "https://fetchapi.co/api/gw/twitterscore/get_followers_score_sum?username=VitalikButerin" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "name": "vitalik.eth",
 "tags": [
  {
   "tag_id": 22,
   "tag_name": "Ethereum"
  }
 ],
 "success": true,
 "username": "VitalikButerin",
 "categories": [
  {
   "category_id": 2,
   "category_name": "Founders"
  },
  {
   "category_id": 8,
   "category_name": "Influencers"
  }
 ],
 "twitter_id": "295218901",
 "description": "I choose balance. First-level balance.\n\nmi pinxe lo crino tcati\n\nhttps://t.co/gCQrmCby7P",
 "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/295218901.jpg",
 "twitter_score": 1000,
 "followers_count": 7983358,
 "followers_score_sum": 1446487.0412130042,
 "smart_followers_count": 17543
}
```

## `twitterscore.get_mentioners` — List the unique accounts that mentioned an X account

`GET /get_mentioners` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 457 ms

One call returns a paged list of unique X accounts that mentioned a target account over a period (default 7 days). One item in the answer is a mentioner's profile with their Twitter Score and follower count. The answer held 10 items per page; get the next page by incrementing the page parameter.

| param | required | example / default |
|---|---|---|
| `username` | no | VitalikButerin |
| `twitter_id` | no |  |
| `period` | no |  |

Fields: `username` Target account's X username; `twitter_id` Target account's X ID; `mentioners[].username` Mentioner's X username; `mentioners[].twitter_id` Mentioner's X account ID; `mentioners[].twitter_score` Mentioner's Twitter Score; `mentioners[].followers_count` Mentioner's follower count; `page` Current page number; `pages` Total number of pages; `total` Total unique mentioners; `days` Period in days

```bash
curl "https://fetchapi.co/api/gw/twitterscore/get_mentioners?username=VitalikButerin" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "days": 7,
 "name": "vitalik.eth",
 "page": 1,
 "size": 10,
 "tags": [
  {
   "tag_id": 22,
   "tag_name": "Ethereum"
  }
 ],
 "pages": 6,
 "total": 59,
 "success": true,
 "username": "VitalikButerin",
 "categories": [
  {
   "category_id": 2,
   "category_name": "Founders"
  },
  {
   "category_id": 8,
   "category_name": "Influencers"
  }
 ],
 "mentioners": [
  {
   "name": "Laura Shin",
   "username": "laurashin",
   "twitter_id": "26377478",
   "blue_verified": true,
   "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/26377478.png",
   "twitter_score": 989.7846448753733,
   "followers_count": 297732
  },
  {
   "name": "OKX",
   "username": "okx",
   "twitter_id": "867617849208037377",
   "blue_verified": true,
   "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/867617849208037377.jpg",
   "twitter_score": 546.691826895881,
   "followers_count": 5601821
  },
  {
   "name": "The Rollup",
   "username": "therollupco",
   "twitter_id": "1172866088222244866",
   "blue_verified": true,
   "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/1172866088222244866.jpg",
   "twitter_score": 427.9095360317156,
   "followers_count": 61483
  }
 ],
 "twitter_id": "295218901",
 "description": "I choose balance. First-level balance.\n\nmi pinxe lo crino tcati\n\nhttps://t.co/gCQrmCby7P",
 "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/295218901.jpg",
 "followers_count": 7983358
}
```

## `twitterscore.get_mentions_feed` — List the posts that mention an X account, with author scores

`GET /get_mentions_feed` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 754 ms

One call returns a paged feed of posts that mention a target X account, ordered by recency. One item in the answer is a post with its text, engagement metrics (views, replies, retweets, favorites), author profile with Twitter Score, and any quoted tweet. The answer held 10 items per page; get the next page by incrementing the page parameter.

| param | required | example / default |
|---|---|---|
| `username` | no | VitalikButerin |
| `twitter_id` | no |  |
| `page` | no | 1 |
| `size` | no | 10 |

Fields: `mentions[].id` Post ID; `mentions[].text` Post text; `mentions[].created_at` Post creation timestamp; `mentions[].views` Post view count; `mentions[].replies` Reply count; `mentions[].retweets` Retweet count; `mentions[].favorites` Favorite count; `mentions[].author.username` Author's X username; `mentions[].author.twitter_id` Author's X account ID; `mentions[].author.twitter_score` Author's Twitter Score; `page` Current page number; `pages` Total number of pages; `total` Total mentions

```bash
curl "https://fetchapi.co/api/gw/twitterscore/get_mentions_feed?username=VitalikButerin" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "page": 1,
 "size": 10,
 "pages": 3295,
 "total": 32949,
 "success": true,
 "mentions": [
  {
   "id": "2107937331349279191",
   "text": "I’ve never seen @a1lon9 FSH a coin sent by his community\n\nbut @VitalikButerin on the other hand…",
   "urls": [],
   "media": [],
   "views": 2107,
   "author": {
    "name": "Alpha co",
    "tags": [],
    "username": "alpha_co",
    "categories": [
     {
      "id": 8,
      "name": "Influencers"
     },
     {
      "id": 2357709,
      "name": "Project Team"
     }
    ],
    "twitter_id": "1468363594878582784",
    "blue_verified": true,
    "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/1468363594878582784.jpg",
    "twitter_score": 174.0741044451576,
    "followers_count": 38174
   },
   "replies": 7,
   "retweets": 2,
   "favorites": 25,
   "created_at": "2026-10-07T20:53:18+00:00",
   "quoted_tweet": {
    "id": "2107841451648266503",
    "text": "BREAKING: Vitalik states that @Pumpfun has killed memecoins by turning new retail investors entering the crypto space into degenerate gamblers and with no real-world use, the industry will die fast. \n\nHe also stated that @pumpfun has been a net negative to crypto since it was",
    "urls": [],
    "media": [
     {
      "url": "https://pbs.twimg.com/media/HUCOL6CXMAIJPkk.jpg",
      "type": "photo"
     }
    ],
    "views": 379304,
    "author": {
     "name": "Maverick",
     "tags": [
      {
       "id": 62,
       "name": "Meme"
      }
     ],
     "
…
```

## `twitterscore.get_smart_mentions` — List the X accounts most mentioned by smart accounts

`GET /get_smart_mentions` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 197 ms

One call returns a paged list of X accounts most mentioned by smart accounts over a period (default 7 days), ranked by mention volume. One item in the answer is an account with its profile, total mentions, unique mentioners, mention and follower deltas vs the previous period, and a preview of top mentioners. The answer held 10 items per page; get the next page by incrementing the page parameter.

| param | required | example / default |
|---|---|---|
| `period` | no |  |
| `page` | no | 1 |
| `size` | no | 10 |

Fields: `data[].username` Mentioned account's X username; `data[].twitter_id` Mentioned account's X ID; `data[].twitter_score` Mentioned account's Twitter Score; `data[].mentions_total` Total mentions in period; `data[].unique_mentioners_total` Count of unique mentioners; `data[].mentions_diff_int` Mention count change vs previous period; `data[].followers_diff_int` Follower count change vs previous period; `data[].current_followers` Current follower count; `data[].top_mentioner` Top mentioner's profile; `data[].mentioners_list[]` Preview of top mentioners; `page` Current page number; `pages` Total number of pages; `days` Period in days

```bash
curl "https://fetchapi.co/api/gw/twitterscore/get_smart_mentions" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "data": [
  {
   "name": "Vangrid",
   "username": "vangrid_io",
   "categories": [
    {
     "id": 3,
     "name": "Projects"
    }
   ],
   "twitter_id": "2040692239366512640",
   "description": "Real-time, human-collected ground truth for Physical AI, World Models, Robotics and Sovereign Defense",
   "profile_url": "/twitter/vangrid_io",
   "blue_verified": true,
   "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/2040692239366512640.jpg",
   "top_mentioner": {
    "name": "Leafswan",
    "image": "https://twitterscore.s3.amazonaws.com/media/profiles/1366316376466587649.jpg",
    "score": 136,
    "username": "leaf_swan",
    "verified": true
   },
   "twitter_score": 17,
   "mentions_total": 5340,
   "mentioners_list": [
    {
     "name": "Leafswan",
     "image": "https://twitterscore.s3.amazonaws.com/media/profiles/1366316376466587649.jpg",
     "score": 136,
     "username": "leaf_swan",
     "verified": true
    },
    {
     "name": "Cryptking.eth 👑 🦍",
     "image": "https://twitterscore.s3.amazonaws.com/media/profiles/101640475.jpg",
     "score": 120,
     "username": "Cryptking_1",
     "verified": true
    },
    {
     "name": "🌱N𝗲𝘀𝘀𝗮",
     "image": "https://twitterscore.s3.amazonaws.com/media/profiles/1598765346122498061.jpg",
     "score": 105,
     "username": "ItsNessaOnX",
     "verified": true
    }
   ],
   "current_followers": 84693,
   "mentions_diff_int": 1079,
   "mentions_diff_str": "1 079",
   "followers_diff_int": -1113
…
```

## `twitterscore.get_tagged_followers_count` — Count an X account's smart followers by tag (a16z, Paradigm, Y Combinator...)

`GET /get_tagged_followers_count` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 557 ms

One call returns an X account's follower counts grouped by tag category (Tier 1 VC, Ecosystems, Sectors). The answer shows how many of the account's followers carry each tag, organized by tag category.

| param | required | example / default |
|---|---|---|
| `username` | no | VitalikButerin |
| `twitter_id` | no |  |

Fields: `data[].tag_category_name` Tag category (e.g. Tier 1 VC, Ecosystems); `data[].tags[].tag_name` Tag name (e.g. a16z, Ethereum); `data[].tags[].tag_id` Tag ID for use in other endpoints; `data[].tags[].cnt` Count of followers with this tag

```bash
curl "https://fetchapi.co/api/gw/twitterscore/get_tagged_followers_count?username=VitalikButerin" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "data": [
  {
   "tags": [
    {
     "cnt": 136,
     "tag_id": 1,
     "tag_name": "a16z"
    },
    {
     "cnt": 60,
     "tag_id": 66,
     "tag_name": "ConsenSys"
    },
    {
     "cnt": 40,
     "tag_id": 11,
     "tag_name": "Binance"
    }
   ],
   "tag_category_id": 1,
   "tag_category_name": "Tier 1 VC"
  },
  {
   "tags": [
    {
     "cnt": 29,
     "tag_id": 36,
     "tag_name": "CMS Holdings"
    },
    {
     "cnt": 24,
     "tag_id": 32,
     "tag_name": "Fabric Ventures"
    },
    {
     "cnt": 22,
     "tag_id": 23,
     "tag_name": "Electric Capital"
    }
   ],
   "tag_category_id": 2,
   "tag_category_name": "Tier 2 VC"
  },
  {
   "tags": [
    {
     "cnt": 1016,
     "tag_id": 22,
     "tag_name": "Ethereum"
    },
    {
     "cnt": 459,
     "tag_id": 13,
     "tag_name": "Solana"
    }
   ],
   "tag_category_id": 3,
   "tag_category_name": "Ecosystems"
  }
 ],
 "success": true
}
```

## `twitterscore.get_tags` — List TwitterScore's follower tags (funds, ecosystems, sectors)

`GET /get_tags` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 212 ms

One call returns a paged list of all TwitterScore follower tags (VCs, ecosystems, sectors). One item in the answer is a tag with its id, name, and tag categories. The answer held 10 items per page; get the next page by incrementing the page parameter.

Fields: `tags[].id` Tag ID for use in other endpoints; `tags[].name` Tag name (e.g. a16z, Ethereum); `tags[].tag_categories[].id` Category ID; `tags[].tag_categories[].name` Category name (e.g. Tier 1 VC); `page` Current page number; `pages` Total number of pages; `total` Total tags

```bash
curl "https://fetchapi.co/api/gw/twitterscore/get_tags" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "page": 1,
 "size": 10,
 "tags": [
  {
   "id": 1,
   "name": "a16z",
   "tag_categories": [
    {
     "id": 1,
     "name": "Tier 1 VC"
    }
   ]
  },
  {
   "id": 2,
   "name": "Coinbase Ventures",
   "tag_categories": [
    {
     "id": 1,
     "name": "Tier 1 VC"
    }
   ]
  },
  {
   "id": 3,
   "name": "Paradigm",
   "tag_categories": [
    {
     "id": 1,
     "name": "Tier 1 VC"
    }
   ]
  }
 ],
 "pages": 5,
 "total": 47,
 "success": true
}
```

## `twitterscore.get_tokenless` — List tokenless crypto projects ranked by follower growth

`GET /get_tokenless` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 922 ms

One call returns a paged list of tokenless crypto projects ranked by follower growth. One item in the answer is a project account with its profile, Twitter Score, current and previous follower counts, and the follower growth delta. The answer held 10 items per page; get the next page by incrementing the page parameter.

| param | required | example / default |
|---|---|---|
| `page` | no | 1 |
| `size` | no | 10 |

Fields: `data[].username` Project's X username; `data[].twitter_id` Project's X account ID; `data[].name` Project name; `data[].twitter_score` Project's Twitter Score; `data[].curr_followers_int` Current follower count; `data[].prev_followers_int` Previous period follower count; `data[].followers_diff_int` Follower count change; `page` Current page number; `pages` Total number of pages; `total` Total tokenless projects

```bash
curl "https://fetchapi.co/api/gw/twitterscore/get_tokenless" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "data": [
  {
   "img": "https://twitterscore.s3.amazonaws.com/media/profiles/574032254.png",
   "name": "Coinbase 🛡️",
   "username": "coinbase",
   "twitter_id": "574032254",
   "description": "The future of finance is on Coinbase. For support: @CoinbaseSupport",
   "twitter_score": 1000,
   "curr_followers_int": 7207394,
   "curr_followers_str": "7.21M",
   "followers_diff_int": 1089,
   "followers_diff_str": "1.09K",
   "prev_followers_int": 7206305,
   "prev_followers_str": "7.21M"
  },
  {
   "img": "https://twitterscore.s3.amazonaws.com/media/profiles/1628067904083181570.jpg",
   "name": "Base",
   "username": "base",
   "twitter_id": "1628067904083181570",
   "description": "Where the world transacts onchain. Base is beginning to explore a network token.",
   "twitter_score": 800.6845909903789,
   "curr_followers_int": 1563650,
   "curr_followers_str": "1.56M",
   "followers_diff_int": 1116,
   "followers_diff_str": "1.12K",
   "prev_followers_int": 1562534,
   "prev_followers_str": "1.56M"
  },
  {
   "img": "https://twitterscore.s3.amazonaws.com/media/profiles/1261335549215989760.jpg",
   "name": "Polymarket",
   "username": "Polymarket",
   "twitter_id": "1261335549215989760",
   "description": "The World's Largest Prediction Market. Trade politics, news, crypto, sports, & more. Available in the US: https://t.co/gZvEnIqUQy - DM @PolymarketHelp for support",
   "twitter_score": 764.2825463905045,
   "curr_followers_int": 2008804,
   "curr_followers_str": "2.01M",
…
```

## `twitterscore.get_top_researched` — List the 10 most-researched crypto X accounts in the last 24 hours

`GET /get_top_researched` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 188 ms

One call returns the 10 most-researched crypto X accounts in the last 24 hours, ranked by lookups on TwitterScore. Each item is one account with its profile data and engagement metrics. The answer held 10 items (one page).

Fields: `accounts[].username` X account username; `accounts[].name` Display name; `accounts[].twitter_score` TwitterScore rating (quality of followers); `accounts[].current_followers` Current follower count; `accounts[].followers_diff` Follower change in last 24 hours; `accounts[].verified` X verification status; `accounts[].description` Account bio; `accounts[].profile_image` Profile picture URL; `accounts[].categories` Account category tags

```bash
curl "https://fetchapi.co/api/gw/twitterscore/get_top_researched" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "page": 1,
 "size": 10,
 "pages": 1,
 "total": 10,
 "success": true,
 "accounts": [
  {
   "name": "Computers Rh",
   "tags": [],
   "username": "ComputersRh",
   "verified": true,
   "categories": [],
   "description": "Build your dream PC.\nPlay, upgrade & compete. \n\nOn @RobinhoodCrypto\n\nBy @0xArtix",
   "profile_url": "/twitter/ComputersRh",
   "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/2103440665694638080.jpg",
   "twitter_score": 9.786582344596274,
   "followers_diff": 401,
   "current_followers": 25215
  },
  {
   "name": "AlexBob",
   "tags": [],
   "username": "RealAlexBob",
   "verified": false,
   "categories": [],
   "description": "- Crypto Degen\n- Onchain Research\n\nRobinhood Maximalist",
   "profile_url": "/twitter/RealAlexBob/",
   "profile_image": null,
   "twitter_score": 0.18054322245051496,
   "followers_diff": 0,
   "current_followers": 0
  },
  {
   "name": "internoun.eth ⌐◨-◨",
   "tags": [],
   "username": "Internoun",
   "verified": true,
   "categories": [
    {
     "id": 2357709,
     "name": "Project Team"
    }
   ],
   "description": "intern at @nounsdao.",
   "profile_url": "/twitter/Internoun",
   "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/1913474107905093632.jpg",
   "twitter_score": 9.814518593797624,
   "followers_diff": -1,
   "current_followers": 4803
  }
 ]
}
```

## `twitterscore.get_trending` — List trending crypto X accounts (follower and score growth)

`GET /get_trending` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 188 ms

One call returns trending crypto X accounts over a specified period (default 30 days), showing follower and Twitter Score growth. Each item is one account with current and previous metrics. The answer held 10 items per page; pagination uses the `page` parameter and shows 98 total pages.

| param | required | example / default |
|---|---|---|
| `period` | no |  |
| `page` | no | 1 |
| `size` | no | 10 |

Fields: `data[].username` X account username; `data[].twitter_id` X account ID; `data[].name` Display name; `data[].twitter_score` Current TwitterScore rating; `data[].curr_followers` Current follower count; `data[].followers_diff_int` Follower change over period; `data[].twitter_score_diff_int` TwitterScore change over period; `data[].description` Account bio; `data[].img` Profile picture URL; `days` Period analyzed in days

```bash
curl "https://fetchapi.co/api/gw/twitterscore/get_trending" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "data": [
  {
   "img": "https://twitterscore.s3.amazonaws.com/media/profiles/2867689615.jpg",
   "url": "https://twitterscore.io/twitter/CompleteSkeptic",
   "name": "Diogo Almeida",
   "username": "CompleteSkeptic",
   "user_tags": [],
   "twitter_id": "2867689615",
   "description": "Sane + 🌶️ takes in an insane AI world... AI capabilities researcher: co-created RLHF/ChatGPT @ @openai now trying to right the wrong 🤭 (ceo @typesafeai)",
   "twitter_score": 199,
   "curr_followers": 150739,
   "prev_followers": 1326,
   "followers_diff_int": 149413,
   "followers_diff_str": "149 413",
   "prev_twitter_score": 13,
   "twitter_score_diff_int": 186,
   "twitter_score_diff_str": "186"
  },
  {
   "img": "https://twitterscore.s3.amazonaws.com/media/profiles/1357663203547877377.jpg",
   "url": "https://twitterscore.io/twitter/beniduboss",
   "name": "Beni",
   "username": "beniduboss",
   "user_tags": [],
   "twitter_id": "1357663203547877377",
   "description": "Co-founder stealth neolab | Building Novel Efficiency Infrastructure for LLM | Former Quant | Based in beautiful 🇨🇭",
   "twitter_score": 265,
   "curr_followers": 30759,
   "prev_followers": 19481,
   "followers_diff_int": 11278,
   "followers_diff_str": "11 278",
   "prev_twitter_score": 108,
   "twitter_score_diff_int": 157,
   "twitter_score_diff_str": "157"
  },
  {
   "img": "https://twitterscore.s3.amazonaws.com/media/profiles/15176635.jpg",
   "url": "https://twitterscore.io/twitter/pointfarmcap",
   "name": "P
…
```

## `twitterscore.get_twitter_info` — Get an X account's profile (TwitterScore)

`GET /get_twitter_info` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 186 ms

One call returns a single X account's profile data including username, display name, bio, follower count, and profile picture. The answer contains one account's full profile.

| param | required | example / default |
|---|---|---|
| `username` | no | VitalikButerin |
| `twitter_id` | no |  |

Fields: `username` X account username; `name` Display name; `followers_count` Total follower count; `description` Account bio; `profile_image` Profile picture URL; `tags` Topic tags (e.g. Ethereum); `categories` Account categories (e.g. Founders, Influencers)

```bash
curl "https://fetchapi.co/api/gw/twitterscore/get_twitter_info?username=VitalikButerin" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "name": "vitalik.eth",
 "tags": [
  {
   "tag_id": 22,
   "tag_name": "Ethereum"
  }
 ],
 "success": true,
 "username": "VitalikButerin",
 "categories": [
  {
   "category_id": 2,
   "category_name": "Founders"
  },
  {
   "category_id": 8,
   "category_name": "Influencers"
  }
 ],
 "description": "I choose balance. First-level balance.\n\nmi pinxe lo crino tcati\n\nhttps://t.co/gCQrmCby7P",
 "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/295218901.jpg",
 "followers_count": 7983358
}
```

## `twitterscore.get_twitter_score` — Get an X account's Twitter Score

`GET /get_twitter_score` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 215 ms

One call returns a single X account's Twitter Score, which rates account quality based on how many notable accounts follow it. The answer contains the username, X account ID, and the numerical score.

| param | required | example / default |
|---|---|---|
| `username` | no | VitalikButerin |
| `twitter_id` | no |  |

Fields: `username` X account username; `twitter_id` X account ID; `twitter_score` TwitterScore rating (quality metric)

```bash
curl "https://fetchapi.co/api/gw/twitterscore/get_twitter_score?username=VitalikButerin" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "success": true,
 "username": "VitalikButerin",
 "twitter_id": "295218901",
 "twitter_score": 1000
}
```

## `twitterscore.get_twitter_scores_diff` — Get how an X account's Twitter Score changed over a week and a month

`GET /get_twitter_scores_diff` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 189 ms

One call returns how a single X account's Twitter Score changed over the last week and last month. The answer shows the score difference for each period with the date of comparison.

| param | required | example / default |
|---|---|---|
| `username` | no | VitalikButerin |
| `twitter_id` | no |  |

Fields: `week.diff` Twitter Score change over last 7 days; `week.date` Date 7 days ago; `month.diff` Twitter Score change over last 30 days; `month.date` Date 30 days ago; `today` Current date

```bash
curl "https://fetchapi.co/api/gw/twitterscore/get_twitter_scores_diff?username=VitalikButerin" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "week": {
  "date": "2026-10-01",
  "diff": 0,
  "diff_str": "0"
 },
 "month": {
  "date": "2026-09-08",
  "diff": 0,
  "diff_str": "0"
 },
 "today": "2026-10-08",
 "success": true
}
```

## `twitterscore.limits` — Check the TwitterScore plan's requests left

`GET /limits` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 213 ms

One call returns the API plan's usage limits: monthly quota (used, total, remaining) and per-minute rate limit. The answer shows current consumption and reset time.

Fields: `rates[0].used` Monthly requests used; `rates[0].total` Monthly request quota; `rates[0].remaining` Monthly requests remaining; `rates[0].reset_time_at` When monthly quota resets; `rates[1].total` Per-minute request limit; `user_id` API user ID

```bash
curl "https://fetchapi.co/api/gw/twitterscore/limits" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "rates": [
  {
   "used": 100,
   "total": 10000,
   "period": "month",
   "remaining": 9900,
   "reset_time_at": "2026-11-05T18:47:14.240"
  },
  {
   "total": 60,
   "period": "minute"
  }
 ],
 "user_id": 36323
}
```