oEmbed Parser API

oEmbed Parser API seamlessly extracts data from popular platforms like YouTube, Twitter, Vimeo, and many more.

Key Features

• Extract Rich Media Data: effortlessly retrieve oEmbed data from any webpage URL, enabling content embedding of images, videos, tweets, and more.
• Streamlined Workflow: eliminate the need for manual code or complex parsing solutions, oEmbed Parser delivers the data you need in a standardized format.

Authentication

Include the following headers in your requests:

• X-RapidAPI-Key: your unique RapidAPI key obtained upon registration
• X-RapidAPI-Host: set to oembed-parser.p.rapidapi.com

Request Parameters

• url (required): provide the URL of the webpage with the media embedded
• lang (optional): language of the embed, default to en
• theme (optional): color theme of the embed element, can be set to dark or light
• maxwidth(optional): max width of the embed element, default to 600px
• maxheight(optional): max height of the embed element, default to 400px

The effect of lang, theme, maxwidth and maxheight depends on the support of embed source provider.

Example

Request from Node.js server

We love native approach with build-in fetch util:

import querystring from 'node:querystring'

export async function extract (url)  {
  try {
    const queryString = querystring.stringify({
      url,
      lang: 'en',
      theme: 'dark',
      maxwidth: '600',
      maxheight: '400'
    })

    const target = `https://oembed-parser.p.rapidapi.com/oembed/parse?${queryString}`
    
    const res = await fetch(target, {
      headers: {
        'X-RapidAPI-Key': 'YOUR_OWN_RAPID_API_KEY',
        'X-RapidAPI-Host': 'oembed-parser.p.rapidapi.com'
      },
    })
    const json = await res.json()
    return json
  } catch (err) {
    console.error(err)
    return null
  }
}

const data = await extract('https://www.slideshare.net/ericschmidt/trillion-dollar-coach-book-bill-campbell')
console.log(data)

Of course you can use axios or other alternatives exist for sending requests:

import axios from 'axios'

const options = {
  method: 'GET',
  url: 'https://oembed-parser.p.rapidapi.com/oembed/parse',
  params: {
    url: 'https://www.slideshare.net/ericschmidt/trillion-dollar-coach-book-bill-campbell',
    lang: 'en',
    theme: 'dark',
    maxwidth: '600',
    maxheight: '400'
  },
  headers: {
    'X-RapidAPI-Key': 'YOUR_OWN_RAPID_API_KEY',
    'X-RapidAPI-Host': 'oembed-parser.p.rapidapi.com'
  }
}

try {
  const response = await axios.request(options);
  console.log(response.data);
} catch (error) {
  console.error(error);
}

Response in JSON format:

{
  "error": 0,
  "message": "oEmbed extraction success",
  "data": {
    "version": "1.0",
    "type": "rich",
    "title": "Trillion Dollar Coach Book (Bill Campbell)",
    "author_name": "Eric Schmidt",
    "author_url": "https://www.slideshare.net/ericschmidt",
    "provider_name": "SlideShare",
    "provider_url": "https://www.slideshare.net/",
    "html": "&lt;iframe src=\"https://www.slideshare.net/slideshow/embed_code/key/55xxfVqnqfzL6U\" width=\"427\" height=\"356\" frameborder=\"0\" marginwidth=\"0\" marginheight=\"0\" scrolling=\"no\" style=\"border:1px solid #CCC; border-width:1px; margin-bottom:5px; max-width: 100%;\" allowfullscreen&gt; &lt;/iframe&gt; <div> <strong> <a href title="\&quot;Trillion" target="\&quot;_blank\&quot;">Trillion Dollar Coach Book (Bill Campbell)</a> </strong> from <strong><a href target="\&quot;_blank\&quot;">Eric Schmidt</a></strong> </div>\n",
    "width": 425,
    "height": 355,
    "thumbnail": "https://cdn.slidesharecdn.com/ss_thumbnails/trilliondollarcoachslideshare-190415231411-thumbnail.jpg?width=320&height=320&fit=bounds",
    "thumbnail_url": "https://cdn.slidesharecdn.com/ss_thumbnails/trilliondollarcoachslideshare-190415231411-thumbnail.jpg?width=320&height=320&fit=bounds",
    "thumbnail_width": 170,
    "thumbnail_height": 128,
    "total_slides": 36,
    "conversion_version": 2,
    "slide_image_baseurl": "https://image.slidesharecdn.com/trilliondollarcoachslideshare-190415231411/85/slide-",
    "slide_image_baseurl_suffix": "-638.jpg",
    "version_no": "1664962315",
    "slideshow_id": 140939671
  }
}

If something wrong, the API will return:

{
  "error": 1,
  "message": "error description",
  "data": null
}