Type:

Default: true

It enables normalized metadata detection over the target url.

import mql from '@microlink/mql'

const { data } = await mql('https://www.youtube.com/watch?v=9P6rdqiybaw', {
  meta: true
})

Normalized data fields are enabled by default, so explicit setting to true is unnecessary.

You can configure which specific metadata fields to detect by passing an object with field-specific settings:

Detect only specific fields by setting them to true:

import mql from '@microlink/mql'

const { data } = await mql('https://www.youtube.com/watch?v=9P6rdqiybaw', {
  meta: {
    author: true,
    title: true
  }
})

This will only extract author and title metadata, ignoring other fields like description, image, etc.

Detect all fields except those explicitly set to false:

import mql from '@microlink/mql'

const { data } = await mql('https://www.youtube.com/watch?v=9P6rdqiybaw', {
  meta: {
    image: false,
    logo: false
  }
})

This will extract all metadata fields except image and logo, which can help reduce response size and improve performance when you don't need heavy assets.

If you don't need any of this, you can explicitly disable the default behavior

import mql from '@microlink/mql'

const { data } = await mql('https://www.youtube.com/watch?v=9P6rdqiybaw', {
  meta: false
})

Doing that you can speed up response timing for those cases you are not interested in consuming the metadata, like screenshot or video.

This will be reflected at x-fetch-mode response header whose value should be 'skipped'.

meta

Interactive Code Editor

Configurable detection

Include specific fields

Interactive Code Editor

Exclude specific fields

Interactive Code Editor

Interactive Code Editor