Instagram Post Info
Instagram Post Info records describe individual public posts, Reels, or legacy IGTV items through captions, author identity, media references, publication time, visible engagement, and source product type. These fields support known-URL enrichment, content cataloging, engagement snapshots, and format comparison.
Features
- Direct content URL lookupResolve known public Instagram /p/, /reel/, and /tv/ URLs without running profile collection or discovery.
- Caption and author contextReturn public caption text with the available author ID, username, display name, and avatar reference.
- Media and engagement detailsNormalize public image or video references alongside visible like, comment, view, and play counts.
- Traceable normalized recordsPreserve the submitted URL and available source product type with each standardized post record.
Parameters
| Parameters | Required | Description |
|---|---|---|
urls | Required | Required Instagram content URLs separated by commas or new lines. Accepted hosts are instagram.com and www.instagram.com; paths must start with /p/, /reel/, or /tv/. |
How to Use
Submit public content URLs as an asynchronous task, poll its task ID, then read normalized records with cursor pagination.
- Prepare one or more public instagram.com URLs whose path starts with /p/, /reel/, or /tv/ and includes a content shortcode.
- POST urls to /v1/instagram/post-info.
- Poll /v1/tasks/{task_id} until the status is succeeded or failed.
- Read data.results.items from /v1/tasks/{task_id}?limit=50 and follow results.next_cursor while results.has_more is true.
curl -X POST "https://api.socq.ai/v1/instagram/post-info" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"urls\":[\"$INSTAGRAM_POST_URL\"]}"
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.items.Best Use Cases
- Known-post enrichment: Add caption, author, media, publication time, and visible engagement fields to a stored list of Instagram content URLs.
- Content catalog normalization: Convert mixed post, Reel, and legacy IGTV links into consistent records with stable identity and source context.
- Public engagement snapshots: Capture the visible like, comment, view, and play counters returned for selected content at collection time.
- Content format review: Use media fields and source product type to compare the available metadata for known feed, Reel, and legacy IGTV items.
Pro Tips
- Include a real shortcode after /p/, /reel/, or /tv/ because a prefix-only path can pass the shape check yet return no record.
- Keep extra.input_url when matching a multi-URL task back to its inputs; duplicate URLs are collapsed and each unique URL produces at most one record.
- Handle fewer records than submitted URLs and treat author, metric, media, time, and product-type fields as optional when content is unavailable or not publicly exposed.
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 Tagged Posts API — Collect public posts that tag selected profiles with authors, media, mentions, tagged-user context, and 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 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.