instagram/
post-likers

The Instagram Post Likers API collects the accounts in a public Instagram post's likers list from its URL, returning each liker's username, display name, avatar, and verified and private status.

Instagram Post Likers API

Post URL input
Likers list
Up to 1,000 accounts
0.3 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Instagram Post Likers

The likers list is the set of accounts Instagram shows when you tap a post's like count, a direct look at who engaged with a photo, reel, or video. Studying these accounts tells teams what audience a post really reached, which notable profiles were among the engagers, and how the crowd differs from one post or campaign to the next.

Instagram Post Likers API Features

  • Likers from a post linkPaste a post, reel, or IGTV URL and get the accounts Instagram lists as having liked it.
  • Profile basics for every likerEach liker comes with a user ID, username, display name, profile link, avatar, and verified and private flags inside related_actor.
  • Records labeled as likesEvery record carries relationship = liker, so likers sit next to follower and following data in the same pipeline without extra mapping.

Instagram Post Likers API Parameters

ParametersRequiredDescription
urlRequiredLink to the public post, reel, or IGTV video.
results_limitOptionalHow many likers to return, from 1 to 1000. Defaults to 100.

How to Use the Instagram Post Likers API

Paste a post link, run an Instagram Post Likers API task, and read the likers from the results.

  1. Copy the URL of a public post, reel, or IGTV video.
  2. POST the url and an optional results_limit to /v1/instagram/post-likers.
  3. Wait until GET /v1/tasks/{task_id} reports status succeeded.
  4. Read the likers from results.items, following results.next_cursor while results.has_more is true.
curl -X POST "https://api.socq.ai/v1/instagram/post-likers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.instagram.com/p/DRhvwVLAHAG/","results_limit":100}'

# Each result is one liker, with the account details in related_actor.
# Read them from GET /v1/tasks/{task_id}.

Instagram Post Likers API Use Cases

  • Campaign audience review: Run the Instagram Post Likers API on a sponsored post to see what kinds of accounts it actually reached.
  • Finding repeat fans: Collect likers across several posts and match their user IDs to find the people who come back to like again and again.
  • Spotting notable engagers: Filter likers by is_verified to surface creators, brands, and public figures who liked a post.

Instagram Post Likers API Pro Tips

  • Match likers across posts by related_actor.id, which stays the same even when someone changes their username.
  • Take the post's total like count from Instagram Post Info, and treat the likers list as the accounts Instagram chooses to display.
  • Send liker usernames to Instagram Profiles when you want follower counts and bios to go with them.

Beyond the Instagram Post Likers API, use these APIs when you need a different type of public Instagram data.

  • Instagram Followers Count API — Retrieve public profile identity and visible follower, following, and post counts.
  • Instagram Comments API — Collect public comments, authors, timestamps, likes, and replies from post URLs.
  • Instagram Profiles API — Retrieve public profile identity, biographies, links, account flags, categories, and visible counts by username.
  • Instagram Followers List API — Collect public follower profile records with source-account and relationship context.
  • Instagram Following List API — Collect public profiles followed by Instagram accounts with identity, relationship context, and visible account counts.
  • Instagram Post Info API — Look up known public post, Reel, or legacy IGTV URLs with captions, author identity, media, timestamps, visible engagement, and input context.

Explore other platforms

Combine Instagram data with public data from other supported social platforms.

Instagram Post Likers API — FAQ

Instagram Post Likers API is a programmatic interface for collecting accounts from the likers list of a public Instagram post, reel, or IGTV video, using its URL as input. It returns each liker's user ID, username, display name, profile link, avatar, and verified and private flags.

Yes. Send the post URL and the task returns the accounts in its likers list, each with a username, display name, and avatar.

Yes. Any public post, reel, or IGTV link is accepted, including links that put the account name before /p/ or /reel/.

Under related_actor.username, and the record's url field links straight to the liker's profile.

The Instagram Post Likers API charges 0.3 credits for every liker returned.