oEmbed is a format for allowing an embedded representation of a URL on third party sites. The simple API allows a website to display embedded content (such as photos or videos) when a user posts a link to that resource, without having to parse the resource directly.
npm i oembed
Don't forget to put it in
dependencies of your
if you use this in a node app.
Automatic Embed.ly fallback when an API key is provided
Uses htmlparser for HTML and XML parsing
Retrieve and display oEmbed information for a custom URL.
oembed_httpd <bind-port> [bind-host]
Replicates the embed.ly API in a simple Web server.
Compare JSON and XML descriptors for a URL.
In a real-world app all you should need is the fetch function to get
oEmbed information. We always use the
function callback(error, result) convention.
The two steps can be executed separately whenever you need more control:
oembed.discover(url, callback)finds all
<link rel="alternate">in a document
- Get and parse descriptors immediately with
oembed.fetchXML(url, callback)if you have discovery information already
The Embed.ly service can deliver oEmbed information even for resources that don't provide oEmbed links. Go sign up with them and configure your API key like:
oembedEMBEDLY_KEY = "...";
- Document size limits?
- bin/oembed_httpd: Multiple URLs like embed.ly
- bin/oembed_httpd: Pass through for ETags and Last-Modified