InsightSocial APIProfile › Full
Returns an X account's profile, its recent tweets, and computed metrics in one call: engagement rate by views and by followers, posting cadence, top post, and format mix.
Use it instead of calling profile and user/tweets yourself. The metrics are computed from one fetch of the account tweets, so check _warnings before reading cadence as a true rate.
100 credits per call.
Re-running the exact same call within 6h is free.
Paginates by cursor — see Pagination.
Authorization
apiKey Your key from the dashboard. It starts with isk_.
In: header
Query Parameters
X (Twitter) username or handle, with or without a leading @. One of the identity params is required.
How many of the fetched recent posts to return and compute the metrics over (1-100, default 25). One call reads one page, which on X (Twitter) is about 10 to 20 tweets (a page of about 20, less the replies to other accounts), so a larger value returns that page and a _warnings note; pass posts_cursor back as cursor for the next page.
Pass a prior response's posts_cursor to read the next page of posts.
CSV subset of posts,computed (default both). include=computed omits the raw posts[] array from the response to save payload. The metrics are computed from the same fetched posts either way, so they do not change.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/twitter/profile/full?handle=string"{ "success": true, "platform": "instagram", "endpoint": "/v1/instagram/profile/posts", "data": { "items": [ "…" ], "dropped": 0 }, "pagination": { "next_cursor": "is2.eyJwIjoyfQ", "has_more": true, "page_size": 12 }, "credits_used": 20, "credits_remaining": 9980, "request_id": "req_1a2b3c4d5e6f", "cached": false, "idempotent_replay": false, "charge_reason": "miss", "free_call": false}Community GET
Returns an X (Twitter) community's details: name, description, member count, rules, and creation date. Use it when you have a community URL and want the group itself; community/tweets returns what has been posted inside it. **20 credits** per call. Re-running the exact same call within 6h is free.
Profile GET
Returns an X (Twitter) account's public profile: follower count, following count, tweet count, bio, profile and banner image URLs, and verification status. Use it when you have a handle and want a quick account snapshot before pulling its tweets. **20 credits** per call. Re-running the exact same call within 24h is free.