Options for posting using the Instagram API
usedQuota
post
text may contain up to 30 hashtags (e.g. #wildtimes) and 3 username mentions
(e.g. @natgeo).isVideo
parameter. See the /post endpoint for details.post: ""
.mediaUrls
array, and the carousel will automatically be created.
mp4
. The isVideo
parameter is not supported
for Instagram carousels.instagramOptions
options.
shareReelsFeed
: Boolean set to true
to indicate that the Reel can appear in both the
Feed and Reels tabs or false
to indicate the Reel can only appear in the Reels
tab. This value is a hint to Instagram where you would like the Reel to appear, but neither
value determines whether the Reel actually appears in the Reels or Feed tab because
the Reel may not meet eligibility requirements or may not be selected by Instagram’s algorithm.audioName
: String name of the audio music of your Reels media. You can only rename once, either
while creating a reel or after from the audio page. For example, "The Weeknd - Blinding Lights"
.thumbNail
: String URL of the Reel cover image (thumbnail). Please see here for details on
thumbNail.thumbNailOffset
: Integer offset in milliseconds of the thumbnail frame. Please see here for
details on thumbNailOffset.instagramOptions
. Instagram stories disappear after 24 hours.
post
field, including
mentions, will be ignored.0
, which is the first frame of the Reel.
If you specify both a thumbnail URL and a thumbnail offset, the thumbnail offset will be ignored.
The Reel thumbnail must follow the Reels thumbnail requirements.
Signed URLs with redirects are not guaranteed to be compatible with cover URLs.
We recommend a non-signed URL or use the /media endpoint.
altText
in the instagramOptions
object.
mediaUrls
array.
The alt text will be applied to each image in order.
instagramOptions
parameter.
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.
locationId
(Page Id) with the brand endpoint. Please note that the Page must have a location listed or the locationId will return an error.
userTags
containing an Array of objects with an Instagram username and x/y coordinates (image only). User tags can be added for single images or Reels, but not regular videos, multiple images, or Stories.
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
. Single images. Do not include with Reels or an error will occur.@mentioned
user will be notified of the mention. Please review the important
rules on mentions.accept
your invite.declined
collaboration request, do not re-invite them until you contact them to
understand the reason for the decline.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.
usedQuota
for the number of Instagram posts done over a rolling 24 hours period. Only 50 Instagram posts are permitted by Instagram in a 24-rolling-hour period.