Get an Instagram user's public profile

POST/v1/tools/instagram.user.profile/callsNeeds an API key

Returns an Instagram user's public profile, with bio, follower count and post count. Use it to look up an account and get the user ID that instagram.user.posts takes.

Tool instagram.user.profile on Instagram. Contract version 1, released 2026-10-27.

Over REST, send the input in the body. Over MCP, pass the same input to call_tool.

Both return the full response: the call's ID, status and cost, with this tool's result in output.

Input

usernamestringRequired

The user's handle, without the @.

Output

A successful call returns these blocks in its output. A field not marked required can be null.

`user`

One object. Can be null.

idstring

Instagram's numeric identifier of the user, as a string, which instagram.user.posts takes as user_id.

usernamestringRequired

The user's handle, without the @. The profile is at https://www.instagram.com/ followed by it.

namestring

The user's display name.

biostring

The text of the user's profile.

bio_linkstring

The link on the user's profile.

image_urlstring

Address of the user's profile picture. Instagram's media addresses expire.

verifiedboolean

Whether Instagram marks the user as verified.

privateboolean

Whether the account is private, its posts shown only to approved followers.

follower_countinteger

following_countinteger

Number of accounts the user follows.

post_countinteger

Number of posts the user published.

curl https://api.voxoria.ai/v1/tools/instagram.user.profile/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"username":"instagram"}}'

import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/instagram.user.profile/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={"input": {"username": "instagram"}},
    timeout=60,
)
print(response.json())

const response = await fetch("https://api.voxoria.ai/v1/tools/instagram.user.profile/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"input": {"username": "instagram"}}),
});
console.log(await response.json());

{
  "name": "call_tool",
  "arguments": {
    "tool": "instagram.user.profile",
    "input": {
      "username": "instagram"
    }
  }
}

200 OKoutputapplication/json

{
  "user": {
    "id": "25025320",
    "username": "instagram",
    "name": "Instagram",
    "bio": "Discover what's new on Instagram 🔎✨",
    "bio_link": "http://help.instagram.com/",
    "image_url": "https://scontent-cdg4-2.cdninstagram.com/v/t51.82787-19/550891366_18667771684001321_1383210656577177067_n.jpg?stp=dst-jpg_s320x320_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-cdg4-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2gHCPdPzip48vz1dN4mR6jDiGAd7Isi8tCbACRX5C6eBu3N0TwgGsSOwPeJukOGso5w&_nc_ohc=wuiGsK4s3KsQ7kNvwE7_yQM&_nc_gid=0XHsmOGW6OGsxf4kuzk7tA&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AQS6SIdGlfmFxZp7RPpv_e_yOHNmCVbVCH-3ywEs5cDBEA&oe=6AE73467&_nc_sid=8b3546",
    "verified": true,
    "private": false,
    "follower_count": 686413019,
    "following_count": 159,
    "post_count": 8626
  }
}

The output of a real call, each list cut to 3 items.