InsightSocial API
Twitter/X

User › Media

GET
/v1/twitter/user/media

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.

Use it to pull an account's visual output without the text-only tweets user/tweets includes; the cursor pages deeper into the media grid.

20 credits per call.

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

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

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/user/media?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}

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

User › Tweets GET

Returns an account's most recent tweets in descending order, with full text, like, retweet, reply, bookmark and view counts, media, and creation time. Around 20 tweets per page. Use it to read a timeline: pages come newest first, retweets and self-threads included, and you can page deeper by sending pagination.next_cursor back as cursor. **Metered: 20–100 credits.** We reserve the ceiling when the call starts and charge what it actually used when it finishes. Re-running the exact same call within 6h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).