IG User Media

Represents a collection of IG Media objects on an IG User.

Creating

POST /{ig-user-id}/media

Create an image, video, carousel or reel IG Container for use in the post publishing process. See the Content Publishing guide for complete publishing steps.

Limitations

General Limitations

• Containers expire after 24 hours.
• If the Page connected to the targeted Instagram Business account requires Page Publishing Authorization (PPA), PPA must be completed or the request will fail.
• If the Page connected to the targeted Instagram Business account requires two-factor authentication, the Facebook User must also have performed two-factor authentication or the request will fail.
• Publishing to Instagram TV is not supported.
• Publishing to Instagram Stories is not supported.

Reels Limitations

• Reels cannot appear in album carousels.
• Account privacy settings are respected upon publish. For example, if Allow remixing is enabled, published reels will have remixing enabled upon publish but remixing can be disabled on published reels manually through the Instagram app.
• Audio naming is not supported. All reels will be published with Original audio.
• Cover images are not supported, use thumb_offset instead.

Requirements

Image Specifications

• Format: JPEG
• File size: 8 MB maximum.
• Aspect ratio: Must be within a 4:5 to 1.91:1 range
• Minimum width: 320 (will be scaled up to the minimum if necessary)
• Maximum width: 1440 (will be scaled down to the maximum if necessary)
• Height: Varies, depending on width and aspect ratio
• Color Space: sRGB. Images using other color spaces will have their color spaces converted to sRGB.

Video Specifications

• Container: MOV or MP4 (MPEG-4 Part 14), no edit lists, moov atom at the front of the file.
• Audio codec: AAC, 48khz sample rate maximum, 1 or 2 channels (mono or stereo).
• Video codec: HEVC or H264, progressive scan, closed GOP, 4:2:0 chroma subsampling.
• Frame rate: 23-60 FPS.
• Picture size:

  • Maximum columns (horizontal pixels): 1920
  • Minimum aspect ratio [cols / rows]: 4 / 5
  • Maximum aspect ratio [cols / rows]: 16 / 9
• Video bitrate: VBR, 5Mbps maximum
• Audio bitrate: 128kbps
• Duration: 60 seconds maximum, 3 seconds minimum
• File size: 100MB maximum

Reel Specifications

• Container: MOV or MP4 (MPEG-4 Part 14), no edit lists, moov atom at the front of the file.
• Audio codec: AAC, 48khz sample rate maximum, 1 or 2 channels (mono or stereo).
• Video codec: HEVC or H264, progressive scan, closed GOP, 4:2:0 chroma subsampling.
• Frame rate: 23-60 FPS.
• Picture size:

  • Maximum columns (horizontal pixels): 1920
  • Required aspect ratio is between 0.01:1 and 10:1 but we recommend 9:16 to avoid cropping or blank spaces.
• Video bitrate: VBR, 5Mbps maximum
• Audio bitrate: 128kbps
• Duration: 15 mins maximum, 3 seconds minimum
• File size: 100MB maximum

Reels Tab Eligibility

Although you can publish reels with longer durations and different aspect ratios, only reels with durations between 5 and 90 seconds and aspect ratios of 9:16 are eligible to appear in the Reels tab.

Request Syntax

Image Containers

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?image_url={image-url}
  &is_carousel_item={is-carousel-item}
  &caption={caption}
  &location_id={location-id}
  &user_tags={user-tags}
  &product_tags={product-tags}
  &access_token={access-token}

Video Containers

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?media_type=VIDEO
  &video_url={video-url}
  &is_carousel_item={is-carousel-item}
  &caption={caption}
  &location_id={location-id}
  &thumb_offset={thumb-offset}
  &product_tags={product-tags}
  &access_token={access-token}

Reel Containers

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
?media_type=REELS
&video_url={reel-url}
&caption={caption}
&location_id={location-id}
&thumb_offset={thumb-offset}
&share_to_feed={share-to-feed}
&access_token={access-token}

Carousel Containers

Carousel containers only. To create carousel item containers, create image or video containers instead (reels are not supported). See Carousel Posts for complete publishing steps.

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
?media_type={media-type}
&caption={caption}
&location_id={location-id}
&product_tags={product-tags}
&children={children}
&access_token={access-token}

Path Parameters

Query String Parameters

Response

A JSON-formatted object containing an IG Container ID which you can use to publish the container.

Video uploads are asynchronous, so receiving a container ID does not guarantee that the upload was successful. To verify that a video has been uploaded, request the status_code field on the IG Container. If its value is FINISHED, the video was uploaded successfully.

{
  "id":"{ig-container-id}"
}

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

GET /{ig-user-id}/media

Get all IG Media on an IG User.

Limitations

• Returns a maximum of 10K of the most recently created media.
• Story IG Media not supported, use the GET /{ig-user-id}/stories endpoint instead.

Requirements

Time-based Pagination

This endpoint supports time-based pagination. Include since and until query-string paramaters with Unix timestamp or strtotime data values to define a time range.

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.