Instagram Tagged Posts
Instagram Tagged Posts are public publications that identify another profile through post-level tags and can include mentioned usernames, with captions, authors, media, hashtags, timestamps, and visible engagement. These content and relationship signals support tag monitoring, attribution review, creator research, and structured content archives.
Features
- Profile-tag discoveryUse public Instagram usernames as targets and return posts that tag those profiles rather than posts authored by the target account.
- Post and author identityReceive post IDs, shortcodes, post URLs, captions, and normalized author profile fields for traceable content records.
- Tagged-user and mention contextKeep structured tagged_users context alongside hashtags and returned mentions so different post relationships remain distinguishable.
- Media and visible engagementReturn normalized image or video references with visible like, comment, view, and play counts supplied for each public post.
- Publication contextInclude normalized publication time, collection time, and product_type context for chronological review and post-format classification.
Parameters
| Parameters | Required | Description |
|---|---|---|
usernames | Required | One or more public Instagram profile usernames without @, separated by commas or new lines. |
results_limit | Optional | Maximum number of tagged-post records requested by the task; an integer from 1 to 2,000, defaulting to 100. |
How to Use
Submit target profile usernames as an asynchronous task, poll the returned task ID, then read normalized tagged posts with cursor pagination.
- Prepare one or more public Instagram usernames without the leading @ character.
- POST usernames and an optional results_limit from 1 to 2,000 to /v1/instagram/tagged-posts.
- Poll /v1/tasks/{task_id} until the status is succeeded or failed.
- Read /v1/tasks/{task_id}?limit=50 and pass results.next_cursor while results.has_more is true.
curl -X POST "https://api.socq.ai/v1/instagram/tagged-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["instagram"],"results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50 and follow data.results.next_cursorBest Use Cases
- Profile tag monitoring: Use tagged_users, post URLs, captions, authors, and timestamps to review public posts that tag selected profiles.
- Campaign association review: Compare captions, media, tagged-user context, and visible engagement across posts connected to a campaign profile tag.
- Creator contribution research: Use normalized author identity and profile-tag relationships to identify public creators publishing content around selected accounts.
- Tagged content archiving: Store post IDs, shortcodes, returned URLs, media references, publication times, and collection times in reviewable content records.
Pro Tips
- Remove the leading @ from each target username before submission so the request uses a clean profile identifier.
- Read extra.tagged_users for post-level profile tags and mentions for returned mention strings instead of treating the two fields as interchangeable.
- Deduplicate repeated collections with a post ID or shortcode, then retain the returned post URL for review and traceability.
- Allow media, engagement counters, author flags, and timestamps to be absent because normalized public records preserve nullable source fields.
- Continue with results.next_cursor whenever results.has_more is true so larger tagged-post result sets are not truncated after the first page.
Related APIs
Use these APIs when you need a different type of public Instagram data.
- Instagram Followers Count API — Retrieve public profile identity and visible follower, following, and post counts.
- Instagram Posts API — Collect public posts, media, hashtags, mentions, timestamps, and engagement by username.
- Instagram Reels API — Collect public Reels, media, audio, hashtags, mentions, and engagement by username.
- Instagram Search API — Search public profiles by keyword or handle with identity and visible account signals.
- Instagram Comments API — Collect public comments, authors, timestamps, likes, and replies from post URLs.
- Instagram Profiles API — Retrieve public profile identity, biographies, links, account flags, categories, and visible counts by username.
- Instagram Followers List API — Collect public follower profile records with source-account and relationship context.
- Instagram Following List API — Collect public profiles followed by Instagram accounts with identity, relationship context, and visible account counts.
- Instagram Hashtag Posts API — Discover public posts by hashtag with source-tag context, media, creators, timestamps, and visible engagement.
- Instagram Transcript API — Extract transcript text, language, format, source URLs, and shortcodes from public post or Reel URLs.
- Instagram Audio Reels API — Collect public Reels by known numeric audio ID with captions, creators, media, timestamps, visible engagement, and source-audio context.
- Instagram Highlight Items API — Retrieve saved public Story items from known highlight IDs with text, author identity, media, timestamps, visible metrics, and source context.
- Instagram Post Info API — Look up known public post, Reel, or legacy IGTV URLs with captions, author identity, media, timestamps, visible engagement, and input context.
- Instagram Reels Search API — Search public Reels by text query with captions, creators, media, timestamps, visible engagement, and query context.
- Instagram Story Highlights API — List public Story Highlight containers by username with titles, owner context, media counts, and reusable highlight IDs.
- Instagram Trending Reels API — Capture the current public Reel set from the trending feed with captions, creators, media, timestamps, and visible engagement.