Instagram Scraper API

Python 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

Installation

pip install getsocialapi-instagram

Migration from getsocialapi (git installs)

Before the PyPI release this SDK was installed from git as getsocialapi. Old imports keep working via a deprecated shim, but please migrate:

pip uninstall getsocialapi
pip install getsocialapi-instagram

# before
from getsocialapi import Client
# after
from getsocialapi_instagram import Client

Quickstart

from getsocialapi_instagram import Client

# Get your API key at https://getsocialapi.com/dashboard/
client = Client(api_key="gsa_live_...")  # or set GETSOCIALAPI_API_KEY

# Profile by numeric id (or user_by_username for usernames)
user = client.instagram.user_info(25025320)
print(user["user"]["follower_count"])

# Posts (grid)
medias = client.instagram.user_medias(25025320, count=12)

# Followers / following — paginated on unverified accounts: pass `next_max_id`
# back as `max_id`. Verified accounts (blue checkmark) expose ~50 followers max.
page = client.instagram.followers(43586162288, count=25)
page = client.instagram.followers(43586162288, max_id=page["next_max_id"])

# All comments of a post — cursor is next_min_id -> min_id (sort_order="recent" by default)
comments, cursor = [], None
while True:
    page = client.instagram.media_comments(4012386322294878415, count=50, min_id=cursor)
    comments += page["comments"]
    cursor = page.get("next_min_id")
    if not cursor:
        break

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

Client

Client(api_key=None, base_url="https://api.getsocialapi.com/v1", timeout=30, max_retries=3)

Methods

Every method returns the raw JSON of the API route as received — nothing is unwrapped, filtered or renamed. Where the API supports pagination (followers*, following, user_medias, user_tags, hashtag_posts, location_media), pass the cursor from the previous response (next_max_id) as max_id. media_comments paginates with a different cursor: always request with sort_order="recent" (the default) and pass next_min_id back as min_id 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 (search_clips, hashtag_search) 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

from getsocialapi_instagram import NotFoundError, RateLimitError
import time

try:
    client.instagram.user_info(25025320)
except NotFoundError:
    ...  # object does not exist
except RateLimitError as e:
    time.sleep(e.retry_after)

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

Support

• Telegram: @getsocialapi
• Email: hello@getsocialapi.com
• Website: getsocialapi.com
• Documentation: getsocialapi.com/docs
• Status: getsocialapi.com/status

License

MIT