REST API
Multiple Users
GUI Dashboard
Packages & Guides
Instagram
Options for posting via the API to Instagram
Instagram API Endpoint
Overview
Post images or videos directly to Instagram.
Instagram has the following requirements and restrictions:
- Only 25 Instagram posts are allowed over a 24 hour period - around 750 posts a month. See below for
usedQuota - The
posttext may contain up to 30 hashtags (e.g. #wildtimes) and 3 username mentions (e.g. @natgeo). - @mention Instagram users will receive a notification.
- Maximum 2,200 post characters.
- Multi-image posts are supported via a carousel. Multiple videos are not supported.
- Delete not supported using the /delete endpoint.
Note: The aspect ratio of images & videos and the duration of video are very important to successfully post to Instagram. If they do not meet the requirements, the post will be rejected.
Please see the Instagram section of Image and Video Guidelines:
JSON for a basic post with an image and hashtags to Instagram:
1
{
2
"post": "The best IG ever #best #aweome https://www.instagram.com",
3
"mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
4
"platforms": ["instagram"]
5
}
Copied!
Hashtags are clickable in Instagram posts, but links are not.
Instagram Business Account
Your Instagram account must be a Business Account and connected with a Facebook Page. The setup is free and easy.
See here for detailed instructions:
Carousel of Images
You can post multiple images to Instagram as a carousel; up to 10 images may be use in a carousel. Just add your additional images to the
mediaUrls array and the carousel will automatically be created. Videos are not supported in carousel.1
"mediaUrls": ["https://url1.com", "https://url2.com" ...]; // Max 10 images
Copied!
User Tags & Locations
The Instagram user will be notified when you use their username in a post. Please be cautious to not spam users or post with their username repeatedly. If you do, Instagram will suspend or deactivate your account.
An image can be tagged with Instagram users and images/videos can be tagged with a location, for a given Facebook Page Id, using the
instagramOptions parameter.Location
A location is specified by a
locationId, which is a Facebook Page ID or Facebook Page name. For example, Facebook page Id of the Guggenheim Museum is "7640348500" or Facebook page name "@guggenheimmuseum". Pages must be associated with a physical location.1
// Using the Facebook Page Id - must be associated with a location
2
{
3
"instagramOptions": {
4
"locationId": "7640348500" // Guggenheim Museum Page Id
5
}
6
}
7
​
8
// Using the Facebook Page name - must be associated with a location
9
{
10
"instagramOptions": {
11
"locationId": "@guggenheimmuseum" // Guggenheim Museum Page name. Must begin with @
12
}
13
}
Copied!
User Tags
Users are specified by a
userTags containing an Array of objects with an Instagram username and x/y coordinates on the image. Only available for images. - Usernames must be public Instagram accounts.
xandyvalues must befloatnumbers that originate from the top-left of the image, with a range of0.0–1.0.
1
{
2
"instagramOptions": {
3
"userTags": {
4
"username": "ayrshare", // Instagram username
5
"x": 0.5, // Float value, originates from the top-left of the image
6
"y": 1.0 // Float value, originates from the top-left of the image
7
}
8
}
9
}
Copied!
Auto Image Resize
Enterprise Plans required.
Images are automatically resized to 1080 x 1080 px to work with Instagram with the autoResize parameter. Please note, this will resize the image for all included platforms, so we recommend making one call for Instagram and a different /post call for additional platforms.
1
{
2
"post": "Let it go!",
3
"platforms": [
4
"instagram"
5
],
6
"mediaUrls": [
7
"https://images.ayrshare.com/imgs/GhostBusters.jpg"
8
],
9
"instagramOptions": {
10
"autoResize": true, // Enterprise Plans only
11
"locationId": 7640348500,
12
"userTags": [
13
{
14
"username": "ayrshare",
15
"x": 0.5,
16
"y": 0.5
17
},
18
{
19
"username": "ayrshare",
20
"x": 0.3,
21
"y": 0.2
22
}
23
]
24
}
25
}
Copied!
Used Quota
The Instagram response will include the current
usedQuota for the number of Instagram posts done over a rolling 24-hours period. Only 25 Instagram posts are permitted by Instagram in a 24-rolling-hour period.1
{
2
"status": "success",
3
"errors": [],
4
"postIds": [
5
{
6
"status": "success",
7
"id": "17823977408036085",
8
"postUrl": "https://www.instagram.com/p/CeBrkQuN1Kv/",
9
"usedQuota": 15,
10
"platform": "instagram"
11
}
12
],
13
"id": "l4FaPHSXWJNdmMfm3dIE"
14
"refId": "65806e8d9efd78a58c05566a887043329dcdc76b",
15
"post": "Luckily for Alice, the little magic bottle had now had its full effect."
16
}
Copied!
If the quota has been reached, an error message will be returned.
Last modified 18d ago