🏷️ Instagram Tagged Posts

Every post that tags a given account — with the posting account on every row.

✨ What you get

One dataset row per tagged post:

Field	What it is
postShortcode / url	the post that does the tagging
postedBy / postedByUserId	the account that tagged you — the reason to run this Actor
subjectAccount	which of your accounts got tagged
likeCount / commentCount	how well that post performed
caption / takenAt / isVideo	content and timing
displayUrl	cover image

The run summary adds, per subject account: posts collected, the account's own reported tag total, whether more pages exist, how many unique accounts tagged it, median likes, and a top-5 poster ranking (posts + likes per tagging account).

💼 Use cases

• Turning taggers into your UGC shortlist — every row carries postedBy and postedByUserId, so the dataset is a mention list, not just a post list. Sort by poster and the summary's top-5 ranking gives you accounts tagging you repeatedly, ranked by posts and likes.
• Rewarding the creators already working for you — an account tagged 5 times with 14,035 likes on one post is a partner who has already proven the placement works. That is a renewal conversation with evidence in it.
• Measuring a brand partnership's footprint — put your own handle in the input list and the unique-account count plus median likes tell you how many distinct creators picked you up, and how well those placements performed.
• Watching a tagged-post spike after a campaign — run the Actor on a schedule and diff postedBy. A burst of new posters after a launch is the clearest signal that a placement landed.

✅ Who this is for

• Social and community managers— whose brand gets tagged constantly and who need to find the accounts doing it most, rather than scrolling the tagged tab.
• Partnerships and BD teams— turning organic taggers into a renewal or paid roster with per-post engagement already attached.
• UGC programmes— identifying creators who have already produced content for you, which is the cheapest place to start a paid relationship.
• Agencies managing several brand accounts— who can put up to 30 handles in one run and get a separate poster ranking per subject.

❌ Who this is NOT for

• Caption mentions only — this includes every post that tags the account, including tags inside the photo itself. If you only want caption mentions, filter the caption column for your handle after export.
• Accounts that have never been tagged, and private accounts — both produce nothing and are listed in warnings. No rows is not a bug in your filter.
• Taking the reported tag total literally — that counter is Instagram's own approximation and it is possible to collect 25 rows against a reported "of 21". Read it as indicative, and treat hasMorePages as the real signal that history remains.
• A full tag archive — history depth is capped at maxPostsPerSubject (1–200, default 42), following Instagram's roughly 21-post pages. An account tagged 2,000 times will never be fully in the dataset.
• A brand-mention monitoring tool across the web, or another platform — this reads Instagram's tagged-posts endpoint for Instagram accounts only. It is not a listening tool for X, TikTok, YouTube or Google Business reviews, and it carries no sentiment or share-of-voice metric.

🚀 Quick start

1. Open the Actor and press Start (defaults to instagram, 42 posts).
2. Put your own handle in the list — the poster ranking in the summary is your UGC/creator shortlist.
3. Raise maxPostsPerSubject to walk further back; the Actor pages through Instagram's cursor.

📥 Input parameters

Parameter	Type	Default	What it does
usernames	list	instagram	Accounts to look up tagged posts for. Handles, profile URLs and numeric ids, up to 30 per run.
maxPostsPerSubject	number	42	1–200 tagged posts per account. Instagram returns about 21 per page and this Actor follows the cursor through them. Cost scales linearly with posts × accounts.

📤 Output

• Dataset — one row per tagged post (or a notice when nothing was collected)
• SUMMARY — per-account poster rankings, request counts and warnings

Example item

{
  "postShortcode": "BrGHMHIF8Kz",
  "subjectAccount": "natgeo",
  "postedBy": "hynecheck",
  "postedByUserId": "99",
  "caption": "Vardzia cave monastery",
  "likeCount": 14035,
  "commentCount": 582,
  "isVideo": false,
  "takenAt": 1544205867,
  "displayUrl": "https://scontent.cdninstagram.com/…",
  "url": "https://www.instagram.com/p/BrGHMHIF8Kz/",
  "collectedAt": "2026-10-04T08:30:00.000Z"
}

⚙️ How it works

1. Each input is resolved to a numeric id (handles and URLs go through a profile lookup).
2. Tagged posts are paged through Instagram's own cursor until the cap or the end of the history.
3. Every row keeps the posting account, so the output is a mention list, not just a post list.
4. The summary aggregates by poster, which is the actionable view.

💰 Billing

Pay per result — you are charged for the tagged-post rows this Actor actually returns, not for the run. Accounts with no tags are not charged. Cost scales linearly with posts × accounts. There is no daily run cap.

❓ FAQ

Does this include posts where my account is tagged in the photo? Yes — that is exactly what "tagged posts" means on Instagram. If you want only caption mentions, filter the caption column for your handle after export.

How deep does the history go? As deep as you allow: Instagram pages about 21 posts at a time and this Actor follows the cursor up to your cap (200 posts per account).

The summary says "of 21" — what is that? The number of tagged posts the account itself reports. If you collected 25 of 21, the counter is Instagram's own approximation; treat it as indicative.

Nothing was collected for my account. Why? Either the account has never been tagged, or it is private. Both cases are listed in warnings.

How do I find who tagged me most usefully? Sort the dataset by postedBy and check the run summary's top posters — accounts tagging you repeatedly with good engagement are your most promising UGC or partnership candidates.

📚 Resources

• Instagram tagged-posts endpoints (no login required)
• Apify free plan: monthly credit covers usage, no separate daily cap