Instagram Post likers API

Get the accounts that liked a post or Reel from its url: each row has username, rank, is_verified and is_private, for $1.32 per 1,000 calls.

  • rank gives each account's place in the likes list
  • post_like_count is the total likes on the post
  • Page with page_token; each page is one call

API health

24h health
Normal
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Normal

Last 24 hours

Last 30 days

  1. 1Request

    POST /api/v1/social
    {
      "platform": "instagram",
      "action": "likers",
      "params": {
        "url": "https://www.instagram.com/p/DbYmqpplO_N/"
      }
    }
  2. 2JSON response

    {
      "results": [
        {
          "username": string,
          "name": string,
          "is_private": boolean,
          "is_verified": boolean
        },
        …
      ]
    }
  3. 3Rows

    usernamenameis_privateis_verified
    stringstringbooleanboolean
  4. 4CSV

    instagram-likers-sample.csv id,username,url,name,avatar_url,is_private,is_verified,rank,platform,category,is_business,business_email,business_phone,avatar_hd_url,highlight_count,has_reels,reels_count,social_context,emails,phones,external_urls,post_url,post_like_count,likes_hidden

A request with the post link in url returns one page of liking accounts and a next_page_token. Each account is a row with username, rank and more, ready as a field table or a CSV.

What data you get

Each row is one account that liked the post. The table lists the fields each row returns, with their types and meanings, and shows no values.

FieldTypeMeaning
idstringThe record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms.
usernamestringUsername (@handle).
urlstringLink to the record on the platform.
namestringName of the object itself, for account, product and business capabilities.
avatar_urlstringAvatar image link. Some platforms return sized CDN links that can expire.
is_privatebooleanWhether the account is private.
is_verifiedbooleanWhether the platform verified the account. null means it cannot be determined.
ranknumberPosition from 1: the order of this row within this result. user_search: first the accounts returned by Instagram's search box (matched_by is search_box), in the search box's order; then the authors of posts found with this keyword, added to fill up the count (matched_by is post_author); results without matched_by carry the position at which Instagram ranks the account for this keyword. similar_profiles: the account's place among the similar accounts, ordered by followers. likers: the account's place in the list of likers.
platformstringSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).
categorystringCategory name in the platform's own taxonomy, not normalized across platforms.
is_businessbooleanWhether the account is a business account.
business_email—Email the business account makes public behind the Contact button on its profile. Absent when there is none.
business_phone—Phone number the business account makes public behind the Contact button on its profile. Absent when there is none.
avatar_hd_urlstringHigh-resolution avatar URL (avatar_url is the small image).
highlight_countnumberNumber of Highlights.
has_reelsbooleanWhether the account has posted Reels.
reels_countnumberNumber of Reels the account has posted (integer).
social_contextstringThe line of text Instagram shows under the account, such as Followed by a certain user or 632 followers; returned as is (mostly in English). Absent when there is none.
emails—Contact email addresses (a record can have several), passed through as is with duplicates removed.
phones—Phone numbers the person wrote publicly in the bio, as an array. Only numbers that start with + or 00, or that follow a label such as WhatsApp or Phone, are included. Absent when there are none.
external_urlsarrayAll external links in the bio: url, title (external_url is only the first one).
post_urlstringPost link.
post_like_count—(likers) Total likes on the post, the same on every row. likes_hidden is true when the author hid the like count.
likes_hiddenbooleanThe author hid the like count. Appears only when hidden, with the value true; like_count is usually absent then.

Use cases

  • See who liked a post

    Read username, is_verified and is_private to see whether verified or private accounts liked it.

  • Compare with the total

    Each row carries post_like_count, the total likes on the post. Compare it with the number of accounts you received to see how much of the list you have.

  • Find business accounts

    Keep the rows where is_business is true to see which business accounts liked the post.

  • Spot hidden likes

    likes_hidden is true on the row when the author hides the like count. Such a post can also return an empty result.

Instagram Graph API vs EveryInfra

Instagram's Graph API and EveryInfra likers, compared on access.

ComparedInstagram Graph APIEveryInfra
Access you needAccess token: "Required. App user’s User access token."One EveryInfra API key in the Authorization: Bearer header. No Instagram login or Instagram access token is needed.

Quote is from Meta's developer documentation (the IG User page), checked 2026-11-22. This row compares access only. Official sources: IG User (updated 2026-04-22)

Limits and gotchas

  • url is required: the link to a post or Reel (/p/ or /reel/ form).
  • The likes list that Instagram's web page gives is capped, so you cannot get every account that liked. For the exact total, use post_like_count.
  • The page size varies. A short page does not mean the end; the last page is the one with no next_page_token.
  • To page, pass next_page_token back as page_token exactly as received, with the other parameters the same as on the first page. A token is valid for 24 hours, and each page counts as one call.
  • A post whose author hides the like count can return an empty result. When rows come back, likes_hidden is true on them.

Pricing

Each call costs $0.001319, whatever the number of rows, and each page you read counts as one call. Failed calls and empty results are not charged.

CallsCost
10,000$13.19
100,000$131.94
1,000,000$1,319.44

Totals use the list price per call.

Code samples

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "instagram",
  "action": "likers",
  "params": {
    "url": "https://www.instagram.com/p/DbYmqpplO_N/"
  }
}'

OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

API reference

See the parameters, response fields, errors and billing for likers, and copy the page or open it as Markdown for an AI assistant.

POST

AI prompt

#
Please help me write a data collection script with the EveryInfra Instagram Post likers endpoint (instagram/likers).

How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to instagram and action to likers, and put the parameters inside params.
- Required parameters:
  - url: Specifies a single Instagram post or Reel URL for the comments and likers actions. Profile URLs are not supported. For the reels action, passing a URL does not replace the required username parameter.
