> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usegoro.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 co

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.

<Note>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.</Note>

## 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`. |

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

## Example

```bash theme={null}
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.

```json theme={null}
{
  "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"
}
```