InsightSocial API
Instagram

Engagement

GET
/v1/instagram/engagement

Returns a computed engagement report for an account: overall engagement rate, follower count, total likes and comments, and a per-post breakdown.

Use it when you want the engagement math done for you, including likes and comments per hour on each post, rather than raw posts to total yourself.

100 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

handle*string

Instagram username without the @ symbol.

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/instagram/engagement?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}

Comment GET

Returns one comment's current text, like count, reply count, author, and timestamp, plus the post's total comment count for context. Use it when you already know which comment you want, so you do not have to page through post/comments to find it again. **Metered: 100–300 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.

Followers GET

Returns the accounts that follow a user, each with username, display name, avatar URL, verification status, and profile URL. Use it to walk an account's follower list, passing either handle or user_id and paging deeper with the cursor it returns. **Metered: 100–200 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).