Skip to main content

What it does

Returns profile information for an Instagram user including bio, follower counts, profile picture, and account metadata. Look up any public Instagram account by username.

Tool details

FieldValue
Tool nameinstagram.get_user
PlatformInstagram
REST endpointGET /v1/instagram/users/{username}
Result typeDetail tool

Parameters

ParameterSourceTypeRequiredDescription
usernamepathstringYesInstagram username (with or without @ symbol)
projection_presetsharedstringNoOptional. Defaults to minimal. Allowed values: full, minimal, identity, engagement, content.
data_fieldssharedstring[]NoOptional. Adds top-level keys from data on top of the selected projection_preset.

Example

{
  "name": "instagram.get_user",
  "arguments": {
    "username": "khaby.lame",
    "projection_preset": "minimal",
    "data_fields": [
      "entityId",
      "name",
      "preferredUsername",
      "summary"
    ]
  }
}

Available data fields

[
  "@context",
  "type",
  "id",
  "url",
  "entityId",
  "name",
  "preferredUsername",
  "summary",
  "attachment",
  "isPrivate",
  "isVerified",
  "isPaidVerified",
  "isBusiness",
  "isProfessional",
  "category",
  "pronouns",
  "hasVideos",
  "hasChannel",
  "hasMicroblog",
  "followerCount",
  "followingCount",
  "mediaCount",
  "videoCount",
  "highlightCount",
  "icon",
  "image"
]

Response notes

Successful calls return a JSON object with a top-level data field and, when available, metadata.creditsUsed and metadata.creditsRemaining. See response format, pagination, and credits.