X followers and following
The follower list, and optionally the following list, of an X (Twitter) account, with each user's handle, display name, bio, location, follower and following counts, tweet and media counts, verification status, join date, and profile images.
What a call costs
Billed on actual usage, minimum $0.0020 per call, capped at $25.00 per call.
a price before every call. failed calls are never charged.
When to use it
Use to map who follows an X account, to size and profile an audience, to find overlap between two accounts, or to build a lead list from a niche account's followers. One account per call, and set maxFollowers to how many you actually want since that is what you pay for.
Inputs
X followers and following takes 6 fields, 4 of them required. Anything you leave out falls back to the tool's own default.
| Field | Type | Required | What it does |
|---|---|---|---|
| getFollowers | boolean | yes | Return the follower list. |
| getFollowing | boolean | yes | Also return the following list. This adds up to maxFollowings more billed items on top of the followers. |
| maxFollowers | integer | yes | How many followers to return. The actor rejects anything below 200. This is the field the price hold is sized from. |
| maxFollowings | integer | yes | How many followed accounts to return, only used when getFollowing is true. The actor rejects anything below 200. Keep this at or below maxFollowers, since the hold is sized from maxFollowers. |
| user_ids | array of string | optional | One numeric X user ID, as an alternative to user_names. When set, user_names is ignored. |
| user_names | array of string | optional | One X handle, without the @ sign. One account per call: the counts below apply per account, so a second account would double the bill against the same hold. |
How to call it
Connect once and your agent can reach X followers and following the same way it reaches everything else in the catalog. Add Goro as an MCP connector, or paste the setup line into an agent that reads skills.
MCP
Add this server in Claude, Claude Code, or any MCP client.
https://mcp.usegoro.ai/mcp
Skill
One line in your agent's chat. It sets itself up.
set up https://usegoro.ai/SKILL.mdOr plain HTTP
POST /v1/run
{
"endpoint": "twitter.followers",
"input": {
"getFollowers": true,
"getFollowing": false,
"maxFollowers": 200,
"maxFollowings": 200
}
}Related tools
More from social platforms, or browse the full tool catalog.
Twitter search
Search recent tweets on X (Twitter) by keyword, hashtag, or advanced query and get back tweet text, author, and engagement metrics.
from $0.0012 per resultX profile
Public profile data for one or more X (Twitter) accounts: display name, bio, follower and following counts, tweet and media counts, verification...
from $0.0006 per resultFacebook Ads Library
Ads from the public Facebook Ads Library for a page or a keyword search, with creative body, headline, call to action, landing URL, run dates,...
from $0.002250 per resultFacebook events
Structured Facebook event records: name, description, start time and duration, going, interested and responded counts, venue with address,...
from $0.03 per eventFurther reading: Social listening with AI agents: track mentions, trends and competitors
Run X followers and following from your agent.
One balance for every tool in the catalog. Start with Build, $25 of credit for $19 a month.
Get started