Skip to main content
Feedback

Instagram Social walkthrough

info

Instagram Social API version 21 is currently supported.

info

The following time frames are not supported for the metrics reached_audience_demographics and engaged_audience_demographics:

  • last_14_days
  • last_30_days
  • last_90_days
  • prev_month

To connect Instagram Social with your destination, follow the step-by-step tutorial.

Predefined reports

Data Integration provides a convenient entry point and recommended approach for accessing a range of predefined reports. Each report includes a concise data description, a list of customizable fields (if applicable), and the schema mapping.

These reports follow a standardized format, so specific fields are locked, and you can only access them through the Custom reports.

Custom reports

Data Integration supports three types of custom reports:

Insights - account

Insights on the account level provide data on selected Instagram account insight metrics such as Impressions and Reach.

Select Instagram account fields (mandatory)

Choose additional information fields for the account from a predefined list.

Select report metrics (mandatory)

Choose insight performance metrics for the account from a predefined list.

Select metrics period

Select the time period for the metrics data. Options include Daily, Weekly, Monthly, and Yearly periods. For example, selecting the Daily period for the "Impressions" metric provides daily impression results within the specified date range.

Select a time period

Choose between a Date Range or a Predefined Date for the report's time period.

  • Date range: Specify a start date and an optional end date. Choose a timezone offset if needed. Use the "Last Days Back For Each Run" option to extend the start date's range.
info
  • Start Date is mandatory.
  • You can retrieve data for the date range specified between the start and end dates.
  • If you leave the end date blank, the data will be pulled at the current time of the river's run.
  • Date timezone: UTC.
  • The Start Date does not advance if a River run is unsuccessful. If you do not want this default setting, click More Options and select the checkbox to advance the start date even if the River run is unsuccessful (not recommended).
  • Use the Last Days Back For Each Run option to gather data from a specified number of days before the selected start date.
  • Use the Future Days Ahead feature to configure automated day-to-day incremental prediction flows for future dates. Removing the limitation of the maximum run date to the current date provides increased flexibility in forecasting capabilities.
  • Predefined date: Choose options such as Day (Yesterday), Week (Current and Previous), Month (Current and Previous), and Year (Year to Date).

Insights - Media

Insights on the media level provide data on selected media object types (Image, Video, Story, Carousel Album).

Select media fields (mandatory)

Choose additional information fields for the media object from a predefined list.

Select media type

You can choose a specific media type (Image, Video, Story, Carousel Album) or leave it empty to include insights for all media types.

Select media metrics

Choose insight performance metrics for the media object. Each media type has its list of relevant metrics.

If you select Media Type = All, you must choose metrics in all three sections:

  • Post metrics
  • Story metrics
  • Album metrics

Failing to select from any of these sections causes the river to fail.

Select media metrics period

Select performance metrics for the media object. Each media type has its own set of applicable metrics. If you leave the media type field blank, you must select at least one metric from each list.

  • Specify the time period your metrics are based on.
  • Lifetime is the only available period resolution for media insights, and is enabled by default.

Select a time period

Choose between a Date Range or a Predefined Date for the report's time period.

  • Date range: Specify a start date and an optional end date. Choose a timezone offset if needed. Use the Last Days Back For Each Run option to extend the start date's range.
info
  • Start Date is mandatory.
  • You can retrieve data for the date range specified between the start and end dates.
  • If you leave the end date blank, the data is pulled at the current time of the river's run.
  • Date timezone: UTC.
  • The Start Date does not advance if a River run is unsuccessful. If you do not want this default setting, click More Options and select the checkbox to advance the start date even if the River run is unsuccessful (not recommended)
  • Use the Last Days Back For Each Run option to gather data from a specified number of days before the selected start date.
  • Use the Future Days Ahead feature to configure automated day-to-day incremental prediction flows for future dates. Removing the limitation of the maximum run date to the current date provides increased flexibility in forecasting capabilities.
  • Predefined date: Choose options such as Day (Yesterday), Week (Current and Previous), Month (Current and Previous), and Year (Year to Date).

Rate limiting, API limitations, and known issues

Stories limitations

  • Live Video stories are not included in responses.
  • Stories are available only for 24 hours.
  • The API does not return re-shared stories that create new stories.
  • Stories unavailable on the Instagram platform do not return from the API.

Rate limitation

The Instagram API limits users to 200 calls per hour. Exceeding this limit results in errors.

Insights for pre-conversion media

Media insights cannot be pulled for posts before an Instagram account was converted to a business account.

Maximum media objects

You can pull up to 10,000 of the latest media objects.

Data delay

Metrics calculation data can be delayed by up to 48 hours.

Data discrepancies

Differences may exist between API and web app data, such as likes not counting promoted post results and comments not showing private user comments.

On this Page