Skip to main content

​
Overview

The ScrapeBadger Instagram API turns instagram.com’s public surface into a clean JSON feed: user profiles and their related accounts and posts, media detail with oembed, comments and comment-likers, hashtag info and recent feeds, and search (hashtags + blended top).
Authenticated (account-pool) endpoints — stories, highlights, followers/following, locations, audio, and the user about/videos/reels/tagged/pinned, hashtag top/reels, media likers, comment replies and search users/places/reels/music/autocomplete variants — are temporarily unavailable and not documented while offline.
All endpoints are GET, live under https://scrapebadger.com/v1/instagram/*, and authenticate with the X-API-Key header. No Instagram account or upstream API key is required — ScrapeBadger handles authentication, rate limiting, TLS fingerprinting and proxy rotation transparently. Credits are charged per request (see the table below) and reported on the X-Credits-Used response header.

​
Features

  • Profiles — full public profile by username: bio, links, counts, verification, business/professional metadata, plus related accounts and paginated posts.
  • Media — media detail by shortcode code, oEmbed, paginated comments, and per-comment likers.
  • Hashtags — hashtag info by tag, plus a paginated recent feed.
  • Search — hashtags and blended top results.

​
Honesty caveat

These endpoints read Instagram’s public surface only. Private accounts expose profile metadata but not their posts or media. Fields reflect what Instagram serves to an unauthenticated client; some professional/business fields are only present when the account has opted into them.

​
Conventions

  • Pagination. List endpoints take amount (page size) and a cursor (opaque next-page token). Every list response is wrapped in { items, count, next_cursor, has_more } — pass next_cursor back as cursor to walk forward until has_more is false.
  • Datetimes. Every datetime ships in both a Unix form (*_utc) and an ISO 8601 UTC string (*_at), e.g. taken_at + taken_at_utc.

​
Credits

Standard read (5) covers profile, related, media detail, hashtag info and search top. Paginated listings (8) cover posts, hashtag recent, comments and comment-likers.

​
Quickstart

Resolve a handle with /users/{username}, then page their media with /users/{username}/posts by passing the returned next_cursor back as cursor until has_more is false.