oembed-spec

!Last version

> A parser for oEmbed specification.

Features

- Always on sync with oEmbed providers (updated weekly via GitHub Actions).
- Handle http/https & www/non-www URLs variations.
- Ability to pass extra oEmbed parameters.
- Built for speed (see benchmarks).

Install

``bash
$ npm install oembed-spec --save
`

Usage

`js
const oEmbed = require('oembed-spec')

// Just pass the URL
oEmbed('https://youtu.be/I8u2NdWuaYs')
// {
// provider_name: 'YouTube',
// author_url: 'https://www.youtube.com/user/mirandaskiss'
// html: ''
// }

// http/https and www/non-www are handled
oEmbed('http://www.youtu.be/I8u2NdWuaYs')
// {
// provider_name: 'YouTube',
// author_url: 'https://www.youtube.com/user/mirandaskiss'
// html: ''
// }

// Pass specific oEmbed options as second parameter
oEmbed('http://www.youtu.be/I8u2NdWuaYs', { maxheight: 612 })
// {
// provider_name: 'YouTube',
// author_url: 'https://www.youtube.com/user/mirandaskiss'
// html: ''
// }
`

API

$3

#### input

_Required_

Type: string`

A valid WHATWG URL.

#### options

Any option present will be passed against the consumer request (see oembed.com section 2.2).

#### gotOpts

Any option present will be passed to got.

$3

Standalone method for finding a provider.

$3

Standalone method for fetching an specific provider.

License

oembed-spec © microlink.io, released under the MIT License.

Authored and maintained by Kiko Beats with help from contributors.

> microlink.io · GitHub microlink.io · X @microlinkhq