Instagram creator and brand profiles, posts and Reels with engagement metrics, and post comments — plus finding someone's Instagram from their name or LinkedIn.
View API reference · Tag Instagram
We built Instagram coverage for creator and brand work: a public profile with its audience size, the posts and Reels an account is putting out, and the people commenting on a specific piece of content.
This is similar to what you see on instagram.com — a bio, a grid, a Reels tab, a comment thread, or a public Meta business profile — returned as fields instead of a browser tab.
Inputs and pagination
| Field | Used by | Accepts |
|---|---|---|
handle | profile, posts, Reels | The username on its own, without the @ or a URL |
postUrl | post details, post comments | A full post or Reel URL (https://www.instagram.com/p/DVoDVg5DkXM/) or just the shortcode (DVoDVg5DkXM) |
Posts, Reels, and comments return nextPageToken. Send it back in the
nextPageToken field on the next call; null means you have reached the end.
Profile and post details are single responses with no paging.
What you can call
| Operation | What it does | Returns |
|---|---|---|
instagramProfile | Look up an account by handle | Bio, follower / following / post counts, account type, and business category when the account has one |
instagramUserPosts | Walk an account's feed posts | Paginated posts with engagement metrics |
instagramUserReels | Walk an account's Reels | Paginated Reels with engagement metrics |
instagramPostDetails | Inspect one post or Reel | Caption, like count, and media URL |
instagramPostComments | Read who responded to a post | Paginated comments with author and engagement |
Example — POST /v1/instagram/profile:
{
"apiKey": "YOUR_API_KEY",
"handle": "nike"
}Finding someone's Instagram from their name or LinkedIn
The routes above all start from a handle you already have. When you start from
a person instead, use the social media lookup: pass a LinkedIn URL,
a LinkedIn user ID, or a name with context, and ask for
platforms: ["INSTAGRAM"].
| One person | A list | |
|---|---|---|
| Trigger | socialMediaLookupTrigger | socialMediaLookupBatchTrigger, up to 100 people |
| Poll | socialMediaLookupPolling | socialMediaLookupBatchPolling |
Both are background jobs — even the single-person one. Trigger, then poll or
take the social_media_lookup.completed
webhook. Full request shapes, status values, and
charging are on X (Twitter),
which uses the same operations with a different platforms value.
There is no Instagram-handle → LinkedIn direction. The bridge runs from a person to their Instagram, not the other way.
Using it effectively
Confirm the account before you spend on its content. Brand-adjacent
handles, regional accounts, and impersonators all look plausible in a search
result. One instagramProfile call tells you whether the follower count and
business category match the account you meant, and it is cheaper than paging
the wrong grid.
Reels and feed posts are separate calls. An account that looks quiet on
instagramUserPosts may be publishing constantly to Reels. If you are
judging whether a creator is active, check both.
Comments are a better audience than a follower count. Someone who wrote
under a launch post has demonstrated interest; a follower has demonstrated a
tap. instagramPostComments on two or three relevant posts gives you a
warmer, smaller list than any aggregate number.
Every page is billed. Feed, Reels, and comments are all per-page charges.
Set a page cap in your job rather than looping until nextPageToken is null
on a large account.
Use cases
Build a shortlist of creators in a niche. Start from handles you already
have — from a hashtag sweep on TikTok, a client list, or a
competitor's tagged posts. Call instagramProfile on each for follower count
and category, drop anyone below your threshold, then call
instagramUserReels on the survivors and compare recent engagement against
follower count. A creator with 30k followers and strong Reel engagement is
usually a better partner than one with 300k and none.
Collect a competitor's launch audience. Find the launch post, call
instagramPostDetails on its postUrl to confirm you have the right one and
see the like count, then page instagramPostComments. Those commenters were
paying attention to a product like yours on the day it shipped.
Vet an influencer before you pay them. Call instagramProfile for the
headline numbers, then instagramUserPosts and read the engagement metrics
across recent posts. Consistent engagement that scales with the follower count
is the signal; a large following with flat engagement is the warning.
Enrich a creator you decided to work with. If you can find them on LinkedIn, Contact Reveal gets you a work email. Going the other way, from LinkedIn to Instagram, is the social media lookup above.
Credits
Every Instagram call costs 2 credits — per request on profile and post
details, per page of results on posts, Reels, and comments. Each route allows
300 requests per minute. Person → Instagram lookup is charged separately
at 3 credits per platform searched, and you are charged for the search
even when it finds nothing. chargeInfo on the response is authoritative —
see Billing.
Related: Social media APIs · TikTok · X (Twitter)