fetchapi
See who started following an X account on a date API
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.
1 live route on X, from $0.00 per call. Every route below answered our last live test on 2026-10-08; the gateway re-tests them daily.
Price per call, by route
The upstream price you are metered at, cheapest first. A route without a published price says so.
| Provider | Endpoint | Price |
|---|---|---|
List the notable accounts that followed an X account on a given dayGET friendshipHistory/followed | $0.00$0.0e+00 / 1k calls |
What it returns
From a real call to the route: TwitterScore.
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.
data[].twitter_idFollower's X account IDdata[].usernameFollower's X usernamedata[].nameFollower's display namedata[].actionAction on date: 'Followed' or 'Unfollowed'data[].twitter_scoreFollower's TwitterScore (0-1000)data[].followers_countFollower's follower countdata[].categoriesFollower's categories (VCs, Founders, etc.)data[].descriptionFollower's bioCall it
HTTP with your key in x-api-key, or the call_endpoint tool of our MCP server.
Parameters
| Parameter | Type | Notes | |
|---|---|---|---|
| username | string · query | optional | X username without @ (or send twitter_id instead).e.g. VitalikButerin |
| twitter_id | string · query | optional | X numeric id (or send username instead). |
| date | string · query | required | Day to read, YYYY-MM-DD.e.g. 2026-10-06 |
| tag_ids | string · query | optional | Only accounts with these tag ids (comma-separated). |
| size | integer · query | optional | Rows. · default 10e.g. 10 |
HTTP
curl "https://fetchapi.co/api/gw/twitterscore/friendshipHistory/followed?date=2026-10-06&size=10&username=VitalikButerin" \ -H "x-api-key: YOUR_KEY"
MCP
call_endpoint("twitterscore.friendship_history_followed", {"date": "2026-10-06", "size": "10", "username": "VitalikButerin"})Real example answer (trimmed) · 2026-10-08
{
"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
}Related X APIs
- Check TwitterScore requests leftfrom $0.00
- Count an X account's followers from each VC fundfrom $0.00
- Count an X account's smart followers by categoryfrom $0.00
- Find X accounts that smart money just started followingfrom $0.00
- Find tokenless crypto projects (airdrop candidates)from $0.00
- Get a crypto X account's Twitter Scorefrom $0.00
- Get an X account's follower historyfrom $0.00
- Get an X account's profilefrom $0.00
One key for every API on this page.
Call it over HTTP or from any MCP client. Each key has a rate limit and a monthly cap; calls are metered at the upstream price.