Instagram for Business
The Instagram for Business modules enables you to monitor comments and media, retrieve insights, media, and stories, as well as create comments or replies in your Instagram for Business account.
Getting Started With Instagram for Business
Prerequisites
- A Facebook account that can perform admin-equivalent tasks on a Facebook Page that has been connected to the Instagram account you want to access.
- An Instagram for Business account — You can create an Instagram account on instagram.com, and then switch the profile to a Business account. Please refer to the Set Up a Business Account on Instagram guide.
The module dialog fields that are displayed in bold (in the Boost.space Integrator scenario, not in this documentation article) are mandatory!
Connecting Instagram for Business to Boost.space Integrator
Ensure that you create a connection with the same profile you are logged into on Facebook and Instagram. If you are making a connection with another account, it won’t work for you and you need to add another administrator to your application – follow our step-by-step guide. You also need to add a test user to Your Instagram app – follow our step-by-step guide.
Insights
Get User Insights
Returns insights on an Instagram user.
Insights data is unavailable to Instagram users with fewer than 100 followers.
Connection
Establish a connection to your Instagram for Business account.
Page
Select the page or enter (map) the ID of the page you want to retrieve insights for.
Metric
Select the user metric you want to retrieve. If you want to select multiple metrics they must have the same compatible period.
Period
Select the period compatible with the metrics you have selected.
Date since
Enter the starting date to retrieve the user insights.
Date to
Enter an end date to retrieve the user insights.
Get Media Insights
Returns insights on Instagram media.
Connection
Establish a connection to your Instagram for Business account.
Media ID
Enter (map) the media ID, for example, from the Watch Media module if you want to retrieve insights.
Metrics
Select the metrics you want to retrieve for the specified media.
Please see the list of metrics that can be returned for corresponding media.
Media
Watch Media
Returns media details when new media is added.
Connection
Establish a connection to your Instagram for Business account.
Page
Select the page you want to watch for new media.
Limit
Set the maximum number of media Boost.space Integrator will return during one execution cycle. The default value is 10.
Watch Public User Media
Triggers when a new media is added to the selected Instagram Business or Creator IG User.
Connection
Establish a connection to your Instagram for Business account.
Page
Select the page whose user media you want to watch.
Username
Enter the username whose media you want to watch.
Limit
Set the maximum number of media Boost.space Integrator will return during one execution cycle.
Create a Photo Post
Posts a photo to the specified Instagram page.
If you manage a Page with a large audience, you may be asked to confirm your identity and secure your account through a Page Publishing Authorization process.
Connection
Establish a connection to your Instagram for Business account.
Page
Select the page where you want to post a photo.
Photo URL
Enter the URL of the photo. The URL must be publicly accessible.
Photo Requirements
- Maximum file size: 8MB
- Aspect ratio: Must be within a 4:5 to 1.91:1 range
- Minimum width: 320 (will be scaled up to the minimum if necessary)
- Maximum width: 1440 (will be scaled down to the maximum if necessary)
- Height: Varies, depending on width and aspect ratio
- Formats: JPEG
Please note that your image must be hosted on a publicly accessible URL and you cannot host your images on Google Drive even if the file is shared publicly because Instagram API is not able to download files from Google Drive. The same applies to Dropbox URLs.
Caption
Enter a caption for the photo. Like in the app, you can include hashtags (e.g., #crazywildebeest) and usernames of Instagram users (e.g., @natgeo). @Mentioned Instagram users will receive a notification when you publish the media object container.
Maximum 2200 characters, 30 hashtags, and 20 @ tags.
User Tags
Enter the user tags.
Username
Enter the username who has a public Instagram account.
The username should not start with @, it must match the pattern, /^(?!@)/.
X position
Enter a float indicating the percentage distance from the left edge of the published media image lower than or equal to 1. This is an optional field.
Y position
Enter a float indicating the percentage distance from the right edge of the published media image lower than or equal to 1. This is an optional field.
Location ID
Enter the Page ID created for a physical location.
Create a Video Post
Posts a video to the specified Instagram page.
If you manage a Page with a large audience, you may be asked to confirm your identity and secure your account through a Page Publishing Authorization process.
Connection
Establish a connection to your Instagram for Business account.
Page
Select the page where you want to post a video.
Video URL
Enter the URL of the video. The URL must be publicly accessible.
Video Requirements
-
Container: MOV or MP4 (MPEG-4 Part 14), no edit lists, Moov atom at the front of the file.
-
Audio codec: AAC, 48kHz sample rate maximum, 1 or 2 channels (mono or stereo).
-
Video codec: HEVC or H264, progressive scan, closed GOP, 4:2:0 chroma subsampling.
-
Frame rate: 23-60 FPS.
-
Picture size:
- Maximum columns (horizontal pixels): 1920
- Minimum aspect ratio [cols / rows]: 4 / 5
- Maximum aspect ratio [cols / rows]: 16 / 9
-
Video bitrate: VBR, 5Mbps maximum
-
Audio bitrate: 128kbps
-
Duration: 60 seconds maximum, 3 seconds minimum
-
File size: 100MB maximum
Please note that your video must be hosted on a publicly accessible URL, and you cannot host your videos on Google Drive even if the file is shared publicly because Instagram API cannot download files from Google Drive. The same applies to Dropbox URLs.
Caption
Enter a caption for the video. Like in the app, you can include hashtags (e.g., #crazywildebeest) and usernames of Instagram users (e.g., @natgeo). @Mentioned users will receive a notification when you publish the media object container.
Maximum 2200 characters, 30 hashtags, and 20 @ tags.
Location ID
Enter the Page ID created for a physical location.
Create a Reel Post
Uploads and posts a new reel.
Connection
Establish a connection to your Instagram for Business account.
Page
Select or map a page whose carousel post you want to create.
Instagram Business accounts connected to a Page that requires Page Publishing Authorization (PPA) cannot be published until PPA has been completed.
Video URL
Enter the URL address of the photo. There are certain requirements for the video to be uploaded:
You should host the video on a publicly accessible URL. Do not host the video on Google Drive even if the file is shared publicly, as Instagram API cannot download those files. The same applies to Dropbox URLs.
Container
The video should be MOV or MP4 (MPEG-4 Part 14), with no edit lists and a moov atom at the front of the file.
Audio codec
The audio code should be AAC, 48khz sample rate maximum, 1 or 2 channels (mono or stereo).
Video codec
The video codec should be HEVC or H264, progressive scan, closed GOP, 4:2:0 chroma subsampling.
Frame rate
The frame rate must be 23 – 60 FPS.
Picture size
The Maximum columns (horizontal pixels) are 1920. The required aspect ratio is between 0.01:1 and 10:1. The recommended 9:16 is to avoid cropping or blank spaces.
Video bitrate
The video bitrate (VBR) must be a maximum of 5Mbps.
Audio bitrate
The audio bitrate can be 128kpbs.
Duration
The video duration should be a maximum of 15 mins and a minimum of 3 seconds.
File Size
The video file size is a maximum of 1GB.
Caption
Enter a caption for the photo. You can also include hashtags (#crazywildbeest ) and usernames of Instagram users (@natgeo). The caption can be maximum of 2200 characters, 30 hashtags, and 20 @ tags.
Location ID
Enter the Page ID created for a physical location.
Share to Feed
Select whether to share the reel as a feed.
Create a Carousel Post
Uploads a carousel photos/videos. as a new post.
Connection
Establish a connection to your Instagram for Business account.
Page
Select or map a page whose carousel post you want to create.
Instagram Business accounts connected to a Page that requires Page Publishing Authorization (PPA) cannot be published until PPA has been completed.
Files
Enter the details of details:
Media Type
Select the media type:
- Image
- Video
Photo URL
Enter the URL address of the photo. There are certain requirements for the photo to be uploaded:
You should host the photo on a publicly accessible URL. Do not host the photo on Google Drive even if the file is shared publicly, as Instagram API cannot download those files. The same applies to Dropbox URLs.
Maximum file size
The maximum photo size should be 8MiB.
Aspect Ratio
The aspect ratio must be within the range of 4:5 to 1.9:1.
Minimum width
The minimum width is 320 and will be scaled down to the minimum when required.
Maximum width
The maximum width is 1440 and will be scaled down to the maximum when required.
Height
The height can vary depending on width and aspect ratio.
Formats
The photo must be in JPEG format.
User Tags
Enter the user tag’s details:
Username
Enter the username who has a public Instagram account.
The username should not start with @, it must match the pattern, /^(?!@)/.
X position
Enter a float indicating the percentage distance from the left edge of the published media image lower than or equal to 1. This is an optional field.
Y position
Enter a float indicating the percentage distance from the right edge of the published media image lower than or equal to 1. This is an optional field.
Video URL
Enter the video’s URL address. The uploaded video must comply with the following requirements:
Please note that your video must be hosted on a publicly accessible URL and you cannot host your videos on Google Drive even if the file is shared publicly because Instagram API is not able to download files from Google Drive. The same applies to Dropbox URLs.
Maximum file size
The maximum video file size is 100 MiB.
Picture size
The picture size should be:
- Maximum columns (horizontal pixels): 1920
- Minimum aspect ratio [cols / rows]: 4 / 5・
- Maximum aspect ratio [cols / rows]: 16 / 9
Duration
The video duration can be a maxim of 60 seconds and a minimum of 3 seconds.
Container
MOV or MP4 (MPEG-4 Part 14), no edit lists, moov atom at the front of the file.
Frame rate
The frame rate should be between 23 – 60 FPS.
Video Codec
The video codec should be HEVC or H264, progressive scan, closed GOP, 4:2:0 chroma subsampling.
Video bitrate
The bitrate can be VBR and a maximum of 5Mbps.
Audio Codec
The audio can be AAC, 48khz sample rate maximum, 1 or 2 channels (mono or stereo).
Audio bitrate
The audio bitrate should be 128kbps.
Cover Frame
Enter the cover frame location in seconds of the video frame to be as the cover.
Caption
Enter a caption for the photo. You can also include hashtags ( #crazywildbeest) and usernames of Instagram users (for example, @natgeo). The caption can be a maximum of 2200 characters, 30 hashtags, and 20 @ tags.
Location ID
Enter the Page ID created for a physical location.
List Media
Retrieves all media from the specified Instagram page.
Connection
Establish a connection to your Instagram for Business account.
Page
Select the page you want to retrieve media from.
Limit
Set the maximum number of media Boost.space Integrator will return during one execution cycle. The default value is 10.
List Public User Media
Returns media of another Instagram Business or Creator IG User.
Connection
Establish a connection to your Instagram for Business account.
Page
Select or map a page whose public user media you want to list.
Username
Enter a username to list the media.
Limit
Set the maximum number of public user media Boost.space Integrator will return during one execution cycle. The default value is 10.
Get Media
Retrieves details of the specified media.
Connection
Establish a connection to your Instagram for Business account.
Media ID
Enter the Media ID, for example, from the Watch Media module whose details you want to retrieve.
Download a Media File
Downloads a media file.
Connection
Establish a connection to your Instagram for Business account.
Media ID
Enter (map) the media ID, for example, from the Watch Media module you want to download.
Get Album Media
Retrieves a list of all media in the specified album.
Connection
Establish a connection to your Instagram for Business account.
Media ID
Enter (map) the ID of the media album you want to retrieve media objects for.
Users
Get User Info
Retrieves information about other Instagram users.
Connection
Establish a connection to your Instagram for Business account.
Page
Select your page.
Username
Enter the username of the Instagram user you want to retrieve information about.
Comments
List Media Comments
Returns a list of IG Comments on an IG Media post.
Connection
Establish a connection to your Instagram for Business account.
Media ID
Enter a Media ID whose comments you want to list. Alternatively, you can search for a Media ID by selecting the page.
Limit
Set the maximum number of media comments Boost.space Integrator will return during one execution cycle. The default value is 10.
List Comment Replies
Returns a list of replies for a specific comment.
Connection
Establish a connection to your Instagram for Business account.
Comment ID
Enter a Comment ID whose replies you want to list. Alternatively, you can search for a Comment ID.
Page
Select or map a Page whose Media ID you want to retrieve.
Media ID
Select or map a Media ID whose comment replies you want to list.
Limit
Set the maximum number of comment replies Boost.space Integrator will return during one execution cycle. The default value is 10.
Create a Comment
Creates a comment on specified media.
Connection
Establish a connection to your Instagram for Business account.
Media ID
Enter (map) the ID of the media you want to create a comment on.
Message
Enter the text content of the comment.
Create a Reply
Replies to comment on media.
Connection
Establish a connection to your Instagram for Business account.
Comment ID
Enter (map) the ID of the comment you want to reply to.
Message
Enter the text content of the reply.
Stories
List Stories
Returns a list of stories associated with the Instagram page.
Connection
Establish a connection to your Instagram for Business account.
Page
Select the page you want to retrieve stories for.
Limit
Set the maximum number of stories Boost.space Integrator will return during one execution cycle.
Other
Watch Events
Triggers when the subscribed event is received.
Boost.space Integrator automatically creates a webhook in Instagram for Business once you add an instant trigger to your scenario.
Webhook name
Enter a name for the webhook.
Connection
Establish a connection to your Instagram for Business account.
Page
Select the page whose events you want to watch.
Event
Select the event:
- Comments
- Mentions
- Story Insights
Legacy article, imported from the original Boost.space knowledge base (/knowledge-base/applications/marketing/instagram-business/).
