sdk-instagram 1.0.0

Instagram API allows developers to integrate Instagram’s core features like user profiles, photos, videos, and basic interactions into apps and services.

Getting Started with Instagram API

Introduction

Description of Instagram RESTful API.

Current limitations:

• Instagram service does not support cross origin headers for security reasons, therefore it is not possible to use Swagger UI and make API calls directly from browser.
• Modification API requests (POST, DELETE) require additional security scopes that are available for Apps created on or after Nov 17, 2015 and started in Sandbox Mode.
• Consider the Instagram limitations for API calls that depends on App Mode.

Warning: For Apps created on or after Nov 17, 2015 API responses containing media objects no longer return the data field in comments and likes nodes.

Last update: 2015-11-28

Instagram Developer Documentation: https://instagram.com/developer

Install the Package

The package is compatible with Python versions 3.7+. Install the package from PyPi using the following pip command:

pip install sdk-instagram==1.0.0

You can also view the package at: https://pypi.python.org/pypi/sdk-instagram/1.0.0

Initialize the API Client

Note: Documentation for the client can be found here.

The following parameters are configurable for the API Client:

Parameter	Type	Description
environment	Environment	The API environment. Default: Environment.PRODUCTION
http_client_instance	HttpClient	The Http Client passed from the sdk user for making requests
override_http_client_configuration	bool	The value which determines to override properties of the passed Http Client from the sdk user
http_call_back	HttpCallBack	The callback value that is invoked before and after an HTTP call is made to an endpoint
timeout	float	The value to use for connection timeout. Default: 60
max_retries	int	The number of times to retry an endpoint call if it fails. Default: 0
backoff_factor	float	A backoff factor to apply between attempts after the second try. Default: 2
retry_statuses	Array of int	The http statuses on which retry is to be done. Default: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524]
retry_methods	Array of string	The http methods on which retry is to be done. Default: ['GET', 'PUT']
api_key_credentials	ApiKeyCredentials	The credential object for Custom Query Parameter
instagram_auth_credentials	InstagramAuthCredentials	The credential object for OAuth 2 Implicit Grant

The API client can be initialized as follows:

from instagramapi.configuration import Environment
from instagramapi.http.auth.api_key import ApiKeyCredentials
from instagramapi.http.auth.instagram_auth import InstagramAuthCredentials
from instagramapi.instagramapi_client import InstagramapiClient
from instagramapi.models.o_auth_scope_instagram_auth_enum import OAuthScopeInstagramAuthEnum

client = InstagramapiClient(
    api_key_credentials=ApiKeyCredentials(
        access_token='access_token'
    ),
    instagram_auth_credentials=InstagramAuthCredentials(
        o_auth_client_id='OAuthClientId',
        o_auth_redirect_uri='OAuthRedirectUri',
        o_auth_scopes=[
            OAuthScopeInstagramAuthEnum.BASIC,
            OAuthScopeInstagramAuthEnum.COMMENTS
        ]
    ),
    environment=Environment.PRODUCTION
)

Authorization

This API uses the following authentication schemes.

• api_key (Custom Query Parameter)
• instagram_auth (OAuth 2 Implicit Grant)

List of APIs

• Users
• Relationships
• Media
• Comments
• Likes
• Tags
• Locations
• Geographies

SDK Infrastructure

HTTP

• HttpResponse
• HttpRequest

Utilities

• ApiHelper
• HttpDateTime
• RFC3339DateTime
• UnixDateTime