Instagram Sound Search API reference

Instagram audio tracks matching a keyword, with a cursor. Takes a keyword, returns a cursor page, 2 credits a call.

This named API keeps Instagram fields in Instagram's own vocabulary. For a higher-level product page, see Instagram Sound Search API.

Endpoint

GET /v1/instagram/sound/search
Authorization: Bearer sv_live_...

`POST` is also accepted with the same parameters in the request body. Send the key in the `Authorization` header, never in the query string.

Parameters

Name	Type	Required	Notes
`q`	string	yes	Search term or hashtag, up to 100 characters. Trimmed and lowercased before the lookup.
`cursor`	string	no	Cursor returned by the previous page.
`limit`	integer	no	Maximum items to return, up to 50.

Sample Request

This is a copyable request shape. Replace the sample values with the public Instagram target or parameters your workflow uses.

curl -G 'https://api.sourcevine.io/v1/instagram/sound/search' \
  -H 'Authorization: Bearer sv_live_...' \
  --data-urlencode 'q=coffee' \
  --data-urlencode 'limit=20'

Sample Response

A response this API returned, against the target above. Your values depend on the resource you ask about and when you ask.

{
  "data": {
    "items": [
      {
        "url": "https://www.instagram.com/reels/audio/280904319400817/",
        "title": "Coffee",
        "cached": false,
        "soundId": "280904319400817",
        "coverUrl": "https://scontent-cph2-1.cdninstagram.com/v/t39.30808-6/424786500_1021000328996810_2786139399274716171_n.jpg?stp=dst-jpg_p526x296_tt6&_nc_cat=1&ccb=7-5&_nc_sid=2f2557&_nc_ohc=25ggtdB-jVgQ7kNvwGZQsbX&_nc_oc=AdrtWZfFVtibpmL_V7FYSoJwQzMQASTF2-R1KOeErgGh4sqd8uv38jwPtyTT_rDdTC0&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-cph2-1.cdninstagram.com&_nc_gid=_4HEwQihOM_fp64bDtGrsQ&_nc_ss=7c3ba&oh=00_AQM-NIaoHMB-lbNHSqRAdZJQeoP4VnIzwjrh2vpcMW32BQ&oe=6ACBD966",
        "fetchedAt": "2026-10-07T08:17:12Z",
        "postCount": null,
        "authorName": "beabadoobee",
        "cacheAgeSeconds": null,
        "durationSeconds": 127
      },
      {
        "url": "https://www.instagram.com/reels/audio/853363303422773/",
        "title": "Coffee Talk",
        "cached": false,
        "soundId": "853363303422773",
        "coverUrl": "https://scontent-cph2-1.cdninstagram.com/v/t39.30808-6/456427136_90028717356929_1482952513879046952_n.jpg?stp=dst-jpg_p526x296_tt6&_nc_cat=1&ccb=7-5&_nc_sid=2f2557&_nc_ohc=rN3Nc3RuGwYQ7kNvwFfORnA&_nc_oc=AdqloNBHE3MDMxMnpPxY4zrdE8T9Jt0UbLjbkA9vsE71KvtqUmqAI_YmPXGX13L5QkY&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-cph2-1.cdninstagram.com&_nc_gid=_4HEwQihOM_fp64bDtGrsQ&_nc_ss=7c3ba&oh=00_AQOOdwmGVrk5aGqXNsR5XUH2k1X5-pHmyUHY2BHHdr_hNA&oe=6ACBBE9B",
        "fetchedAt": "2026-10-07T08:17:12Z",
        "postCount": null,
        "authorName": "Yuzu Lofi",
        "cacheAgeSeconds": null,
        "durationSeconds": 100
      },
      {
        "url": "https://www.instagram.com/reels/audio/1747512212697470/",
        "title": "Espresso",
        "cached": false,
        "soundId": "1747512212697470",
        "coverUrl": "https://scontent-cph2-1.cdninstagram.com/v/t39.30808-6/432991226_90027831925461_1955188252301264968_n.jpg?stp=dst-jpg_p526x296_tt6&_nc_cat=1&ccb=7-5&_nc_sid=2f2557&_nc_ohc=NtRK-iM_7WgQ7kNvwGjhu0n&_nc_oc=AdpkMEFqYuQADY7fTjKo1dgfG3z0bjH4oNMyd5DQ71qHTfqD4xGdSLstW_wnYO0DMbg&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-cph2-1.cdninstagram.com&_nc_gid=_4HEwQihOM_fp64bDtGrsQ&_nc_ss=7c3ba&oh=00_AQOKXMd6Q0gtRAFt08XRM477njK0fIK6WxRyzmv7DMOqJg&oe=6ACBDA18",
        "fetchedAt": "2026-10-07T08:17:12Z",
        "postCount": null,
        "authorName": "Sabrina Carpenter",
        "cacheAgeSeconds": null,
        "durationSeconds": 175
      }
    ],
    "cached": false,
    "fetchedAt": null,
    "nextCursor": null,
    "cacheAgeSeconds": null
  },
  "success": true,
  "available": true
}

Fields

Field	Type	Notes
`items`	array	Matching public Instagram sounds or music tracks.
`items[].soundId`	string	Use this id with the sound posts API.
`items[].title`	string \| null	Track or sound title.
`items[].authorName`	string \| null	Public sound author or label when available.
`items[].postCount`	integer \| null	How many public posts use the sound when reported.
`nextCursor`	string \| null	Pass as cursor to request the next page.
`fetchedAt`	ISO datetime	When Sourcevine read the public page.
`sourceTimestamp`	ISO datetime \| null	The platform timestamp when it is available.
`cached`	boolean	True when this answer repeats an identical request made moments earlier.
`cacheAgeSeconds`	integer	Seconds since the reading was taken.

Availability States

Status	Charged	Client behavior
`available`	yes for live reads	Use data.
`not_found`	yes	Store the state and stop polling.
`private`	yes	Store the state and stop polling.
`unsupported`	no	Fix the URL or call the matching API.
`upstream_unavailable`	no	Retry later with backoff.

Unavailable resources return `success: true`, `available: false`, `availability`, and `data: null`. API or authentication failures return `success: false` with an `error` object.

Billing

A call costs 2 credits. A deleted, private or empty resource is charged like any lookup and says so. An unsupported URL or a read we could not complete is not charged. The `X-Credits-Charged` response header is the source of truth for what happened on that request.

Successful responses include `fetchedAt`, the time we read the platform.

What This API Does Not Return

No contact or bio fields: Bios, email addresses, phone numbers, postal addresses and messenger handles are outside the response contract.
No private data: Private accounts, restricted content and unavailable resources return typed availability instead of guessed data.
No media download: Sound search returns public metadata and ids. It does not download audio files or bypass platform restrictions.

Last updated 1 September 2026