instagram

Followers

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: 50–100 credits. We reserve the ceiling when the call starts and charge what it actually used when it finishes.

Paginates by cursor: see Pagination.

get/v1/instagram/followers

Request

  • Base URL: https://api.insightsocial.app
  • URL: https://api.insightsocial.app/v1/instagram/followers
  • Auth: API key in header x-api-key

Query parameters

handlestring
Example:mrbeast

Instagram username without the @ symbol. Provide at least one of: handle, user_id.

user_idstring

Instagram numeric user ID. Use this for faster responses. Provide at least one of: handle, user_id.

cursorstring

Pagination cursor. Use the next_cursor from the previous response to fetch the next page.

coverage'full'

Send full to walk a merged list: accounts are added from several reads of the list and no account appears twice inside a page, until the rows reach the profile's count in data.total. A handful of accounts can still repeat across consecutive pages, so dedupe on the account id when you combine pages. Requires handle. A page usually takes about 8 seconds and can take up to about 45, and a 503 is retried with the same cursor. A cursor from this mode only continues this mode.

dry_run'1'

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Response

Success.

successtrue required
platformstring required
endpointstring required
schema_version'2' required
unavailablestring[] required
credits_usedinteger required
credits_remaininginteger required
request_idstring required
cachedboolean required
idempotent_replayboolean required
charge_reasonstring required
free_callboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.