Instagram Audio Reels
Instagram audio Reels are public short-form videos associated with a shared audio identifier, with captions, creator identity, media references, timestamps, and visible engagement. Their source-linked records support participation review, creative research, and comparison of public Reel activity across audio IDs.
Features
- Known audio ID targetingSubmit one or more numeric Instagram audio IDs to collect public Reels associated with those exact identifiers rather than searching by title or artist.
- Independent per-audio collectionProcess every audio ID with its own results_limit, cursor sequence, and within-input record de-duplication so each source has a bounded collection.
- Source-linked Reel recordsReceive normalized Reel IDs, URLs, captions, creator identity, media, timestamps, visible engagement, and extra.audio_id provenance.
Parameters
| Parameters | Required | Description |
|---|---|---|
audio_ids | Required | One or more known Instagram audio IDs as non-empty numeric strings, separated by commas or new lines. |
results_limit | Optional | Maximum records requested for each audio ID; defaults to 100 and accepts integers from 20 through 2,000. |
How to Use
Submit known audio IDs as an asynchronous task, poll its task ID, then read normalized Reel records with cursor pagination.
- Prepare one or more known Instagram audio IDs as non-empty numeric strings.
- POST audio_ids with an optional per-audio results_limit to /v1/instagram/audio-reels.
- Poll /v1/tasks/{task_id} until the status is succeeded or failed.
- Read /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/audio-reels" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"audio_ids":["123456789012345"],"results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueBest Use Cases
- Audio participation review: Group public Reel URLs, captions, creators, and timestamps by extra.audio_id to review visible participation around known audio.
- Creative example research: Build a source-linked review set from captions, creator identity, media references, and original Reel URLs associated with selected audio IDs.
- Visible engagement comparison: Compare available likes, comments, views, and plays across collected Reels while retaining the audio ID that produced each record.
Pro Tips
- Resolve and verify audio IDs before submitting them; this endpoint accepts numeric identifiers and does not search for audio by song title, artist, or keyword.
- Plan volume and estimated credits per audio ID because results_limit is applied independently to every submitted identifier.
- When combining repeated collections, de-duplicate by stable Reel ID or canonical URL while keeping extra.audio_id for source attribution.
- Treat counters, media, creator fields, and timestamps as optional, and interpret collection as bounded by the per-audio limit, feed end, or 100-page ceiling rather than a complete historical archive.
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 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.