InsightSocial API
Twitter/X

Twitter/X Followers 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/followers?handle=News24" \
  -H "x-api-key: $INSIGHTSOCIAL_API_KEY"
GET
/v1/twitter/user/followers

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

Use it to sample an account's audience. Page size is set by the source, around 70 accounts, 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/followers?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    }  }}

Tweet GET

Returns one tweet in full: its text, like, retweet, reply and quote counts, media attachments, author info, and creation timestamp.

User › Following GET

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