The Instagram API for products and pipelines.

Retrieve supported public Instagram data — profiles, posts, reels, comments, story highlights, tagged posts, and location feeds — through REST endpoints that return one consistent response model.

Get free API key View the docs

13 supported endpoints
Public data only
Fetched at request time

GET/v1/instagram/users/{username}200OK

{
  "type": "Person",
  "preferredUsername": "nasa",
  "name": "NASA",
  "summary": "Making the seemingly impossible, possible. ✨",
  "isVerified": true,
  "followerCount": 104251771,
  "followingCount": 92,
  "attachment": [
    {
      "href": "https://www.nasa.gov"
    }
  ]
}

What you can pull from Instagram.

Almost everything you can reach on Instagram hangs off a profile. A profile lookup returns bio, follower and post counts, and the links in the bio as normalized attachments. Posts, reels, and tagged posts are three separate cursor-paginated feeds, so a workload that only wants reels does not have to filter a mixed feed. A carousel arrives as one post with its children nested inside it rather than as several posts.

Story highlights are two calls, not one: the highlights endpoint lists the reels on a profile, and the highlight endpoint returns the story items inside one of them. Location feeds take a numeric Facebook Places ID, which is worth resolving once and storing rather than looking up per run.

Every response uses the same ActivityStreams 2.0-based model as the other supported platforms, so a Instagram integration reuses the parsing you already wrote. Fields specific to Instagram stay as documented first-class fields rather than being flattened away.

Instagram data

Profiles with normalized bio links
Post, reel, and tagged-post feeds
Single posts, including carousels
Post comments
Story highlights and their items
Trending media search and location feeds

All 13 Instagram endpoints.

Grouped by what they return. Every one has its parameter contract, a request you can copy, and an example response.

Profiles

The account record: bio, follower and post counts, and the bio links as normalized attachments.

Get user profileReturns profile information for an Instagram user including bio, follower counts, profile picture, and account metadata. Look up any public Instagram…GET /v1/instagram/users/{username}

Feeds

Posts, reels, tagged posts, and highlight reels as separate feeds, so a run that only wants reels never filters a mixed one.

Get user postsReturns a paginated list of posts from an Instagram user's profile feed. Maximum 12 posts per page. Includes photos, videos, carousels, and engagement…GET /v1/instagram/users/{username}/posts Get user reelsReturns a paginated list of reels from an Instagram user's profile, newest first. Maximum 8 reels per page. Includes video URLs, captions, and engagement…GET /v1/instagram/users/{username}/reels Get user tagged postsReturns Instagram posts where the user has been tagged by other accounts. Maximum 12 posts per page. Includes full post details and engagement counts.GET /v1/instagram/users/{username}/tagged Get user story highlightsInstagram API: Returns the list of story highlight reels on a user's profile. Use the highlight endpoint to get individual stories within a highlight.GET /v1/instagram/users/{username}/highlights

Posts

One post by shortcode, with a carousel arriving as one object with its children nested inside — and the story items inside a highlight.

Get post detailsInstagram API: Returns details for a single post by its shortcode, including media, captions, and engagement counts. Supports photos, videos, and…GET /v1/instagram/posts/{postId}Get highlight storiesInstagram API: Returns all story items within a highlight reel, including images and videos. The highlight ID comes from the highlights list endpoint.GET /v1/instagram/highlights/{highlightId}

Comments

The comments on a single post, 15 to a page.

Get post commentsReturns top-level comments on an Instagram post. Fixed page size of 15 (platform limit). Includes comment text, author info, like counts, and timestamps.GET /v1/instagram/posts/{postId}/comments

Discovery

The two ways in without a username: trending media for a keyword, and the posts attached to a Places ID.

Get reels by audioReturns a paginated list of reels using a given audio/music track. Instagram always returns a fixed batch of 12 per page.GET /v1/instagram/audios/{audioId}/reels Get posts by locationInstagram API: Returns recent posts tagged at a location. Fixed page size of 21 (platform limit). The location ID is a numeric Facebook Places ID.GET /v1/instagram/locations/{locationId}Search mediaSearches Instagram for trending reels and videos matching a keyword. Maximum 24 results per page. Some valid keywords may return no results, since this…GET /v1/instagram/search Search popular topicsReturns a paginated batch of posts matching a keyword, along with Instagram's generated description of the topic and related sub-topics as links. Not an…GET /v1/instagram/search/popular Get trending reelsReturns a paginated batch of reels from Instagram's public trending reels feed.GET /v1/instagram/trending/reels

How the calls fit together.

Few Instagram jobs are a single request. Most are two or three chained, each call keyed by an id the one before it returned.

Benchmark an account

Read the profile for the denominator, then a page of posts for what a typical post actually does.

Read a post’s response

Take the post for its media and counts, then its comments for what the audience said.

Mine story highlights

List the highlight reels on a profile, then open one for the story items inside it.

What shapes your Instagram integration.

Page sizes, ordering, and what the platform itself withholds — the details that decide how you build, settled before you write a line of code.

01Feeds page 12 at a time: Posts, reels, and tagged posts return at most 12 items per page. Comments have a fixed page size of 15 and location feeds a fixed 21 — both are the platform’s own limits, not options.
02Search surfaces trending media, not everything: The search endpoint returns trending reels and videos matching a keyword, up to 24 per page. It is not a full-text index: a perfectly valid keyword can return nothing because nothing is currently trending for it.
03Highlights are a two-step read: The highlights endpoint returns the reels on a profile. The story items inside one come from the highlight endpoint, keyed by an id from that list.
04Posts are addressed by shortcode: A single post is fetched by its shortcode — the segment in its permalink — rather than by a numeric id.

Read the Instagram reference Make your first request

Other platforms

Build on Instagram data.

Get a free API key and call any of these endpoints in minutes. No credit card required.

Get free API key Instagram reference