# Instagram Post likers API (instagram.likers)

- Canonical page: [https://everyinfra.com/en/instagram-api/likers](https://everyinfra.com/en/instagram-api/likers?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "instagram", "action": "likers", "params": {...}}
- Price: $0.001319 per call ($1.32 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, one page of up to 100 per call; the number of rows varies from page to page and a short page is not the end (limit is ignored; pass the top-level next_page_token from the response as page_token for the next page; no next_page_token means the end)
- Pagination: pass next_page_token back as page_token for the next page, other params unchanged; one call per page, tokens last 24 hours
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=instagram&action=likers

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| url | not declared | yes | not declared | 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_token | not declared | no | not declared | 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 fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| username | Username (@handle). |
| url | Link to the record on the platform. |
| name | Name of the object itself, for account, product and business capabilities. |
| avatar_url | Avatar image link. Some platforms return sized CDN links that can expire. |
| is_private | Whether the account is private. |
| is_verified | Whether the platform verified the account. null means it cannot be determined. |
| rank | Position 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. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
| category | Category name in the platform's own taxonomy, not normalized across platforms. |
| is_business | Whether 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_url | High-resolution avatar URL (avatar_url is the small image). |
| highlight_count | Number of Highlights. |
| has_reels | Whether the account has posted Reels. |
| reels_count | Number of Reels the account has posted (integer). |
| social_context | The 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_urls | All external links in the bio: url, title (external_url is only the first one). |
| post_url | Post 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_hidden | The author hid the like count. Appears only when hidden, with the value true; like_count is usually absent then. |

## Example

```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/"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "instagram",
        "action": "likers",
        "params": {
            "url": "https://www.instagram.com/p/DbYmqpplO_N/",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

No real sample for these example parameters yet: structure only, every value is a placeholder (…).

```text
{
  "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": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=instagram
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
