# Twitter Following Scraper (X) (`sfoln/x-following`)

Export the accounts any public X (Twitter) user follows, most recent first, as flat profiles: handle, name, bio, location, website, follower and following counts and join date. $0.30 per 1,000 accounts + $0.002 per page of up to 200. Up to 5,000 per account.

- Family: Social media data
- Categories: Social media, Lead generation, Automation
- Availability: on request (private on Apify). Email contact@sfoln.com with subject "Access request: Twitter Following Scraper (X) (sfoln/x-following)" before calling; calls fail until it is public.
- JSON: https://www.sfoln.com/actors/x-following.json
- MCP: https://mcp.apify.com?tools=sfoln/x-following
- REST (sync): POST https://api.apify.com/v2/actors/sfoln~x-following/run-sync-get-dataset-items
- REST (async): POST https://api.apify.com/v2/actors/sfoln~x-following/runs

Twitter Following Scraper (X) exports the accounts any public X (Twitter) user follows, most recently followed first, as clean, flat profile records: handle, name, bio with expanded links, location, website, follower / following / post counts, avatar, account creation date and automated-account label. Use it to map interests and influence networks, discover sources a competitor or journalist relies on, build prospect lists, or enrich social-graph datasets.

## Price per delivered record

| Event | Price | Per 1,000 | Charged for |
| --- | --- | --- | --- |
| X followed account profile (`x-following-profile`) | $0.0003 | $0.30 / 1,000 | Charged once per followed-account profile delivered. |
| Following page (`x-following-query`) | $0.002 | $2 / 1,000 | Charged once per upstream page of up to 200 followed accounts, including the last page and empty pages; covers the provider's per-call minimum. |

Pay-per-event, USD, billed by Apify; no platform usage charge. Only records with status `ok` are charged. Cap a run with `maxTotalChargeUsd`. Apify free plan: up to 10 per run.

## Run

```bash
curl -X POST "https://api.apify.com/v2/actors/sfoln~x-following/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"handles":["apify"],"maxFollowingPerUser":20}'
```

MCP client configuration:

```json
{
  "mcpServers": {
    "apify": {
      "type": "http",
      "url": "https://mcp.apify.com?tools=sfoln/x-following"
    }
  }
}
```

Example prompt: List the accounts that @apify follows on X and group them by what they do, based on their bios.

## Input

Paste X (Twitter) handles. The Actor returns the accounts they follow (most recent first), one dataset record per followed account, plus one summary record per input account.

| Field | Type | Default | Meaning |
| --- | --- | --- | --- |
| `handles` (required) | array | — | Handles or profile URLs: X handles (with or without @) or profile URLs, one per line. Duplicates are removed. Accounts on the Apify free plan can process up to 10 accounts per run. |
| `maxFollowingPerUser` | integer | `200` | Max followed accounts per input account: How many of the most recently followed accounts to return per input account (1–5000). |
| `maxItems` | integer | `1000` | Max accounts: Safety cap on the number of accounts processed in this run. Accounts beyond it are not processed or charged; their number is reported in the run's status message and OUTPUT (inputItemsDropped). |
| `concurrency` | integer | `3` | Concurrency: Accounts processed in parallel (1–5). |
| `itemTimeoutSecs` | integer | `300` | Per-account time limit (seconds): Stop paginating an account after this long; rows already delivered are kept. |
| `includeRaw` | boolean | `false` | Include raw upstream response: Attach the unmodified TwitterAPI.io user object to each record under `raw`. |

Example input:

```json
{
  "handles": [
    "apify"
  ],
  "maxFollowingPerUser": 20
}
```

## Output

One record per input item with `status` (`ok` is charged; `not_found`, `error`, `skipped_*` are free) and `charged`. The run stores an `OUTPUT` summary record.

