Instagram Post Likers

Overview

List the accounts that liked an Instagram post, by post: a post URL (a /p/, /reel/ or /tv/ link, with or without the account handle in front), its shortcode or its numeric media id. Each liker comes back as a short profile: handle, display name, privacy and verification flags, and the profile URL. The list carries no email addresses, phone numbers or follower details beyond the short profile; call instagram_profile with a returned username for bio, website and public contact fields.

Note that Instagram itself shows only a sample of the likers of a post, not every like. The total number of likes stands in like_count of instagram_post; this endpoint lists the accounts Instagram delivers. A post given as a URL or a shortcode is resolved first (over the post cache shared with instagram_post); a numeric media id goes straight to the list and needs no lookup.

The answer is one page, there is no cursor. A fetched list is cached for 24 hours and shared across the platform. A second request for the same post within that window answers instantly and is charged the lower cached price.

When to use

Find profiles that react to your own posts: likers are warm contacts for a lead list.
See who engages with a competitor's or partner's post.

[!NOTE] A post that does not exist or was deleted completes with found: false, a post whose likers cannot be read (for example on a private account) with restricted: true, both not charged. A post without visible likers completes with count: 0, also at no charge. Genuine errors of the data service (auth, rate limit, 5xx) still fail the run and are refunded.

Endpoint

Input

Output

Pricing

This enrichment costs 2 credits for a freshly read liker list. A list served from the cache (at most 24 hours old) is charged the lower cached tier. Posts without visible likers and runs ending with found: false or restricted: true are free.

Examples

Playground

States

State	Description
`queued`	Request accepted; waiting to be picked up by a worker.
`processing`	Worker is actively running the enrichment.
`completed`	Enrichment finished and results are available in `output`.
`failed`	Enrichment failed; reason is in `error`. Credits are refunded for failures unless otherwise noted.

Errors

Error	When it happens	What to do
`invalid_input`	`post` is missing or is not an Instagram post link, shortcode or media id.	Pass a post URL like `https://www.instagram.com/p/DPxQ1AbCDeF/`, its shortcode or its numeric media id.
`not_found`	The lookup completed but the post does not exist or was deleted.	No action needed, the run costs nothing.
`restricted`	The likers of the post cannot be read.	No action needed, the run costs nothing.
`rate_limited`	The data service throttled the request.	Retry with backoff.
`provider_error`	The data service returned an unexpected error.	Retry; if persistent, contact support.
`503 endpoint_unavailable`	The endpoint is currently not configured or temporarily disabled. Nothing is reserved or charged.	Retry later; if persistent, contact support.