InsightSocial
GET /v1/twitter/profile/fullbeta

Twitter/X Profile Full API

Returns an X account's profile and its recent tweets in one call. Use it instead of calling profile and user/tweets yourself.

50 credits a call · cursor pagination · failed calls free · 10 free calls to start

curl "https://api.insightsocial.app/v1/twitter/profile/full?handle=mrbeast" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "twitter",
"endpoint": "/v1/twitter/profile/full",
"schema_version": "2",
"data": {
"<field>": "<value>"
},
"pagination": {
"next_cursor": "<string | null>",
"has_more": "<boolean>"
},
"unavailable": [],
"credits_used": "<integer>"
}

Parameters

Query parameters for GET /v1/twitter/profile/full. Send your key in the x-api-key header.

NameRequiredDescription
handleYesX (Twitter) username or handle, with or without a leading @. One of the identity params is required.
postsNoHow many of the fetched recent posts to return and compute the metrics over (1-100, default 25).
cursorNoPass a prior response's posts_cursor to read the next page of posts.
includeNo—
max_age_sNoThe oldest cached copy you accept, in seconds. A copy that old or younger is served, with its age in age_s and the X-Cache-Age header. Without it a copy up to 900 seconds old is served; this endpoint keeps copies for 3600 seconds, so a value up to 3600 can save a call. A lower value fetches fresh (billed) when the copy is older, and 0 always fetches live, like Cache-Control: no-cache.

Response

This endpoint is beta: data holds the platform's own fields under our naming rules (snake_case keys, string ids, ISO times where the platform gives a timestamp) rather than a unified post or profile, and those fields may change.

Every field, error and example is in the Twitter/X Profile Full API reference.

How much does the Twitter/X Profile Full API cost?

50 credits per successful call.

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Know the price first

    Add dry_run=1 and the response quotes the call without making it. Nothing is charged.

  • One balance

    API calls and Chrome extension exports share the same credits, on the free plan too.

Twitter/X Profile Full API: frequently asked questions

Send GET /v1/twitter/profile/full with the handle parameter and your key in the x-api-key header. Returns an X account's profile and its recent tweets in one call. Use it instead of calling profile and user/tweets yourself.