InsightSocial API
Twitter/X

Twitter/X Following API reference

Your first 10 calls are free, no card needed. Pricing and FAQ

Get a free API key
Example request
curl "https://api.insightsocial.app/v1/twitter/user/following?handle=News24" \
  -H "x-api-key: $INSIGHTSOCIAL_API_KEY"
GET
/v1/twitter/user/following

Returns the accounts an X (Twitter) user follows, each with the handle, display name, bio, follower and tweet counts, privacy flag, and join date.

Use it to map who an account pays attention to. Page size is set by the source and the cursor pages deeper; verification status is not readable here and returns null.

10 credits per call.

Paginates by cursor: see Pagination.

Authorization

apiKey
x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

handle*string

Twitter username without the @ symbol

cursor?string

Cursor from the previous response's pagination.next_cursor to fetch the next page

dry_run?"1"

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Value in

  • "1"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.insightsocial.app/v1/twitter/user/following?handle=string"
{  "success": true,  "platform": "string",  "endpoint": "string",  "schema_version": "2",  "pagination": {    "next_cursor": "string",    "has_more": true,    "page_size": 0,    "stopped_at": "since"  },  "unavailable": [    "string"  ],  "credits_used": 0,  "credits_remaining": 0,  "request_id": "string",  "cached": true,  "idempotent_replay": true,  "charge_reason": "string",  "free_call": true,  "data": {    "items": [      {        "author": {          "id": "string",          "username": "string",          "display_name": "string",          "avatar_url": "http://example.com",          "bio": "string",          "verified": true,          "followers": 0,          "followers_approximate": true,          "following": 0,          "posts_count": 0,          "likes_count": 0,          "url": "http://example.com",          "location": "string",          "external_url": "http://example.com",          "private": true,          "joined_at": "2019-08-24T14:15:22Z",          "last_post_at": "2019-08-24T14:15:22Z",          "ext": {            "property1": null,            "property2": null          }        }      }    ],    "total": 0,    "truncated": true,    "ext": {      "property1": null,      "property2": null    }  }}

User › Followers GET

Returns the accounts following an X (Twitter) user, each with the handle, display name, bio, follower and tweet counts, privacy flag, and join date.

User › Media GET

Returns the tweets on an account's Media tab, only those carrying a photo or video, with media URLs, engagement counts, and creation time. View and bookmark counts are null here.