- Optional parameters:
  - page_token: Page token for user_posts, tagged_posts, comments, followers_list, user_search, similar_profiles, comment_replies, likers, location_posts, audio_posts and explore. Leave it out for the first page.
- Returns a list of records. Main fields of each record: id, username, url, name, avatar_url, is_private (Whether the account is private), is_verified, rank (Position from 1: the order of this row…), category, is_business (Whether the account is a business accou…), business_email (Email the business account makes public…), business_phone (Phone number the business account makes…); 23 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=instagram.
- Example request body:
{
  "platform": "instagram",
  "action": "likers",
  "params": {
    "url": "https://www.instagram.com/p/DbYmqpplO_N/"
  }
}
- Price: $1.32 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.

Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.

Request parameters

#
NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYesinstagramPlatform identifier, fixed value.
actionbodystringYeslikersCapability identifier, fixed value.
urlbody.paramsstringYes-Specifies a single Instagram post or Reel URL for the comments and likers actions. Profile URLs are not supported. For the reels action, passing a URL does not replace the required username parameter. For the comments action, if the post does not exist or cannot be viewed (deleted, or from a private account), the call returns 200 with an empty result and empty_reason set to post_unavailable. It is not charged, and retrying the same URL does not change the result; a repeat for the same URL within 24 hours returns the same result, also free.
page_tokenbody.paramsstringNo-Page token for user_posts, tagged_posts, comments, followers_list, user_search, similar_profiles, comment_replies, likers, location_posts, audio_posts and explore. Leave it out for the first page; pass back the next_page_token exactly as received, other parameters unchanged (except limit, if present). Each page is one call; tokens last 24 hours. No next_page_token means no more pages: pagination.stop_reason is end_of_list at the end, or depth_limit if this run cannot go deeper; data may remain.

Response example

#
No sample response is available for these parameters yet. This preview shows the response shape and fields from the API definition, with … as placeholders; it is not the result of a live call.
json
{  "id": "req_…",  "platform": "instagram",  "action": "likers",  "results": [    {      "id": …,      "username": …,      "url": …,      "name": …,      "avatar_url": …,      "is_private": …,      "is_verified": …,      "rank": …,      "platform": …,      "category": …,      "is_business": …,      "business_email": …,      "business_phone": …,      "avatar_hd_url": …,      "highlight_count": …,      "has_reels": …,      "reels_count": …,      "social_context": …,      "emails": …,      "phones": …,      "external_urls": …,      "post_url": …,      "post_like_count": …,      "likes_hidden": …    }  ],  "next_page_token": …,  "pagination": { … },  "count": …,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Response fields

#

Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.

FieldMeaning
idThe record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms.
usernameUsername (@handle).
urlLink to the record on the platform.
nameName of the object itself, for account, product and business capabilities.
avatar_urlAvatar image link. Some platforms return sized CDN links that can expire.
is_privateWhether the account is private.
is_verifiedWhether the platform verified the account. null means it cannot be determined.
rankPosition from 1: the order of this row within this result. user_search: first the accounts returned by Instagram's search box (matched_by is search_box), in the search box's order; then the authors of posts found with this keyword, added to fill up the count (matched_by is post_author); results without matched_by carry the position at which Instagram ranks the account for this keyword. similar_profiles: the account's place among the similar accounts, ordered by followers. likers: the account's place in the list of likers.
platformSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).
categoryCategory name in the platform's own taxonomy, not normalized across platforms.
is_businessWhether the account is a business account.
business_emailEmail the business account makes public behind the Contact button on its profile. Absent when there is none.
business_phonePhone number the business account makes public behind the Contact button on its profile. Absent when there is none.
avatar_hd_urlHigh-resolution avatar URL (avatar_url is the small image).
highlight_countNumber of Highlights.
has_reelsWhether the account has posted Reels.
reels_countNumber of Reels the account has posted (integer).
social_contextThe line of text Instagram shows under the account, such as Followed by a certain user or 632 followers; returned as is (mostly in English). Absent when there is none.
emailsContact email addresses (a record can have several), passed through as is with duplicates removed.
phonesPhone numbers the person wrote publicly in the bio, as an array. Only numbers that start with + or 00, or that follow a label such as WhatsApp or Phone, are included. Absent when there are none.
external_urlsAll external links in the bio: url, title (external_url is only the first one).
post_urlPost link.
post_like_count(likers) Total likes on the post, the same on every row. likes_hidden is true when the author hid the like count.
likes_hiddenThe author hid the like count. Appears only when hidden, with the value true; like_count is usually absent then.

Errors and billing

#
401
Missing or invalid key.
402
Insufficient balance. Top up first.
422
Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
429
Per-minute request limit reached. Wait for Retry-After, then try again.
503
Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
200 empty
No data. No charge.

Errors

FAQ

What does the Instagram likers API return?

It returns the accounts that liked one post or Reel, one row each: id, username, url, name, avatar_url, is_private, is_verified, rank, post_like_count, likes_hidden and more.

Can I get every account that liked a post?

Not always. The list that Instagram's web page gives is capped, and the page size varies. When a response has no next_page_token, there is no next page. For the total, use post_like_count.

How much does the likers endpoint cost?

Billing is per call: $0.001319 each, or $1.32 per 1,000 calls, not per row. Each page counts as one call. Failed calls and empty results are not charged.

Do I need to log in to Instagram to read likers?

No. Put your EveryInfra API key in the Authorization: Bearer header. You need no Instagram login and no Instagram access token.

How do likers and followers_list differ?

likers reads the accounts that liked one post; its input is the post url. followers_list reads the accounts that follow one account; its input is username.

The same EveryInfra API key also calls Instagram's other endpoints, such as comments for the comments on the same post.

Google Analytics needs consent. Privacy