POST /{ig-user-id}/media?image_url={image-url}
Creates a media container for a photo IG Media object.
Photo Requirements
Page Requirements
If the Page connected to the targeted Instagram Business account requires Page Publishing Authorization (PPA), PPA must be completed or the request will fail.
Color Space
The API supports the sRGB color space. Images that use other color spaces will have their color spaces converted to sRGB.
Parameter | Description |
---|---|
| A caption for the photo. Like the app, you can include hashtags (e.g., |
| The path to the photo. We will cURL your photo using the passed in URL so it must be on a public server. |
| The ID of a Page associated with a location that you want to tag the photo with. Use the Pages Search API to search for Pages whose names match a search string, then parse the results to identify any Pages that have been created for a physical location. Include the |
| An array of public usernames and |
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.
An access token of a Facebook User who is able to perform MANAGE
or CREATE_CONTENT
tasks on the Page connected to the Instagram User account, with the following permissions:
instagram_basic
instagram_content_publish
pages_read_engagement
OR pages_show_list
If the Page connected to the Instagram User has enabled two-factor authentication, the Facebook User must also have performed two-factor authentication or the request will fail.
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 } ]
{ "id": "17889455560051444" }
POST /{ig-user-id}/media?media_type=video&video_url={video_url}
Creates a media container for a video IG Media object.
Videos must meet the following specifications:
Parameter | Description |
---|---|
| Caption for the video. Like the app, you can include hashtags (e.g., |
| The ID of a Page associated with a location that you want to tag the video with. Use the Pages Search API to search for Pages whose names match a search string, then parse the results to identify any Pages that have been created for a physical location. Include the |
| Location, in milliseconds, of the video frame to be used as the video's cover thumbnail image. Default value is |
| Path to the video. We will cURL your video using the passed in URL so it must be on a public server. |
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.
A Facebook User access token with the following permissions:
instagram_basic
instagram_content_publish
pages_read_engagement
OR pages_show_list
POST graph.facebook.com/17841400008460056/media ?media_type=VIDEO &video_url=https//www.example.com/videos/hungry-fonzes.mov &caption=#Heyyyyyyyy!
{ "id": "17889455560051444" }
See Errors.
GET /{ig-user-id}/media
Gets all IG Media objects on an IG User.
A Facebook User access token with the following permissions:
instagram_basic
pages_read_engagement
pages_show_list
If the token is from a User whose Page role was granted via the Business Manager, one of the following permissions is also required:
ads_management
pages_read_engagement
business_management
GET graph.facebook.com/17841405822304914/media
{ "data": [ { "id": "17895695668004550" }, { "id": "17899305451014820" }, { "id": "17896450804038745" }, { "id": "17881042411086627" }, { "id": "17869102915168123" } ] }
This operation is not supported.
This operation is not supported.