# audio

## Table of Contents

- [Examples](#examples)

---

The primary audio track of the page as a direct asset:

```js
const{url}=awaitmicrolink.audio(

'https://open.spotify.com/track/3BovdzfaX4jb5KFQwoPfAw'

)
```

It resolves to an asset object with `url`, `type`, `duration`, `duration_pretty`, `size`, and `size_pretty`, or `null` when no audio is detected:

```js
constaudio=awaitmicrolink.audio(

'https://open.spotify.com/track/1W2919zs8SBCLTrOB1ftQT'

)

console.log(audio.type)// 'mp3'

console.log(audio.duration_pretty)// '30s'
```

It has no method-specific options; the [shared options](https://microlink.io/docs/sdk/getting-started/options) apply. See the [audio parameter](https://microlink.io/docs/api/parameters/audio) for the detection details.

## Examples

Build a podcast entry with the track and the episode metadata in one request:

```js
const{title,publisher,audio}=awaitmicrolink.metadata(episodeUrl,{

audio:true

})

player.src=audio.url

caption.textContent=`${title} — ${publisher} (${audio.duration_pretty})`
```

For every `audio` element on a page rather than the primary track, use [audios](https://microlink.io/docs/sdk/methods/audios).