# Instagram Likes Scraper (`toolzerhub/instagram-likes-scraper`) Actor

Get the accounts that liked any public Instagram post or reel. One row per liker with username, display name, verification status and private-account flag. No Instagram login needed.

- **URL**: https://apify.com/toolzerhub/instagram-likes-scraper.md
- **Developed by:** [ToolzerHub](https://apify.com/toolzerhub) (community)
- **Categories:** Social media, Lead generation, Automation
- **Stats:** 7 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.02 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Instagram Likes Scraper — Who Liked a Post

Paste one or more Instagram post or reel URLs. Get back the accounts that liked them, one row per liker.

No login, no cookie, no session.

### Input

| Field | Type | Default | What it does |
|---|---|---|---|
| `codes` | array | — | **Required.** Full post/reel URLs, shortcodes, or numeric media IDs. |
| `limit` | integer | `0` | Caps rows across the whole run. `0` means no cap. |

```json
{
  "codes": ["https://www.instagram.com/p/DbL6n0ggXDZ/"],
  "limit": 0
}
```

`codes` accepts a full post or reel URL, a shortcode, or a numeric media ID.

**Instagram does not publish a pageable liker list.** The endpoint behind this Actor takes a post and returns one batch of likers — there is no cursor, no page token, and no way to ask for more. So on a post with 200,000 likes you get the batch Instagram returns, not 200,000 rows.

That is a limit of what Instagram exposes publicly, not a setting. If you need the full audience of an account rather than of a post, use the **Instagram Followers Scraper** instead — follower lists do page.

Comments are different: they page properly, and the **Instagram Comments Scraper** walks all of them.

### Output

One row per liker.

| Field | What it holds |
|---|---|
| `username` | The account that liked the post |
| `full_name` | Display name |
| `is_verified` | Whether it's verified |
| `is_private` | Whether it's private |
| `profile_pic_url` | Profile picture |
| `id` | Instagram's numeric account ID |
| `source_code` | Which post the like was on |

```json
{
  "username": "liker",
  "full_name": "A Liker",
  "is_verified": false,
  "is_private": true,
  "profile_pic_url": "https://...",
  "id": "9",
  "source_code": "DbL6n0ggXDZ"
}
```

### What this costs

One request per post, and one billed row per liker returned. `limit` caps the rows across the whole run; `0` means no cap.

### Questions

**Why did I get far fewer likers than the post's like count?**
Because Instagram only exposes a batch of them publicly. See the note under Input — this is the endpoint's ceiling, not a setting you can raise.

**Can I page through the rest?**
No. There is no cursor to page with. Anything claiming otherwise on a public post is guessing.

**Does it work on private posts?**
No. The post has to be public.

**Do I need an Instagram login?**
No. Everything here is public data, fetched without a session.

### Other Instagram Actors

| Actor | Use when |
|---|---|
| [Instagram Comments Scraper](https://apify.com/toolzerhub/instagram-comments-scraper) | You want who commented, not who liked |
| [Instagram Media Engagement Scraper](https://apify.com/toolzerhub/instagram-media-engagement-scraper) | You want post info, comments and likers together |
| [Instagram Followers & Following](https://apify.com/toolzerhub/instagram-profile-follower-followee-scraper) | You want an account's full audience, not one post's likers |

### Support

Questions, bugs, or feature requests: **contact@toolzerhub.com**

Browse the rest: [apify.com/toolzerhub](https://apify.com/toolzerhub)

# Actor input Schema

## `codes` (type: `array`):

Instagram media shortcodes, numeric media IDs, or full post/reel URLs.

## `limit` (type: `integer`):

Stop after this many rows per account (0 = pull the whole list)

## Actor input object example

```json
{
  "codes": [
    "DDPp2UWzWEm"
  ],
  "limit": 100
}
```

# Actor output Schema

## `dataset` (type: `string`):

Every record collected during this run

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "codes": [
        "DDPp2UWzWEm"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("toolzerhub/instagram-likes-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "codes": ["DDPp2UWzWEm"] }

# Run the Actor and wait for it to finish
run = client.actor("toolzerhub/instagram-likes-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "codes": [
    "DDPp2UWzWEm"
  ]
}' |
apify call toolzerhub/instagram-likes-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,toolzerhub/instagram-likes-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/B9sm56guSRXluwJ5x/builds/BrT3KyrV8JKM2fBNe/openapi.json