Facebook
User - Instagram Platform - Documentation - Meta for Developers

User

Represents an Instagram user profile.

App-scoped user IDs (ASIDs) have been introduced with API version 11.0. You may continue querying users by their raw user IDs or their equivalent ASIDs, however, version 11.0+ calls will receive ASIDs in response.

ASIDs will replace raw user IDs in approximately two years, when version 10.0 is deprecated, so we recommend that you begin mapping your app users to their equivalent ASIDs.

Creating

This operation is not supported.

Reading

GET /{user-id}

Get fields and edges on a User.

Limitations

Instagram Legacy API User IDs are not supported.

Requirements

Type Requirement

Access Tokens

Instagram User

Permissions

instagram_graph_user_profile . The media_count field also requires instagram_graph_user_media .

Request Syntax

GET https://graph.instagram.com/{api-version}/{user-id}
  ?fields={fields}
  &access_token={access-token}

Path Parameters

Placeholder Value

{api-version} String

API version .

{user-id}
Required
String

App user's app-scoped user ID (version 11.0+) or raw user ID (all versions).

Query String Parameters

Include the following query string parameters to augment the request.

Key Value

access_token
Required
String

The app user's Instagram User Access Token .

fields Comma-separated list

A comma-separated list of fields and edges you want returned. If omitted, default fields will be returned.

Fields

You can use the fields query string parameter to request the following fields on a User.

Field Name Description

account_type

The User's account type. Can be BUSINESS , MEDIA_CREATOR , or PERSONAL .

id

The app user's app-scoped ID (version 11.0+) or raw user ID (version 10.0 and lower).

media_count

The number of Media on the User. This field requires the instagram_graph_user_media permission.

username

The User's username.

Edges

You can request the following edges as path parameters or by using the fields query string parameter.

Edge Description

media

Get a list of Media on the User.

Response

A JSON-formatted object containing default and requested fields and edges .

{
  "{field}":"{value}",
  ...
}

cURL Example

Request

curl -X GET \
  'https://graph.instagram.com/ v21.0 
/10218560180051171?fields=id,username&access_token=IGQVJ...'

Response

{
  "id": "17841405793187218",
  "username": "jayposiris"
}

Updating

This operation is not supported.

Deleting

This operation is not supported.

Build a Mobile Site
View Site in Mobile | Classic
Share by: