GETPosts2 credits

Get likers

GET https://api.instagramapi.dev/v1/post/likers

Returns accounts that liked the post. Availability depends on the post's privacy and size.

Build this with an AI agent

Paste this prompt into Claude, Codex, or any coding agent.

Parameters

Name	Type	Required	Description
post	string	yes	An Instagram post/reel. Accepts a media id, a shortcode (`C1a2b3c4d5e`), or a full post/reel URL. We resolve it automatically.

Example request

curl "https://api.instagramapi.dev/v1/post/likers?post=https%3A%2F%2Fwww.instagram.com%2Fp%2FC1a2b3c4d5e%2F" \
  -H "Authorization: Bearer $INSTAGRAMAPI_KEY"

const res = await fetch("https://api.instagramapi.dev/v1/post/likers?post=https%3A%2F%2Fwww.instagram.com%2Fp%2FC1a2b3c4d5e%2F", {
  headers: { Authorization: `Bearer ${process.env.INSTAGRAMAPI_KEY}` },
});

res = requests.get("https://api.instagramapi.dev/v1/post/likers?post=https%3A%2F%2Fwww.instagram.com%2Fp%2FC1a2b3c4d5e%2F",
    headers={"Authorization": f"Bearer {INSTAGRAMAPI_KEY}"})

Try it

Live request · uses 2 credits

API key

post *string

Example responses

Switch tabs to see the body shape for success and each error status.

{
  "data": {
    "items": [
      {
        "id": "13460080",
        "username": "nike",
        "full_name": "Nike",
        "is_verified": true,
        "is_private": false,
        "profile_pic_url": "https://instagram.com/.../nike.jpg"
      },
      {
        "id": "51049513",
        "username": "nikebasketball",
        "full_name": "Nike Basketball",
        "is_verified": true,
        "is_private": false,
        "profile_pic_url": "https://instagram.com/.../nike.jpg"
      }
    ],
    "next_cursor": null
  },
  "meta": {
    "endpoint": "post/likers",
    "request_id": "req_3f8a1c9e",
    "credits_charged": 2,
    "credits_remaining": 4987,
    "ms": 412
  }
}

{
  "error": {
    "code": "missing_parameter",
    "message": "Missing required parameter \"post\".",
    "docs": "/docs/post/likers"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "This API key is invalid or has been revoked.",
    "docs": "/docs#authentication"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

{
  "error": {
    "code": "insufficient_credits",
    "message": "You're out of credits. Top up to continue.",
    "docs": "/dashboard/billing"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "No public data for that request (private, deleted, or nonexistent). This is a billed request. We queried Instagram on your behalf.",
    "docs": "/docs/post/likers"
  },
  "meta": {
    "request_id": "req_3f8a1c9e",
    "endpoint": "post/likers",
    "credits_charged": 2,
    "credits_remaining": 4985
  }
}

{
  "error": {
    "code": "upstream_error",
    "message": "Upstream data provider error. You were not charged. Please retry.",
    "docs": "/docs/post/likers"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

Response fields

Fields returned under data on a 200 response. Every response also includes a meta object with billing info.

Field	Type	Description
items	array<object>	Accounts that liked the post.
items[].id	string	Numeric account id (stable even if the username changes).
items[].username	string	The account's @handle.
items[].full_name	string	Display name shown on the profile (may be empty).
items[].is_verified	boolean	Whether the account has a verified badge.
items[].is_private	boolean	Whether the account is private.
items[].profile_pic_url	string	URL of the account's profile picture.
next_cursor	null	Always null. This endpoint returns a single page and isn't paginated.