Instagram Platform API account IDs will not work with the new Instagram Graph API. Please use the Page node to determine the correct Instagram Business User ID associated with the Facebook page.

Creating

Creating Media Object Containers

This operation is only available to partners in the Content Publishing API beta program.

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.01.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

If the token is for a User whose Page role was granted via the Business Manager, one of the following permissions is also required:

  • ads_management
  • manage_pages
  • business_management

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.