InsightSocial API
Twitter/X

Tweet

GET
/v1/twitter/tweet

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

Use it when you have a tweet URL and need its complete record, including the quote count that the user timeline does not carry.

20 credits per call.

Re-running the exact same call within 6h is free.

Authorization

apiKey
x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

url*string

Full URL of the tweet. The numeric status id is what identifies it; the handle in the path is not checked

trim?boolean

Accepted for backwards compatibility and ignored. It shrank the raw payload, which the canonical response never exposed, so it changed nothing you can see and cost the author details

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/tweet?url=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}

Tweet › Transcript GET

Returns the transcript of a video attached to a tweet, including auto-generated captions. Use it when a tweet carries video and you need the spoken words; tweet returns the media attachment but not its speech. **200 credits** per call. Re-running the exact same call within 6h is free.

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. 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. **20 credits** per call. Re-running the exact same call within 6h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).