Instagram restAPI Connector

Instagram Rest API Connector

Instagram provides an API framework to support valid applications connecting and in our case pulling data for analytics.

This Rest configuration will allow you to pull from the Instagram Rest API service. Please refer to provided sample file for setup.

Installing the connector

Download connector files
Copy the folder to the following location where Sisense is installed:

...\Program Files\Sisense\DataConnectors\DotNetContainer\Connectors

Instagram Setup

To configure one must setup a developer account as well as an Application with Instagram. Further documentation including Application rules can be found on the Instagram Site.

https://www.instagram.com/developer/

Server Setup

-Add folder to data connectors folder (Program Files\Sisense\DataConnectors\DotNetContainer\Connectors\Rest.Instagram.Connector)
Add the two config files listed below. (config.json, oauth2Config.json)
Include Connector DLL per documentation.

http://developer.sisense.com/display/API2/Custom+REST+Connector

rest Config File

 "Settings": {
   "Provider": "rest.Instagram.connector",
   "DisplayName": "Instagram",
   "OAuth2Config": "oauth2Config.json",
   "MaxDocs": 100,
   "FetchSize": 1000,
   "Parameters": {}
 }

Authentication file

Instagram uses Oauth2 Authentication. Sample Configuration:

{ "Provider": "rest.Instagram.connector",
  "AccessCodeService": {
    "BaseUri": "https://api.instagram.com",
    "Resource": "/oauth/authorize"
  },
  "AccessTokenService": {
    "BaseUri": "https://api.instagram.com",
    "Resource": "/oauth/access_token"
  },
  "UserInfoService": {
    "BaseUri": "https://api.instagram.com",
    "Resource": ""
  },
  "ClientId": "{CLIENT ID}",
  "ClientSecret" : "{CLIENT SECRET}",
  "ClientTypeName": "{APPLICATION NAME}",
  "RedirectUri": "http://{Public or internal IP address}:7077/auth/rest.Instagram.connector",
  "Scope" : "basic public_content follower_list comments relationships likes"
}

Tables

I’ve included a few basic tables as a foundation. More tables can be added by modifying the Config file but limited by your scope restrictions.

Self
Follows
Followed By
Comments
Recent Media
Tagged Users

Additional Notes

This functionality is intended for restAPI developers and requires knowledge about rest API and the specific Instagram rest API configuration requirements.
The data you can bring in is restricted based on the permissions that you’re API account has been granted. Additional permission need to be defined in the SCOPE configuration in the Oauth Authentication File.
- https://www.instagram.com/developer/authorization/
To get public data and additional permissions you would have to go through permission review for the App being built.
- https://www.instagram.com/developer/review/
Note that in the app configuration the "Valid redirect URIs" must contain the same url written in the oauth2Config.json file. Also keep the options "Disable implicit OAuth and "Enforce signed requests" off. (See screenshot below.)

If after you authenticate for the first time you need to change the username or password of the user, you need to delete the information cached in internet explorer. To do so, open Internet Explorer, and click on Delete Browsing History. (See screenshot below.)

Thanks DOUG for the help with this – you the man!

Official comment

Limor Fledel

May 07, 2020 20:10

Hi all,

Instead of using a manually built REST connector, you can use our certified connector for Instagram.

It's available to download from here and more documentation is available here.

Best Regards,

Limor

Hugh Brown

November 22, 2016 18:04

"Sample Configuration [placed into a file named oauth2Config.json in the same directory as the REST config file]"

Ramon Lopez

December 06, 2016 19:02

Hi Hugh- Have updated documentation to better highlight files required. Many thanks.

Rabia Farooq

July 01, 2019 12:18

is this still functional?

Ben Guerard

October 09, 2019 15:37

I'd like to echo that question...is this still functional? I'd hate to burn time setting this up and have it not work at all.

October 09, 2019 18:56

Hi all-

I would recommend using the CData JDBC connector over this. (it did work at one point, I have not tested recently and it's possible that if the API changed it might not work)

Here is the link to the driver: https://www.cdata.com/drivers/instagram/

Start with the trial and if you would like a full license of the driver reach out to your CSM.

Cheers