Graph API Version

IGUser Media

Reading

ShadowIGUserMedia

Example

Graph API Explorer
GET /v21.0/{ig-user-id}/media HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{ig-user-id}/media',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/{ig-user-id}/media",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{ig-user-id}/media",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{ig-user-id}/media"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
If you want to learn how to use the Graph API, read our Using Graph API guide.

Parameters

This endpoint doesn't have any parameters.

Fields

Reading from this edge will return a JSON formatted result:

{ "data": [], "paging": {} }

data

A list of ShadowIGMedia nodes.

paging

For more details about pagination, see the Graph API guide.

Error Codes

ErrorDescription
190Invalid OAuth 2.0 Access Token
100Invalid parameter
200Permissions error
80002There have been too many calls to this Instagram account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting.
9005Video content was not found.
2500Error parsing graph query

Creating

You can make a POST request to media edge from the following paths:
When posting to this edge, an IGUser will be created.

Parameters

ParameterDescription
caption
string
Default value: ""

Caption for the media to be created

collaborators
array<string>

Field that adds collaborators to a media

image_url
string

A URL where the image to be uploaded

is_carousel_item
boolean

is_carousel_item

location_id
numeric string

Location id tagged in media

media_type
string
Default value: "IMAGE"

media_type

product_tags
array<JSON object>

IG Shopping products tagged in media

share_to_feed
boolean

share_to_feed

thumb_offset
string

A numberic string for thumbnail offset in video stream to generate thumbmail

user_tags
array<JSON object>

IG users tagged in media

username
string

username

Required
x
float

x

y
float

y

Return Type

This endpoint supports read-after-write and will read the node represented by id in the return type.
Struct {
id: numeric string,
uri: string,
}

Error Codes

ErrorDescription
80002There have been too many calls to this Instagram account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting.
100Invalid parameter
9004Only photo or video can be accepted as media type.
36003The aspect ratio is not supported.
110Invalid user id
36001The image format is not supported.
190Invalid OAuth 2.0 Access Token
210User not visible
36004The caption was too long.
200Permissions error

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.