Represents a collection of IG Media objects on an IG User.
This edge allow you to:
POST /{ig-user-id}/media?image_url={image-url}&caption={caption}&location_id={location-id}&user_tags={user-tags}
Creates a media container for a photo IG Media object. This endpoint is only available to partners in the Content Publishing API beta program.
Photos must meet the following specifications:
Query string parameters are optional unless indicated as required.
| 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. Locations are represented by PlaceInformation objects. Use the Places Graph API to get PlaceInformation objects and 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_basicinstagram_content_publishmanage_pagesIf 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}&caption={caption}&location_id={location_id}&thumb_offset={thumb_offset}
Creates a media container for a video IG Media object. This endpoint is only available to partners in the Content Publishing API beta program.
Videos must meet the following specifications:
Query string parameters are optional unless indicated as required.
| Parameter | Description |
|---|---|
| A 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. Locations are represented by PlaceInformation objects. Use the Places Graph API to get PlaceInformation objects and include the |
| Location, in milliseconds, of the video frame to be used as the video's cover thumbnail image. Default value is |
| The 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_basicinstagram_content_publishmanage_pagesPOST graph.facebook.com/17841400008460056/media ?media_type=VIDEO &video_url=https//www.example.com/videos/hungry-fonzes.mov &caption=#Heyyyyyyyy!
{
"id": "17889455560051444"
}GET /{ig-user-id}/media
Gets all IG Media objects on an IG User.
This edge will return a maximum of 10K of the most recently created media objects.
A Facebook User access token with the following permissions:
instagram_basicmanage_pages or pages_show_listIf the token is from a User whose Page role was granted via the Business Manager, one of the following permissions is also required:
ads_managementmanage_pagesbusiness_managementGET 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.