Integration spotlight: Instagram

Integration spotlight: Instagram

Overview

Dashdash’s Instagram integration lets you get insights and key metrics about your Instagram Business or Creator accounts. Use them to monitor your Instagram account performance or benchmark it against the competition.

:memo: Note: To be able to use this integration, you need to have an Instagram Business or Creator account that’s linked to your Facebook Business Page.

If you need to create a Business or Creator account, see the Set Up a Creator Account guide on Instagram.

If you need some help adding your Facebook Page to your Instagram account, have a look at

Functions

The Instagram integration has the following five functions:

Function Description
GET_ACCOUNT_INSIGHTS_INSTAGRAM Get insights and key metrics for your account within a time period.
GET_POST_INSIGHTS_INSTAGRAM Get the insights and key metrics for one of your Instagram posts.
GET_ACCOUNT_POSTS_INSTAGRAM Get the 50 latest Instagram posts and KPIs for an account.
GET_FOLLOWERS_INSTAGRAM Get the number of followers of an Instagram account.
GET_FOLLOWING_INSTAGRAM Get the number of users an Instagram account is following.

GET_ACCOUNT_INSIGHTS_INSTAGRAM

Get insights and key metrics for your account within a time period. By default, it returns:

  • Number of followers
  • Impressions
  • Profile views
  • Reach
  • Website clicks

Syntax

GET_ACCOUNT_INSIGHTS_INSTAGRAM(username, [account_metrics], [aggregation_period], [date_range])

Parameter Mandatory Description
username Yes The Instagram username of your business or creator account. For example: "adidas".
account_metrics No Metrics to retrieve about the account, separated by commas. By default it will return the number of followers, impressions, profile_views, reach, and website_clicks.

For a detailed list of the available metrics, see the Metrics and Insights Instagram API documentation
aggregation_period No Period of aggregation of the data. For example: "day", "week", "day_28".

For a complete list of possible aggregation periods, see the Metrics and Insights Instagram API documentation.
date_range No Date range to get insights for, up to 30 days. For example: ">2020-11-01" or "[2010-01-01;2019-01-01]". By default, it gets the last two days.

Example

To get the default insights and metrics for your account:

=GET_ACCOUNT_INSIGHTS_INSTAGRAM(“your_account_username”)

Example screenshot

To get your weekly impression and reach metrics for the last 30 days:

=GET_ACCOUNT_INSIGHTS_INSTAGRAM(“your_account_username”, “reach,impressions”, “week”, "[2020-06-1;2020-06-30]”)

Example screenshot

GET_POST_INSIGHTS_INSTAGRAM

Get the insights and key metrics for one of your Instagram posts. By default, it returns these metrics:

  • impressions
  • reach
  • engagement

Syntax

GET_POST_INSIGHTS_INSTAGRAM(media_id, [post_metrics])

Parameter Mandatory Description
media_id Yes The Instragram Media ID of your post. For example: "1234566333".

To get the media_id of your post, use the GET_ACCOUNT_POSTS_INSTAGRAM using your username and retrieve the ID from the data explorer side panel.
post_metrics No The metrics to retrieve about the post, separated by commas. For example: "engagement, insights". By default it will return the impressions, reach, and engagement metrics.

For a complete list of possible metrics, see the Metrics and Insights Instagram API documentation.

Example

To get the default metrics for a post with a media_id of 112312423432134:

=GET_POST_INSIGHTS_INSTAGRAM(“112312423432134”)

Example screenshot

To get the video_views metric for a post with a media_id of 17882876047667046 :

=GET_POST_INSIGHTS_INSTAGRAM(“17882876047667046”)

Example screenshot

GET_ACCOUNT_POSTS_INSTAGRAM

Get the 50 latest Instagram posts and their KPIs for an account.

Syntax

=GET_ACCOUNT_POSTS_INSTAGRAM(username)

Parameter Mandatory Description
username Yes The Instagram username of a business or creator account. For example: "adidas".

Example

To get the last 50 posts and their metrics for Adidas:

=GET_ACCOUNT_POSTS_INSTAGRAM("adidas")

Example screenshot

GET_FOLLOWERS_INSTAGRAM

Get the number of followers of an Instagram account.

Syntax

=GET_FOLLOWERS_INSTAGRAM(username)

Parameter Mandatory Description
username Yes The Instagram username of a business or creator account. For example: "adidas".

Example

To get the number of users following Reebok, just use:

=GET_FOLLOWERS_INSTAGRAM(“reebok”)

Example screenshot

GET_FOLLOWING_INSTAGRAM

Get the number of users an Instagram account is following.

Syntax

=GET_FOLLOWING_INSTAGRAM(username)

Parameter Mandatory Description
username Yes The Instagram username of a business or creator account. For example: "adidas".

Example

To get the number of users Nike is following, just use:

=GET_FOLLOWING_INSTAGRAM("nike")

Example screenshot

Get building!

Right, so now all that’s left is to get building! We can’t wait to see what you create :muscle:.

Cheers,

The dashdash team

5 Likes