My Docs
My BlogPython Data StructuresRepoFamily-Promise-Docs
Search…
Web-Dev-Hub-Docs
Home
Navigation
Tools
Tools
Showcase
Downloads
How To Configure Ubuntu
REPL.IT Compilations
Past Notes
Git
JavaScript
Programming Languages
Programming Languages
What is a Programming Language?
Python
Python
Install PIP
JavaScript
JavaScript
JS-Leetcode
Web Development Frameworks & Libraries
GRAPHQL
React
Jquery
GATSBY
Productivity
Productivity
Misc
Misc
GitGateway
Links
Bookmarks
Websites
Websites
Not My Websites:
Backend
Backend
Networking
Networks
Resources
Resources
Video Resources
General Knowledge
General Knowledge
Knowledge Bank
Finance
Finance
Finance Reference
Financial Trends
Science & Tech (Innovation)
Science & Tech
Articles
Reading
Reading
Social Media & Trends
Trends In Web Dev
FB-Dev-Open Source
Content Publishing
IG-API
Docs
Docs
Code Editors & Tools
Vscode
Cool Stuff
Cool Observable Notebooks
Server-Side
GraphQL
Rest VS GraphQl
REST-API
Public APIs
WEB_DEV_TOOLS
Web Dev Tools
Cloudinary
Postman
Netlify
DS_ALGOS_BRAINTEASERS
A Quick Guide to Big-O Notation, Memoization, Tabulation, and Sorting Algorithms by Example
Free-Stuff
Free Stuff
Job-Search
Job Search
Outreach
General Comp Sci
Principles behind the Agile Manifesto
Blockchain & Crypto
Blockchain Basics
Data Structures & Interviewing
Data Structures
REACT_REVISITED
Modern React with Redux
WEBDEV-Bootcamp-Notes
Lambda
Group 1
Testing:
Medium-articles
My Articles
Powered By GitBook
FB-Dev-Open Source

Content Publishing

You can use the Instagram Graph API to publish IG Media objects on Instagram Business IG Users. Publishing media objects is a two step process — first create a media object container, then use the container to publish the media.

Limitations

  • Can only be used to publish to business IG User accounts; Creator IG User accounts are not supported.
  • Accounts are limited to 25 API-published posts within a 24 hour period.
  • JPEG is the only image format supported. Extended JPEG formats such as MPO and JPS are not supported.
  • Stories are not supported.
  • Shopping tags are not supported.
  • Branded content tags are not supported.
  • Filters are not supported.
  • Multi-image posts are not supported.
  • If the caption contains a hashtag, it should be HTML URL-encoded as %23 in the request.
  • Publishing to IGTV is not supported.
For additional limitations, please refer to the IG User Media endpoint reference.

Requirements

Access Tokens

All requests must include the app user's User access token.

Permissions

Publishing relies on a combination of the following permissions. The exact combination depends on which endpoints your app will be using. Refer to our endpoint references to determine which permissions they require.
If your app will be used by app users who do not have a role on your app or a role in a Business that claimed your app, you must request approval for each permission via App Review before non-role app users can grant them to your app.

Public Server

We will cURL your media object using the passed in URL so the object must be on a public server.

Page Publishing Authorization

Instagram Business accounts connected to a Page that requires Page Publishing Authorization (PPA) cannot be published to until PPA has been completed.
It's possible that an app user may be able to perform Tasks on a Page that initially does not require PPA but later requires it. In this scenario, the app user would not be able to publish content to their Instagram Business account until completing PPA. Since there's no way for you to determine if an app user's Page requires PPA, we recommend that you advise app users to preemptively complete PPA.

Rate Limit

Instagram accounts are limited to 25 API-published posts within a 24 hour moving period. This limit is enforced on the IG User Media Publish endpoint when attempting to publish a media container. We recommend that your app also enforce the publishing rate limit, especially if your app allows app users to schedule posts to be published in the future.
To check an IG Business acccount's current rate limit usage, query the IG User Content Publishing Limit endpoint.

Endpoints

The API consists of the following endpoints. Refer to each endpoint's reference document for usage requirements.

Examples

Publishing Photos

Publishing photos is a two-step process:
  1. 1.
    Use the POST /{ig-user-id}/media endpoint to upload a photo and create an IG Container.
  2. 2.
    Use the POST /{ig-user-id}/media_publish endpoint to publish the photo using its container.
