Data Connector for Instagram User & Media Insights (BETA)

Instagram Business enables you to obtain insights about your Instagram media objects and your user account activities. You can use Treasure Data’s connector to bring Instagram insight data into Treasure Data for integration with your other data resources on the Treasure Data platform.

This feature is currently in beta. Contact us for further details about the private beta.

Create a new transfer

Select the My Connections tab, find the connection you created, and click New Transfer.

Configure the connector by completing the fields.

Instagram Insights supports the following parameters.

Facebook Page Name (Required)

Enter the name of the Facebook page that is linked to the Instagram Business account. When a user creates or converts an Instagram account to a business account, the user is required to link the Instagram Account to a Facebook page.

Data type (Required)

Select one of the data types: User and Media.

User insights are metrics collected about your Instagram Business account, such as impressions, follower_count, website_clicks, and audience_locale.

Media insights are metrics collected from content posted for your Instagram business account, such as engagement, impressions, reach, and saved.

Start Date & End Date (Required for the User data type)

The start date and end date must follow the format: YYYY-MM-DD. Example: 2017-11-21.

Start Date is inclusive and End Date is exclusive.

If not specified, the end date defaults to the current time in Instagram Business Account Local Time.

If not specified, the start date defaults to 2 days before the end date.

The defaults are set by Facebook API.

Data is aggregated at the end of each day, so the insights of 2017-01-01 result in end_time = 2017-01-02 00:00:00.

If you use incremental loading and scheduled jobs, the time range for the next iteration (run) is calculated based on the period between the initial start and end dates, and the imported data will not have gaps.

Use Individual Metrics

Select if you want to manually choose the metrics data to import. The dropdown lists all individual metrics for the selected data type. You can select multiple metrics.

Media metrics supports only [period: lifetime]

User metrics support day, week, days_28, and lifetime

Note: Except for the online_followers metric, the lifetime metric requires that the Incremental Loading checkbox is unchecked and the Start Date and End Date fields are empty.

Preset Metrics

You can select multiple, preset metrics for the selected data type.

For User metrics, the default is Week metrics. You can select from the following preset User metrics:

Week metrics [period: week]

Days 28 metrics [period: days_28]

Day metrics [period: day]

Lifetime metrics [period: lifetime], does not support incremental import

For Media metrics, the default is All media metrics. You can select from the following preset Media metrics:

All media metrics. All media metrics will import metrics for all content in Instagram account*

Story metrics. Import metrics for Instagram Story

Carousel metrics. Import metrics for Instagram Carousel

Photo and video metrics, will only import metrics for Instagram image and video*

Import media metrics

Media metrics [period: lifetime]

If a metric is supported by multiple media objects, example: IMAGE, VIDEO, STORY, and so on, then the metric values of all those media objects will be imported.

Import user metrics

User metrics support day, week, days_28, and lifetime

Note: Except for the online_followers metric, all [period: lifetime] metrics require that the Incremental Loading checkbox is unchecked and the Start Date and End Date fields are empty.

Incremental Loading

By enabling Incremental Loading, you can schedule a job to run iteratively. Each iteration of the job run is calculated based on the Start Date and End Date values.

In the following example, let’s use a 9 day range between the start and end date:

Start Date: 2017-10-01
End Date: 2017-10-11

Each job will have the same time range as determined by period between the start and end dates. The transfer of metrics begins at the completion of the previous job, until the period extends past the current date (which is the default end date). Further transfers will be delayed until a complete period is available, at which the job will execute and then pause until the next period is available.