Skip to content

Library to obtain information from an Instagram account in a friendly and intuitive way

License

Notifications You must be signed in to change notification settings

EdixonAlberto/instagrapi

Repository files navigation

Instagrapi

code style: prettier

Library to obtain information from an Instagram account in a friendly and intuitive way.

The library works as a wrapper for the basic Instagram API, to abstract long or confusing property names and have a clean and readable data structure.

Created with NodeJS and Typescript, all types are exposed for use. Logo typescript + 💗

📃 NOTE: This library can only be used on the server with Nodejs.

📃 NOTE: Login to Instagram required to obtain an ID.

📃 NOTE: In version 4.x.x the "getPost" method no longer works due to changes in the Instagram api.

🌐 Demo Web Site

Installation

npm install instagrapi
# or
yarn add instagrapi

Usage

First you must get the cookie called "sessionId" by logging in to your instagram account. To do this you must follow these steps:

  1. Go to https://www.instagram.com
  2. If you don't have a session logged in start one
  3. Open development tools witch Ctrl + Shift + I
  4. Get to the application section and then to Cookies and select on the right hand side sessionId

Now you can use the library by instantiating an object and passing the sessionId as an argument

const { Instagrapi } = require('instagrapi')

const instagrapi = new Instagrapi({
  sessionId: process.env.SESSION_ID // Load sessionId from an environment variable
})

instagrapi.getProfile('USERNAME').then(profile => {
  console.log(profile.followers) // Numbers followers of instagram account
})

Using typescript and async/await.

import { Instagrapi, TPost, TComment } from 'instagrapi'

const instagrapi = new Instagrapi({
  sessionId: process.env.SESSION_ID
})

async function getComments(): Promise<string[] | undefined> {
  try {
    const post: TPost = await instagrapi.getPost('POST_URL')
    const comments: string[] = post.previewComments.map((comment: TComment) => comment.content)

    console.log(comments) // Preview comments of the post

    return comments
  } catch (error) {
    console.error(error)
  }
}

getComments()

Media Files

By default Instagram API return media files via a CDN configured with CORS rules so tha they can only be consumed from the official page.

To work around this you can build your own proxy server and add it in instance confiuration. In this way the library will automatically add the proxy as a prefix in all the media files that are found in the response.

const instagrapi = new Instagrapi({
  sessionId: process.env.SESSION_ID,
  proxy: 'https://proxy-example.com'
})

instagrapi.getProfile('USERNAME').then(profile => {
  const imgUrl = profile.image.standard

  console.log(imgUrl) /* https://proxy-example.com/img-url... */
})

Methods

  • getProfile(USERNAME)

Get all the profile information of an instagram account. Receives as argument: USERNAME, the username of the instagram account.

Type of output in typescript:

type TProfile = {
  username: string
  name: string
  image: {
    standard: string
    hd: string
  }
  qtyPosts: number
  followers: number
  following: number
  biography: string
  externalUrl: string
  isBusiness: boolean
  isVerified: boolean
  isPrivate: boolean
}
  • getLastPosts(USERNAME)

Get the last 12 posts of an instagram account. Receives as argument: USERNAME, the username of the instagram account.

Type of output in typescript:

type TLastPosts = Array<{
  postUrl: string
  image: string
  video: null | {
    url: string
    views: number | null
  }
  content: string | null
  likes: number
  qtyComments: number
}>
  • getPost(POST_URL):

Get all the details of a post of an instagram account. Receives as argument POST_URL, the url of the post on instagram.

Type of output in typescript:

type TPost = {
  postUrl: string
  image: {
    standard: string
    hd: string
  }
  video: TVideo | null
  content: string | null
  likes: number
  qtyComments: number
  gallery: Array<TMedia>
  author: TAuthor
  coauthors: Array<TAuthor>
  previewComments: Array<TComment>
  location: null | {
    country: string | null
    region: string | null
    city: string | null
    street: string | null
    coordinates: {
      lat: number
      lng: number
    }
  }
  date: string
}

License

MIT © Edixon Piña