# Instagram Reels using a music track API (instagram.audio_posts)

- Canonical page: [https://everyinfra.com/en/instagram-api/audio_posts](https://everyinfra.com/en/instagram-api/audio_posts?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "instagram", "action": "audio_posts", "params": {...}}
- Price: $0.000556 per call ($0.56 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, one page of 12 per call (limit is ignored; pass the top-level next_page_token from the response as page_token for the next page)
- Pagination: pass next_page_token back as page_token for the next page, other params unchanged; one call per page, tokens last 24 hours
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=instagram&action=audio_posts

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| audio_id | not declared | yes | not declared | The music for `audio_posts`: the `audio_id` in a post's or Reel's `music`, or an audio page link such as `https://www.instagram.com/reels/audio/<number>/`. Returns the Reels that use that music. Pass the ID as a string. A value that cannot be read is rejected before any charge. |
| page_token | not declared | no | not declared | Page token for `user_posts`, `tagged_posts`, `comments`, `followers_list`, `user_search`, `similar_profiles`, `comment_replies`, `likers`, `location_posts`, `audio_posts` and `explore`. Leave it out for the first page; pass back the `next_page_token` exactly as received, other parameters unchanged (except `limit`, if present). Each page is one call; tokens last 24 hours. No `next_page_token` means no more pages: `pagination.stop_reason` is `end_of_list` at the end, or `depth_limit` if this run cannot go deeper; data may remain. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| post_id | Post shortcode: the part of the link after /p/ or /reel/ (not a numeric ID). |
| url | Link to the record on the platform. |
| text | Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so). |
| media_type | Only two values: video (videos; Reels are also video) and image (images; carousel posts are also recorded as image, and when product_type is present, a product_type of carousel_container marks a carousel). |
| like_count | Likes. null means the platform or this capability does not disclose it; it is not 0. |
| comment_count | Comments. null means not disclosed, not 0. |
| view_count | Views or plays. null means not disclosed, not 0. |
| author_username | Author's username (@handle), usually usable in URLs. |
| author_name | Author's display name. |
| posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
| location | Location description passed through as is; the format varies by platform. |
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| image_url | Image link. Capabilities with several images may return an image_urls array. |
| video_url | Video file URL: the complete mp4 with sound, playable directly. For a carousel post with videos, it is the first video; absent when the post is not a video. The link is signed and expires; when video_url_expires_at is present, go by it. |
| author_id | Author's unique ID on the platform. |
| width | Width of the original image or video, in pixels. |
| height | Height of the original image or video, in pixels. |
| is_comments_disabled | Whether comments are turned off on the post. |
| author_follower_count | Author's follower count. null means not disclosed. |
| hashtags | Hashtags in the text, in order of appearance; absent when there are none. |
| top_comments | A few comments shown under the post; each entry has the text (text) and the commenter (author_username). Absent when there are none. |
| product_type | Content format as Instagram classifies it: feed (regular post), clips (Reels), carousel_container (carousel), longform (long video). |
| play_count | Play count. |
| fb_play_count | Play count on Facebook, when the author also published this post on Facebook; appears only on such posts. |
| fb_like_count | Like count on Facebook, when the author also published this post on Facebook; appears only on such posts. |
| fb_comment_count | Comment count on Facebook, when the author also published this post on Facebook; appears only on such posts. |
| share_count | Shares. null means not disclosed, not 0. |
| repost_count | Reposts (as distinct from quote posts). null means not disclosed. |
| duration_sec | Duration, in seconds. |
| duration_seconds | Duration in seconds. null for content that is not video or audio. |
| duration_estimated | true means duration_sec is a whole number of seconds read from the video link, at most 1 second off the exact duration. Appears only when the duration was read this way. |
| image_count | Number of images: 1 for a single-image post; for a carousel post, the number of images in it, videos not counted. |
| video_count | Number of videos in a carousel post; only carousel posts have it. |
| video_url_expires_at | Expiry time of video_url, ISO 8601, UTC. |
| video_hd_url | Highest-quality video track: picture only, no sound. It expires; the time is in video_hd_expires_at. For video with sound, merge it with audio_url (for example, combine the two tracks with ffmpeg), or use video_url directly. |
| video_hd_height | Picture height of video_hd_url, in pixels. |
| audio_url | Audio track of the video, sound only; it expires at about the same time as video_hd_url (see video_hd_expires_at). Absent when the video has no separate audio track (for example, a silent video). |
| video_hd_expires_at | Expiry time of video_hd_url, ISO 8601, UTC; audio_url expires at about the same time. |
| is_paid_partnership | Whether the post is marked "Paid partnership". Appears only when the page gives this information, and may be false. |
| is_pinned | Whether the item is pinned. Posts (user_posts, tagged_posts, recent_posts, and other actions that return posts, such as location_posts, audio_posts and explore): pinned by the author to the profile grid or the Reels tab; appears only when pinned, with the value true. Comments (comments): pinned by the post author; appears only when pinned, with the value true. Highlights (highlights): whether it is pinned first in the profile highlights bar. |
| likes_hidden | The author hid the like count. Appears only when hidden, with the value true; like_count is usually absent then. |
| caption_is_edited | The caption was edited. Appears only when edited, with the value true. |
| accessibility_caption | Image description that Instagram generates automatically (alternative text, in English). |
| author_is_verified | Whether the author's account has a verified badge. Appears in user_posts, tagged_posts, location_posts, audio_posts, explore, stories and comment_replies, and in post, discover, reels, hashtag and reels_search rows when it has a value. |
| author_is_private | Whether the author's account is private. |
| author_avatar_url | Author avatar URL; signed link that expires. |
| posted_at_estimated | true means the page gave no publish time and posted_at is the upload time worked out from the post's numeric ID (id); it usually equals the publish time, and is earlier than it for scheduled posts. Appears only when estimated (common in tagged_posts). |
| mentions | Usernames @-mentioned in the text, as an array. |
| tagged_users | Usernames of the people tagged in the images or videos, as an array; for a carousel post, tags on every item count. |
| coauthors | Coauthors: usernames of the accounts credited together with the author on this post, as an array. |
| sponsors | Usernames of the brand accounts named in the paid partnership, as an array. |
| media | Each item in a carousel post, one entry per item: type (image or video), image_url (image URL, the cover image for a video; signed link that expires), video_url (videos only; mp4 with sound), width and height (pixels). Only carousel posts have it. |
| music | Music used by the post or Reel, as an object: artist and title; some also carry audio_id (music ID), is_original (true for original audio recorded by the author, false for a song from the music library), is_explicit (whether a library song is marked explicit), is_trending (whether original audio is trending; original audio only) and url (the Instagram page for this music). For original audio, title is usually Original audio and artist is the username of its author. Absent when there is no music. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
| location_detail | Details of the location attached to the post, as an object: id (location ID), name (location name, same as location), short_name, city, address, lat, lng, url (the Instagram page for this location); each appears only when available. Absent when the post has no location. |
| audio_info | (audio_posts) The music you asked about, the same on every row, as an object: audio_id, title, artist, reels_count (number of Reels that use it) and url (the Instagram page for this music); each appears only when available. |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "instagram",
  "action": "audio_posts",
  "params": {
    "audio_id": "29431066483154650"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "instagram",
        "action": "audio_posts",
        "params": {
            "audio_id": "29431066483154650",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

No real sample for these example parameters yet: structure only, every value is a placeholder (…).

```text
{
  "id": "req_…",
  "platform": "instagram",
  "action": "audio_posts",
  "results": [
    {
      "post_id": …,
      "url": …,
      "text": …,
      "media_type": …,
      "like_count": …,
      "comment_count": …,
      "view_count": …,
      "author_username": …,
      "author_name": …,
      "posted_at": …,
      "location": …,
      "id": …,
      "image_url": …,
      "video_url": …,
      "author_id": …,
      "width": …,
      "height": …,
      "is_comments_disabled": …,
      "author_follower_count": …,
      "hashtags": …,
      "top_comments": …,
      "product_type": …,
      "play_count": …,
      "fb_play_count": …,
      "fb_like_count": …,
      "fb_comment_count": …,
      "share_count": …,
      "repost_count": …,
      "duration_sec": …,
      "duration_seconds": …,
      "duration_estimated": …,
      "image_count": …,
      "video_count": …,
      "video_url_expires_at": …,
      "video_hd_url": …,
      "video_hd_height": …,
      "audio_url": …,
      "video_hd_expires_at": …,
      "is_paid_partnership": …,
      "is_pinned": …,
      "likes_hidden": …,
      "caption_is_edited": …,
      "accessibility_caption": …,
      "author_is_verified": …,
      "author_is_private": …,
      "author_avatar_url": …,
      "posted_at_estimated": …,
      "mentions": …,
      "tagged_users": …,
      "coauthors": …,
      "sponsors": …,
      "media": …,
      "music": …,
      "platform": …,
      "location_detail": …,
      "audio_info": …
    }
  ],
  "next_page_token": …,
  "pagination": { … },
  "count": …,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=instagram
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
