---
title: "Search Instagram's music catalog"
method: GET
path: "/audio/search"
tags: ["Audio"]
---

# Search Instagram's music catalog

`GET /audio/search`

Search Meta's licensed audio catalog for tracks that can be attached to an Instagram Reel. Pass a returned `audio_id` as `instagram.audio_id` on `POST /posts/create` (type `reel`). Omit `q` to get currently trending audio. Only tracks Meta has authorized for third-party publishing are returned, so the selection can differ from the native app. Requires a Facebook account connected to the workspace whose Facebook Page is linked to the workspace's Instagram account (music publishing runs through Facebook's side of the Instagram API).

## Query parameters

- `q` string
- `type` 'music' | 'original_sound'

## Response `200`

Matching audio tracks

- object
  - `data` object[]
    - `audio_id` string — Use this as `instagram.audio_id`
    - `title` string, nullable
    - `artist` string, nullable
    - `duration_ms` integer, nullable
    - `audio_type` 'music' | 'original_sound'
    - `cover_url` string, nullable — Cover artwork (music) or creator avatar (original sound).
    - `preview_url` string, nullable — Temporary audio preview URL (expires after ~1.5 days — do not store).
    - `ig_username` string, nullable — Creator handle (original sounds only).
  - `error` string, nullable — Set when search is unavailable (e.g. no linked Facebook account). data is then empty.
  - `needsFacebook` boolean — true when the workspace needs a Facebook connection (with a Page linked to this Instagram account) before music is available.

---

[API](https://skmtc.dev/omnisocials/apis/omnisocials-api.md) · [All operations](https://skmtc.dev/omnisocials/apis/omnisocials-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/omnisocials/omnisocials-api/revisions/e53b89af0b98/schema)