instagram

Similar

Returns the accounts Instagram suggests as similar to a given user, each with username, display name, avatar URL, verification status, and URL.

Use it to find accounts comparable to one you already know; it returns a single fixed list and cannot be paged.

Metered: 50–850 credits. We reserve the ceiling when the call starts and charge what it actually used when it finishes.

get/v1/instagram/similar

Request

  • Base URL: https://api.insightsocial.app
  • URL: https://api.insightsocial.app/v1/instagram/similar
  • 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.

include'profile'

Set to profile (one token only) to fill author.followers, author.following and author.bio on every row in this one call, plus author.posts_count where the lookup has an exact total. The hydrated list is its top 20 accounts unless you pass limit (1 to 80).

limitinteger

Take the top N accounts of the list (1 to 80). Without include=profile the full list is returned unless you cap it.

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.