npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

getsocialapi-instagram

v0.1.0

Published

GetSocialAPI — client library for the Instagram API (no cookies, no accounts required)

Readme

Instagram Scraper API · Node.js

tests license node

Node.js client for the GetSocialAPI Instagram Scraper API.

  • No cookies required — you never provide Instagram session cookies
  • No accounts needed — zero ban risk for your own profiles
  • Raw Instagram JSON responses, REST endpoints — no transformations
  • Automatic retries with Retry-After, typed exceptions
  • Zero dependencies — native fetch (Node.js >= 18)

Installation

npm install getsocialapi-instagram

Quickstart

import { Client } from 'getsocialapi-instagram';

// Get your API key at https://getsocialapi.com/dashboard/
const client = new Client({ apiKey: 'gsa_live_...' }); // or set GETSOCIALAPI_API_KEY

// Profile by numeric id (or userByUsername for usernames)
const user = await client.instagram.userInfo(25025320);
console.log(user.user.follower_count);

// Posts (grid)
const medias = await client.instagram.userMedias(25025320, 12);

// Followers / following — paginated on unverified accounts: pass `next_max_id`
// back as `maxId`. Verified accounts (blue checkmark) expose ~50 followers max.
let page = await client.instagram.followers(43586162288, 25);
page = await client.instagram.followers(43586162288, 25, page.next_max_id);

// All comments of a post — cursor is next_min_id -> minId ("recent" by default)
const comments = [];
let cursor = null;
for (;;) {
  const page = await client.instagram.mediaComments('4012386322294878415', 50, 'recent', cursor);
  comments.push(...page.comments);
  cursor = page.next_min_id ?? null;
  if (!cursor) break;
}

Note: numeric ids above Number.MAX_SAFE_INTEGER (2^53-1) — e.g. most media pks — lose precision in JS. Pass them as strings: mediaInfo('4012386322294878415') (shortcodes are strings anyway).

Base URL: https://api.getsocialapi.com/v1 — authenticate with the API key from your dashboard.

Client

new Client({ apiKey, baseUrl, timeout = 30, maxRetries = 3, fetchImpl })

| Parameter | Default | Description | | --- | --- | --- | | apiKey | env GETSOCIALAPI_API_KEY | your API key | | baseUrl | API endpoint | override only for testing | | timeout | 30 | per-request timeout, seconds | | maxRetries | 3 | retries on 429/503/5xx and network errors | | fetchImpl | native fetch | inject a custom fetch for testing |

Methods

| Method | Route | Description | | --- | --- | --- | | profile(userId) | /profile/<id> | profile by numeric id | | userInfo(userId) | /ig/user/info/<id> | profile by numeric id | | userByUsername(username) | /ig/user/username_info/<username> | profile by username | | userAbout(userId) | /user/about/<id> | About this account: country, joined, former usernames, shared-followers count, verified | | searchUsername(query, count = 10) | /search/username/<q> | search users, resolve username → pk | | similarUsers(userId) | /ig/user/similar/<id> | suggested accounts | | userMedias(userId, count = 12, maxId = null) | /ig/user/media/<id> | profile grid posts | | userTags(userId, count = 12, maxId = null) | /ig/user/tags/<id> | posts with the user tagged | | userStories(userId) | /ig/user/stories/<id> | active stories | | userHighlights(userId) | /ig/user/highlights/<id> | highlights tray | | highlightStories(highlightId) | /ig/highlight/stories/<id> | media of a highlight | | followers(userId, count = 50, maxId = null, query = null) | /followers/<id> | followers list | | following(userId, count = 25, maxId = null, query = null) | /following/<id> | following list | | mediaInfo(media) | /ig/media/info/<pk\|shortcode> | full media card; accepts numeric pk or shortcode | | mediaLikers(media) | /ig/media/likers/<pk\|shortcode> | users who liked (up to ~100, no pagination) | | mediaComments(media, count = null, sortOrder = "recent", minId = null) | /ig/media/comments/<pk\|shortcode> | media comments; cursor pagination next_min_id → minId | | searchClips(keyword) | /ig/media/search_clips/<kw> | search reels by keyword | | hashtagInfo(tag) | /ig/hashtag/info/<tag> | hashtag card | | hashtagSearch(query) | /ig/hashtag/search/<q> | search hashtags | | hashtagPosts(tag, maxId = null) | /v2/hashtag/posts/<tag> | posts by hashtag | | locationInfo(pk) | /ig/location/info/<pk> | location card | | locationMedia(pk, maxId = null) | /ig/location/media/<pk> | media by location |

Every method returns the raw JSON of the API route as a promise resolving to the parsed object — nothing is unwrapped, filtered or renamed. Where the API supports pagination (followers*, following, userMedias, userTags, hashtagPosts, locationMedia), pass the cursor from the previous response (next_max_id) as maxId. mediaComments paginates with a different cursor: always request with sortOrder "recent" (the default) and pass next_min_id back as minId until it comes back null — pages are chronological and disjoint. Instagram never returns next_max_id for comments, so max_id must not be used there. *followers works on unverified accounts (nearly the full list, plus the query filter); verified accounts (blue checkmark) expose no more than ~50 followers — one page, no cursor, query ignored. For lists without cursors (searchClips, hashtagSearch) each call simply returns the service page.

Full request/response reference with live examples: docs.getsocialapi → API Reference (see the Documentation section on getsocialapi.com).

Errors

| Exception | HTTP | Notes | | --- | --- | --- | | GetSocialAPIError | — | base class; also network errors | | APIKeyError / UnauthorizedError | 401 | invalid or missing key | | BadRequestError | 400 | .field points to the bad parameter | | NotFoundError | 404 | object does not exist — never retried | | RateLimitError | 429 | .retryAfter seconds | | ServiceUnavailableError | 503 | no live accounts, .retryAfter | | InstagramError | any | upstream Instagram error, .upstreamStatus |

All errors expose .status, .headers and .body of the failing response.

import { APIKeyError, NotFoundError, RateLimitError } from 'getsocialapi-instagram';

try {
  await client.instagram.userInfo(25025320);
} catch (e) {
  if (e instanceof NotFoundError) {
    // object does not exist
  } else if (e instanceof RateLimitError) {
    await new Promise((r) => setTimeout(r, e.retryAfter * 1000));
  } else if (e instanceof APIKeyError) {
    // invalid key
  }
}

Only successful responses (HTTP 200 and 404) count against your quota. Rate limits and plans: pricing.

Support

License

MIT