Instagram Social Walkthrough

Instagram Social API version 9 is currently supported

Accounts

Your Instagram Accounts are connected to Facebook pages.
You can have more than one account. Either leave the input box empty and extract data from all of you Instagram accounts, or click the accounts refresh button to pick a specific account.

Reports

Rivery supports 2 kind of reports.

Insights - Account

Insights on the account level.
Return data on the selected Instagram account insight metrics (Impressions / Reach..)

Select account fields

The fields provide additional information on the account.

Choose the fields from a predefined list. This field is mandatory.

Select report account metrics

The metrics reflect the insight performance of the account.

Choose the metrics from a predefined list. This field is mandatory.

Select metrics period

The time period your metrics will be based on.

For example, picking the Daily period for the "Impressions" metric will return daily results of impressions in the chosen date range.

Select a time period

Entity reports supports two kinds of time period:

1. Date Range -

   • Pulls data in the date range between the start and end date provided.
   • You must select a Start date.
   • The Start Date won't be advanced if a River run is unsuccessful.
     If you don't want this default setting, click More Options and check the box to advance the start date even if the River run is unsuccessful (Not recommended).
     
   • Leaving the End date empty will pull data according the the current time of the river's run.
   • Select a timezone offset to send dates considering the offset.
   • Use the "Last Days Back For Each Run" to expend the start date and pull data a given number of days back before the chosen star date.

In the example above the river will run with date range between "11/07/2018" and "17/07/2018".

2. Predefined date - A date range defined by Rivery:

   • Day - Yesterday.
   • Week (From Monday to Sunday) - Week to date, Previous week, Previous week to date.
   • Month - Month to date, Previous month, Previous month to date.
   • Year - Year to date.

Insights - Media

Insights on the media level.

Select media fields

The fields provide additional information on the media object.

Chose the fields from a predefined list, This field is mandatory.

select media type

There are 4 media object types in Instagram - Image, Video, Story, and carousel Album.
You can either choose one specific media type to extract insights from, or leave this field empty to extract insights for all possible media types.

select media metrics

The metrics reflect the insight performance of the media object.

Each media object has a separate list of metrics to choose from. When picking a specific media type, only the relevant metric list will be shown.

If you've left the media type empty, you must choose at least one metric from each list.
These fields are mandatory.

Select media metrics period

The time period your metrics will be based on.

"Lifetime" is the only available period resolution for media insights, and it is chosen by default.

Select a time period

Important note on time period for insight media report.
Insights Media report - uses the media object creation time.For example: if the desired media was created on the 14th of May be sure to include that date in your date range.Entity reports supports two kinds of time period:

1. Date Range -

   • Pulls data in the date range between the start and end date provided.
   • You must select a start date.
   • Leaving the end date empty will pull data according the the current time of the river's run.
   • Select a timezone offset to send dates considering the offset.
   • Use the "Last Days Back For Each Run" to expend the start date and pull data a given number of days back before the chosen star date.

In the example above the river will run with date range between "11/07/2018" and "17/07/2018".

2. Predefined date - A date range defined by Rivery:

   • Day - Yesterday.
   • Week (From Monday to Sunday) - Week to date, Previous week, Previous week to date.
   • Month - Month to date, Previous month, Previous month to date.
   • Year - Year to date.

Rate Limiting, API limitations and known issues

• Stories limitations:

  • Responses will not include Live Video stories.

  • Stories are only available for 24 hours.

  • New stories created when a user reshares a story will not be returned.
    Once the story is no longer available on the Instagram platform it doesn't return from the Instagram API.

• Instagram has a very strict rate limiting of 200 calls per hour per user, exceeding this limit will result in errors. You will receive a timeout and will have to wait until your quota refreshes.

• You can't pull insights for media posted before the Instagram account was converted to a business account.

e.g. If an account was converted on the 27th of February you can't get insights for media posted before the 27th

• You can only pull up to 10,000 latest media objects
• Data used to calculate metrics can be delayed up to 48 hours.
• Data "discrepancies" between the API and the web applications:

There is a known issue which is now by design that the likes (like_count) and comments(comments_count) values retrieved from the API are different than the web app.

This is due to the following:

1. Comments count will not show private user comments.

2. Like count doesn't count promoted post result.

i.e. only organic likes are counted and only public user comments are counted