> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bridgly.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Get audio details

> Get a song or original sound used in Instagram Reels by its audio ID or audio page link: title, artist, length, cover image, a downloadable audio file, whether it is trending and how many Reels use it. Get audio IDs from the audio field of a Reel. Costs 1 credit per request.



## OpenAPI

````yaml /openapi.json post /instagram/audio
openapi: 3.1.0
info:
  title: Bridgly API
  description: >-
    Web scraping API for LinkedIn, X (Twitter), Reddit, GitHub, Instagram and
    TikTok. Authenticated endpoints accept a Bridgly API key (`bgly_…`) via
    `Authorization: Bearer <token>`.
  version: 1.0.0
servers:
  - url: https://api.bridgly.app
    description: Production
security: []
tags:
  - name: LinkedIn
    description: Scrape LinkedIn profiles, companies, posts, and search.
  - name: Reddit
    description: Scrape Reddit posts, subreddits, users, and search.
  - name: X (Twitter)
    description: Scrape tweets and search X.
  - name: GitHub
    description: >-
      Fetch GitHub profiles, pinned repos, contributions, repositories, stars,
      and projects via GitHub's GraphQL API.
  - name: Instagram
    description: Scrape Instagram profiles, posts, followers, and search.
  - name: TikTok
    description: Fetch TikTok profiles.
  - name: Meta Ads
    description: >-
      Search the Meta Ad Library: ads, ad details, and advertisers on Facebook
      and Instagram.
paths:
  /instagram/audio:
    post:
      tags:
        - Instagram
      summary: Get audio details
      description: >-
        Get a song or original sound used in Instagram Reels by its audio ID or
        audio page link: title, artist, length, cover image, a downloadable
        audio file, whether it is trending and how many Reels use it. Get audio
        IDs from the audio field of a Reel. Costs 1 credit per request.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                audioId:
                  type: string
                  minLength: 1
                  description: >-
                    Numeric audio ID, or the audio page link, e.g.
                    "6516695721690591" or
                    "https://www.instagram.com/reels/audio/6516695721690591/".
                cacheMaxAgeHours:
                  description: >-
                    Accept a cached result scraped up to this many hours ago. A
                    cached result costs no credits, and its `cachedAt` says when
                    it was scraped. When no cached result is that recent, the
                    data is scraped live at the normal price. Leave it out to
                    always scrape live, e.g. 24.
                  type: integer
                  exclusiveMinimum: 0
                  maximum: 9007199254740991
                cacheOnly:
                  description: >-
                    Return only a cached result and never scrape live. With
                    `cacheMaxAgeHours`, only a result that recent is returned;
                    without it, the latest cached result of any age. Responds
                    404, at no cost, when there is none, e.g. true.
                  type: boolean
              required:
                - audioId
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  timeMs:
                    type: number
                    description: >-
                      Wall-clock time the request took to complete, in
                      milliseconds.
                  creditsCost:
                    type: number
                    description: Number of account credits this request consumed.
                  cachedAt:
                    anyOf:
                      - type: string
                        format: date-time
                        pattern: >-
                          ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                      - type: 'null'
                    description: >-
                      When the returned data was scraped, if it came from the
                      cache. Null when it was scraped live for this request.
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        description: Audio ID. Pass this to getAudio or getAudioReels.
                      url:
                        type: string
                      type:
                        description: >-
                          Kind of audio as Instagram labels it, e.g.
                          "licensed_music" or "original_sounds".
                        anyOf:
                          - type: string
                          - type: 'null'
                      title:
                        anyOf:
                          - type: string
                          - type: 'null'
                      artist:
                        anyOf:
                          - type: string
                          - type: 'null'
                      artist_username:
                        description: >-
                          Instagram username of the artist or the original
                          creator.
                        anyOf:
                          - type: string
                          - type: 'null'
                      owner:
                        description: Account that published the original audio.
                        anyOf:
                          - type: object
                            properties:
                              id:
                                type: string
                              username:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                              full_name:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                              profile_pic_url:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                              is_private:
                                anyOf:
                                  - type: boolean
                                  - type: 'null'
                              is_verified:
                                anyOf:
                                  - type: boolean
                                  - type: 'null'
                              profile_pic_id:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                              latest_reel_media:
                                description: >-
                                  Latest story publish time as Unix seconds;
                                  zero means no recent story.
                                anyOf:
                                  - type: number
                                  - type: 'null'
                              is_mentionable:
                                anyOf:
                                  - type: boolean
                                  - type: 'null'
                            required:
                              - id
                            additionalProperties: false
                          - type: 'null'
                      duration_ms:
                        description: Audio length in milliseconds.
                        anyOf:
                          - type: number
                          - type: 'null'
                      cover_url:
                        anyOf:
                          - type: string
                          - type: 'null'
                      preview_url:
                        description: Downloadable audio file.
                        anyOf:
                          - type: string
                          - type: 'null'
                      is_explicit:
                        anyOf:
                          - type: boolean
                          - type: 'null'
                      is_trending:
                        anyOf:
                          - type: boolean
                          - type: 'null'
                      reels_count:
                        description: Number of Reels that use this audio.
                        anyOf:
                          - type: number
                          - type: 'null'
                      original_media_id:
                        description: ID of the post that introduced the original audio.
                        anyOf:
                          - type: string
                          - type: 'null'
                      created_at:
                        description: Original audio creation time as Unix seconds.
                        anyOf:
                          - type: number
                          - type: 'null'
                      is_restricted:
                        description: Whether Instagram restricts the audio page.
                        anyOf:
                          - type: boolean
                          - type: 'null'
                    required:
                      - id
                      - url
                    additionalProperties: false
                required:
                  - timeMs
                  - creditsCost
                  - cachedAt
                  - data
                additionalProperties: false
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                    description: Human-readable description of what went wrong.
                required:
                  - status
                  - message
                additionalProperties: false
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                    description: Human-readable description of what went wrong.
                required:
                  - status
                  - message
                additionalProperties: false
        '402':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                    description: Human-readable description of what went wrong.
                required:
                  - status
                  - message
                additionalProperties: false
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                    description: Human-readable description of what went wrong.
                required:
                  - status
                  - message
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                    description: Human-readable description of what went wrong.
                required:
                  - status
                  - message
                additionalProperties: false
        '422':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                    description: Human-readable description of what went wrong.
                required:
                  - status
                  - message
                additionalProperties: false
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                    description: Human-readable description of what went wrong.
                required:
                  - status
                  - message
                additionalProperties: false
      security:
        - bearerAuth: []
      x-codeSamples:
        - lang: typescript
          label: Bridgly SDK
          source: |-
            import { Bridgly } from '@bridgly/sdk';

            const client = new Bridgly({ apiKey: process.env.BRIDGLY_API_KEY });

            const res = await client.instagram.getAudio({
              audioId: "string",
            });
            if (res.type === 'success') console.log(res.data);
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        A Bridgly API key (`bgly_…`). Metered endpoints deduct credits from the
        resolved account.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.