# Instagram Post Likers API (https://www.socialcrawl.dev/platforms/instagram/post-likers)

> Returns a sample of the accounts that liked an Instagram post. Each liker includes username, display name, avatar URL, verification status, and profile URL, alongside the post's total like count in `total`. Instagram exposes only a ranked sample of likers (roughly the first 100) — the endpoint does not paginate, and `total` reflects the full like count rather than the number of retrievable likers.

TL;DR: `GET /v1/instagram/post/likers` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | URL of the Instagram post (a /p/ or /reel/ link). |
| `safe_url` | no | When true, returns URL-safe profile picture links suitable for embedding. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/instagram/post/likers?url=https%3A%2F%2Fwww.instagram.com%2Fp%2FCnpPou9hWqq%2F" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get the list of accounts that liked an Instagram post?

Send a GET request to /v1/instagram/post/likers with the url of the post. SocialCrawl returns a paginated JSON array of accounts that liked it plus the total like count for the post.

### What parameter does the post likers endpoint require?

It requires url, the link to a post (a /p/, /reel/, or /tv/ URL). Optionally pass safe_url to receive proxied, CDN-safe avatar URLs, and cursor to page through likers.

### How do I paginate through all the likers?

The response includes a cursor. Send it back as the cursor parameter on the next request to get the next page of likers, repeating until the cursor is empty.

### How much does the post likers API cost?

Each request costs 5 credits on the advanced tier and returns one page of likers with the total like count. New accounts get 100 free credits, no card needed.

### What can I do with post liker data?

Liker lists reveal engaged audiences: identify who actually interacts with a campaign, vet an influencer's engagement authenticity, or build warm lead lists from a viral post.

See the full Instagram API: https://www.socialcrawl.dev/platforms/instagram

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to get the list of accounts that liked an Instagram post via API
- API to pull post likers and total like count from Instagram