User

Represents an Instagram user profile.

Instagram Legacy API User IDs are incompatible with the Instagram Basic Display API. If you are migrating to the Basic Display API and need to map a user's Basic Display ID to their corresponding Legacy ID, request the ig_id field on the User node. The ig_id field will return the user's Legacy ID until September 30th, 2020, when the field will be deprecated.

Creating

This operation is not supported.

Reading

GET /{user-id}

Get fields and edges on a User.

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/{user-id}
  ?fields={fields}
  &access_token={access-token}

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 User's ID.
`ig_id`	The User's Instagram Legacy API User ID. This field will be deprecated on September 30th, 2020.
`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/17841405793187218?fields=id,username&access_token=IGQVJ...'

Response

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

Updating

This operation is not supported.

Deleting

This operation is not supported.