For example, let's say you have a photo at...
1
https://www.example.com/images/bronz-fonz.jpg
Copied!
... that you want to publish with the hashtag "#BronzFonz" as its caption. You could use the POST /{ig-user-id}/media endpoint to create the container like this, using HTML URL-encoding for the hashtag (#) character in the caption.
Sample Request
1
POST graph.facebook.com/17841400008460056/media
2
?image_url=https//www.example.com/images/bronz-fonz.jpg
3
&caption=%23BronzFonz
Copied!
This would return a container ID (let's say 17889455560051444), which you would then publish using the POST /{ig-user-id}/media_publish endpoint, like this:
Sample Request
1
POST graph.facebook.com/17841405822304914/media_publish
2
?creation_id=17889455560051444
Copied!

Publishing Photos w/ Tagged Users

You can tag public Instagram users in a photo and they will receive a notification when it is published.
To do this, follow the Publishing Photos steps above, but when creating the media container, include the user_tags parameter and an array of objects indicating the Instagram users in the photo as well as their x/y coordinates within the photo itself.
For example, let's say you want to publish a photo that depicts two of your Instagram friends who you want to tag. You could use the POST /{ig-user-id}/media endpoint to create the container like this:
Sample Request
1
POST graph.facebook.com/17841400008460056/media
2
?image_url=https://www.example.com/images/bronzed-fonzes.jpg
3
&caption=%23BronzedFonzes!
4
&user_tags=
5
[
6
{
7
username:'kevinhart4real',
8
x: 0.5,
9
y: 0.8
10
},
11
{
12
username:'therock',
13
x: 0.3,
14
y: 0.2
15
}
16
]
Copied!
This would return a container ID which you would then use with the POST /{ig-user-id}/media_publish endpoint to publish the photo.
Notes
  • The user_tags value must be an array of objects formatted with JSON.
  • You can only tag users with public Instagram accounts.
  • The object must contain all three properties (username, x, and y) for each user.
  • x and y values must be float numbers that originate from the top-left of the image, with a range of 0.0–1.0.
  • The hashtag character (#) is HTML URL-encoded in the request (%23).

Publishing Photos w/ Locations

You can 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. If you include a Page's ID when publishing a photo, the photo will be tagged with the location associated with that Page.
For example:
1
GET https://graph.facebook.com/pages/search
2
?q=guggenheim
3
&fields=name,location,link
4
&access_token={access-token}
Copied!
This would return an array of Pages with "guggenheim" in their name, one of which is for the Guggenheim in New York City:
1
...
2
{
3
"name": "Solomon R. Guggenheim Museum",
4
"location": {
5
"city": "New York",
6
"country": "United States",
7
"latitude": 40.782910059774,
8
"longitude": -73.959075808525,
9
"state": "NY",
10
"street": "1071 5th Ave",
11
"zip": "10128"
12
},
13
"link": "https://www.facebook.com/7640348500",
14
"id": "7640348500" // This is the page ID, which you can use for location tagging
15
}
16
...
Copied!
Be sure to include the location field in your query and verify that the Page you want to use has location data that include latitude and longitude. Attempting to create a container using a Page that has no location data will fail with coded exception INSTAGRAM_PLATFORM_API__INVALID_LOCATION_ID.
Once you have the Page ID, follow the Publishing Photos steps above and use the location_id parameter to pass us the Page ID when creating your media object container.
To be eligible for tagging, a Page must have latitude and longitude location data.
Sample Request
1
POST graph.facebook.com/17841400008460056/media
2
?image_url=https://www.example.com/images/gugges.jpg
3
&caption=Exhibiting!
4
&location_id=7640348500
Copied!
This would return a container ID which you would then use with the POST /{ig-user-id}/media_publish endpoint to publish the photo.

Publishing Videos

Publishing videos is a two-step process:
  1. 1.
    Use the POST /{ig-user-id}/media endpoint to create an IG Container.
  2. 2.
    Use the POST /{ig-user-id}/media_publish endpoint to publish the video using its container.
For example, let's say you have a video at...
1
https://www.example.com/videos/hungry-fonzes.mov
Copied!
... that you want to publish with the hashtag "#Heyyyyyyyy!" as its caption. You could use the POST /{ig-user-id}/media edge, applying HTML URL-encoding to the hashtag character in the caption to create the container like this:
Sample Request
1
POST graph.facebook.com/17841400008460056/media
2
?media_type=VIDEO
3
&video_url=https//www.example.com/videos/hungry-fonzes.mov
4
&caption=%23Heyyyyyyyy!
Copied!
This would return a container ID (let's say 17889455560051447), which you would then use with the POST /{ig-user-id}/media_publish endpoint to publish the video, like this:
Sample Request
1
POST graph.facebook.com/17841405822304914/media_publish
2
?creation_id=17889455560051447
Copied!

Checking Rate Limit Usage

Instagram accounts are limited to 25 API-published posts within a 24 hour moving period. You can query the IG User Content Publishing Limit endpoint to check your app user's current rate limit usage.
Sample Request
1
GET graph.facebook.com/17841400008460056/content_publishing_limit
Copied!
Sample Response
1
{
2
"data": [
3
{
4
"quota_usage": 2
5
}
6
]
7
}
Copied!

Troubleshooting

If you are able to create a container for a video but the POST /{ig-user-id}/media_publish endpoint does not return the published media ID, you can get the container's publishing status by querying the GET /{ig-container-id}?fields=status_code endpoint. This endpoint will return one of the following:
  • EXPIRED — The container was not published within 24 hours and has expired.
  • ERROR — The container failed to complete the publishing process.
  • FINISHED — The container and its media object are ready to be published.
  • IN_PROGRESS — The container is still in the publishing process.
  • PUBLISHED — The container's media object has been published.
We recommend querying a container's status once per minute, for no more than 5 minutes.

Errors

See the Error Codes reference.
Social Media & Trends - Previous
Trends In Web Dev
Next
Content Publishing
Last modified 14d ago
Copy link
Contents
Content Publishing
Limitations
Requirements
Rate Limit
Endpoints
Examples
Troubleshooting
Errors