This edge allow you to:
This operation is only available to partners in the Content Publishing API beta program.
You can create media containers for photos that meet the following specifications:
To create a media container for a photo, send a POST
request to the /user/media
edge and include the following parameters:
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 Places Graph Place location you want to tag the photo with. Use the Places Search API to discover Place IDs. |
| 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.
A User access token with the following permissions:
instagram_basic
instagram_content_publish
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" }
This operation is only available to partners in the Content Publishing API beta program.
You can create media containers for videos that meet the following specifications:
To create a media container for a video, send a POST
request to the /user/media
edge and include the following parameters:
Parameter | Description |
---|---|
| A caption for the video. Like the app, you can include hashtags (e.g., |
| The ID of a Places Graph Place location you want to tag the photo with. Use the Places Search API to discover Place IDs. |
| Set value to |
| Location, in milliseconds, of the video frame to be used as the video's cover thumbnail image. Default value is 0, which is the first frame of the video. |
| 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 User access token with the following permissions:
instagram_basic
instagram_content_publish
POST graph.facebook.com/17841400008460056/media ?media_type=VIDEO &video_url=https//www.example.com/videos/hungry-fonzes.mov &caption=#Heyyyyyyyy!
{ "id": "17889455560051444" }
To get all media objects on an Instagram Business User, send a GET
request to the User's /media
edge.
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.
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.