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.

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.

Price

$0.000450 per result. That is the rate you pay for each result the call returns, so the total depends on how many it produces. Billing follows actual usage, so a call that returns fewer results costs less. discover and inspect also return a ceiling for your specific request, which is a maximum you will never be charged above.

Input

Field	Type	Required	Notes
`user_ids`	`array`		One numeric X user ID, as an alternative to user_names. When set, user_names is ignored.
`user_names`	`array`		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.
`getFollowers`	`boolean`	yes	Return the follower list. Defaults to `true`.
`getFollowing`	`boolean`	yes	Also return the following list. This adds up to maxFollowings more billed items on top of the followers. Defaults to `false`.
`maxFollowers`	`integer`	yes	How many followers to return. The actor rejects anything below 200. This is the field the price hold is sized from. Defaults to `200`.
`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. Defaults to `200`.

Goro forwards your input to the underlying tool unchanged, so any field the tool accepts works here even if it is not listed above.

Example

curl -X POST https://api.usegoro.ai/v1/run \
  -H "Authorization: Bearer $GORO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"twitter.followers","input":{"maxFollowers":200,"maxFollowings":200,"getFollowers":true,"getFollowing":false}}'

Response

One row of the response. Values are illustrative.

{
  "id": 100000000000000000,
  "url": null,
  "name": "Example Follower",
  "type": "follower",
  "id_str": "100000000000000001",
  "location": "",
  "verified": false,
  "protected": false,
  "created_at": "Mon Jan 01 12:00:00 +0000 2024",
  "description": "Example account used to show the shape of a follower record.",
  "media_count": 2,
  "screen_name": "example_follower",
  "listed_count": 0,
  "friends_count": 555,
  "statuses_count": 12,
  "followers_count": 1,
  "target_username": "example_account",
  "favourites_count": 126,
  "profile_banner_url": "https://example.com/banners/example_follower",
  "profile_image_url_https": "https://example.com/avatars/example_follower_normal.jpg"
}

Guide

CLI reference

API reference

Tools

X followers and following

Price

Input

Example

Response

​Price

​Input

​Example

​Response

Price

Input

Example

Response