---
title: "Followings"
method: GET
path: "/v1/scrape/twitter/followings"
tags: ["twitter"]
---

# Followings

`GET /v1/scrape/twitter/followings`

## Request

- Base URL: `https://api.sociavault.com`
- URL: `https://api.sociavault.com/v1/scrape/twitter/followings`
- Auth: API key in header `X-API-Key`

Get the list of accounts a user is following, paginated at up to 70 per request. Use the cursor parameter to load more.

**Tip:** Use the `/v1/scrape/twitter/profile` endpoint to resolve a user's `rest_id` from their handle.

## Query parameters

- `user_id` string, required
- `cursor` string

## Response `200`

Successful response

**Key Response Fields:**

**Pagination:**
- `data.cursor.bottom`: Pass as `cursor` query param to get the next page of followings
- `data.cursor.top`: Cursor for the previous page

**Timeline Structure:**
- `data.result.timeline.instructions[0]`: `TimelineClearCache` (internal, can ignore)
- `data.result.timeline.instructions[1]`: `TimelineTerminateTimeline` direction Top
- `data.result.timeline.instructions[2]`: `TimelineTerminateTimeline` direction Bottom — indicates no more results when present
- `data.result.timeline.instructions[3].entries[]`: Array of following entries (type `TimelineAddEntries`)

**Each Following** (at `entries[].content.itemContent.user_results.result`):
- `.rest_id`: User's numeric ID
- `.is_blue_verified`: Whether user has a blue checkmark
- `.legacy.name`: Display name
- `.legacy.screen_name`: Handle (username without @)
- `.legacy.description`: Bio
- `.legacy.followers_count`: Follower count
- `.legacy.friends_count`: Following count
- `.legacy.statuses_count`: Total tweet count
- `.legacy.favourites_count`: Total likes given
- `.legacy.media_count`: Total media posts
- `.legacy.listed_count`: Number of lists the user is on
- `.legacy.created_at`: Account creation date
- `.legacy.location`: Location set by user
- `.legacy.profile_image_url_https`: Profile picture URL
- `.legacy.profile_banner_url`: Banner image URL
- `.legacy.protected`: Whether account is private
- `.legacy.verified`: Legacy verified status
- `.professional.professional_type`: `Creator` or `Business` (if applicable)

## Other responses

- `400`: Bad Request - Invalid parameters or missing required fields
- `401`: Unauthorized - Invalid or missing API key
- `402`: Payment Required - Insufficient credits
- `500`: Internal Server Error

---

[API](https://skmtc.dev/sociavault/apis/sociavault-api.md) · [All operations](https://skmtc.dev/sociavault/apis/sociavault-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sociavault/apis/sociavault-api/revisions/0a430c97f53a?raw)