Media

This edge allow you to:

• create media object containers on a Business User
• get an Instagram Business User's media objects

Creating

Creating Media Object Containers

To create a media object container, send a POST request to the /user/media edge and include the following parameters:

• image_url — (required) The path to the photo.
• caption — (optional) A caption for the photo. Like the app, you can include hashtags (e.g., #crazywildebeest) and usernames of Instagram Users (e.g., @natgeo). @Mentioned Users will receive a notification when you publish the media object container.
• user_tags (optional) — An array of public usernames and x/y coordinates for any public Instagram Users who you want to tag in the photo. The array must be formatted in JSON and contain a username, x, and y, property, such as [{username:'natgeo',x:0.5,y:1.0}]. x and y values must be float numbers that originate from the top-left of the image, with a range of 0.0–1.0. Tagged users will receive a notification when you publish the media container.
• location_id (optional) — The ID of a Places Graph Place location you want to tag the photo with. Use the Places Search API to discover Place IDs.

If successful, this edge will respond with the newly created media object container's id. You can then use the id to publish the media object container. If you don't publish the media object container within 24 hours, it will expire.

Permissions

A User access token with the following permissions:

• instagram_basic
• instagram_content_publish

Sample Request

POST graph.facebook.com/17841400008460056/media
  ?image_url=https//www.example.com/images/bronzed-fonzes.jpg
  &caption=#BronzedFonzes!
  &user_tags=
    [
      {
        username:'kevinhart4real',
        x: 0.5,
        y: 0.8
      },
      {
        username:'therock',
        x: 0.3,
        y: 0.2
      }
    ]

Sample Response

{
  "id": "17889455560051444"
}

Reading

Getting Media Objects

To get all media objects on an Instagram Business User, send a GET request to the User's /media edge.

Permissions

A User access token with the following permissions:

• instagram_basic

Limitations

This edge will return a maximum of 10K of the most recently created media objects.

Sample Request

GET graph.facebook.com/17841405822304914/media

Sample Response

{
  "data": [
    {
      "id": "17895695668004550"
    },
    {
      "id": "17899305451014820"
    },
    {
      "id": "17896450804038745"
    },
    {
      "id": "17881042411086627"
    },
    {
      "id": "17869102915168123"
    }
  ]
}

Updating

This operation is not supported.

Deleting

This operation is not supported.