| Field | Type | Meaning |
| --- | --- | --- |
| `input` | string | object | Input: The input item this record corresponds to. |
| `status` | string | Status: ok \| not_found \| error \| skipped_invalid \| skipped_budget \| skipped_free_plan (result rows are always ok) |
| `charged` | boolean | Charged: Whether this record incurred a pay-per-event charge. |
| `chargedEvent` | string | Charged event: Pay-per-event event charged for this record. |
| `source` | string | Source: Upstream data source (twitterapi = TwitterAPI.io). |
| `fetchedAt` | string | Fetched at: ISO timestamp. |
| `error` | object | Error: code / message when status is not ok. |
| `warnings` | array | Warnings: Non-fatal notes (e.g. stopped early). |
| `recordType` | string | Row type: following (one per profile, charged) \| account-summary (one per input account, free). |
| `ofHandle` | string | null | Of account: The input account whose followings this row lists. |
| `position` | integer | null | Position: 1 = most recent following (newest first). |
| `handle` | string | null | Handle: X handle without @. |
| `userId` | string | null | User id: Numeric X user id as a string. |
| `name` | string | null | Name: Display name. |
| `bio` | string | null | Bio: Profile description with t.co links expanded. |
| `location` | string | null | Location: Free-text profile location. |
| `url` | string | null | Website: Website link from the profile (expanded). |
| `profileUrl` | string | null | Profile URL: https://x.com/<handle>. |
| `followers` | integer | null | Followers: Follower count. |
| `following` | integer | null | Following: Accounts followed. |
| `tweets` | integer | null | Posts: Total posts incl. replies and reposts (statusesCount). |
| `likes` | integer | null | Likes given: Posts this account has liked (favouritesCount). |
| `mediaCount` | integer | null | Media: Media posts. |
| `isBlueVerified` | boolean | null | Blue verified: Has a blue check (null when the endpoint does not report it). |
| `verifiedType` | string | null | Verified type: Business / Government / null. |
| `profileImageUrl` | string | null | Avatar: Profile image URL. |
| `coverImageUrl` | string | null | Banner: Banner image URL. |
| `createdAt` | string | null | Created at: ISO 8601 account creation time. |
| `isAutomated` | boolean | null | Automated: Labelled as an automated account. |
| `automatedBy` | string | null | Automated by: Handle of the operator of an automated account. |
| `canDm` | boolean | null | Can DM: Accepts direct messages. |
| `possiblySensitive` | boolean | null | Possibly sensitive: Marked as possibly sensitive. |
| `withheldInCountries` | array | Withheld in: Country codes where the account is withheld. |
| `pinnedTweetIds` | array | Pinned post ids: Ids of pinned posts. |
| `unavailable` | boolean | null | Unavailable: Account is suspended / deactivated / unavailable. |
| `unavailableReason` | string | null | Unavailable reason: e.g. suspended. |
| `unavailableMessage` | string | null | Unavailable message: Upstream message for unavailable accounts. |
| `followingsReturned` | integer | null | Rows returned: followings delivered for this account (summary rows). |
| `pageFeesCharged` | integer | null | Page fees charged: Per-page events charged for this account (summary rows). |
| `pageFeeEvent` | string | null | Page fee event: Event name of the per-page fee (summary rows). |
| `pagesFetched` | integer | null | Pages fetched: Upstream pages fetched (summary rows). |
| `stopReason` | string | null | Stop reason: limit \| end \| budget \| deadline \| empty_pages \| max_pages \| error (summary rows). |

Example record:

```json
{
  "input": "NASA",
  "recordType": "following",
  "ofHandle": "NASA",
  "position": 1,
  "handle": "NASAWebb",
  "userId": "1100000000",
  "name": "NASA Webb Telescope",
  "bio": "Unfolding the universe. https://www.nasa.gov/webb",
  "location": "Space",
  "url": "https://www.nasa.gov/webb",
  "profileUrl": "https://x.com/NASAWebb",
  "followers": 2900000,
  "following": 120,
  "tweets": 6100,
  "likes": 900,
  "mediaCount": 2300,
  "isBlueVerified": null,
  "verifiedType": null,
  "profileImageUrl": "https://pbs.twimg.com/profile_images/1/a_normal.jpg",
  "coverImageUrl": null,
  "createdAt": "2010-05-21T14:00:00.000Z",
  "isAutomated": false,
  "automatedBy": null,
  "canDm": false,
  "possiblySensitive": false,
  "withheldInCountries": [],
  "pinnedTweetIds": [],
  "unavailable": false,
  "unavailableReason": null,
  "unavailableMessage": null,
  "status": "ok",
  "charged": true,
  "chargedEvent": "x-following-profile",
  "source": "twitterapi",
  "fetchedAt": "2026-10-14T10:00:00.000Z"
}
```

## Related

- [Twitter Followers Scraper (X)](https://www.sfoln.com/actors/x-followers.md) (`sfoln/x-followers`)
- [Twitter Profile Scraper (X)](https://www.sfoln.com/actors/x-profile-lookup.md) (`sfoln/x-profile-lookup`)
- [Twitter (X) Account Audit – Engagement](https://www.sfoln.com/actors/x-account-overview.md) (`sfoln/x-account-overview`)

Publisher: SFOLN LLC, contact@sfoln.com. Catalogue: https://www.sfoln.com/catalog.json. Agent guide: https://www.sfoln.com/agents.md.