Iframely API: Meta

Most web pages have organic <meta> data published using different semantics standards and optimized for other platforms. For example, oEmbed, Open Graph, Twitter Cards, core HTML meta for Google, Dublin Core, Parsely, Sailthru, etc.

Iframely merges various semantics into a simple one-level object with consistent properties. Any property may be absent, and event all of them together.

Example of meta

"meta": {
  "title": "Input/Output",
  "description": "A new short from Terri Timely and Park Pictures",
  "author_url": "https://vimeo.com/user1946955",
  "author": "Terri Timely",
  "site": "Vimeo",
  "canonical": "https://vimeo.com/141567420",
  "duration": 249,
  "date": "2015-10-06",
  "medium": "video"
}

Iframely API returns meta object that may contain the following fields at the moment.

General meta

  • title
  • description
  • date — the publication date
  • canonical — canonical URL of the resource
  • shortlink — URL shortened through publisher
  • category
  • keywords

Medium

  • medium — rich media embed type

If you need a simple category for media type, and our primary rel array isn’t simple enough, you can use this medium field. It’s analog of the type field in oEmbed.

The possible values are "video", "audio", "playlist", "slideshow", "gifv", "3d", "image", "file", "article", "reader", "event", "survey", "form".

"Article" is for web pages that identify as such. The other general links will have no medium field at all.

Attribution

  • author
  • author_url
  • copyright
  • license
  • license_url
  • site

Stats

  • views — number of views on the original host, e.g. YouTube
  • likes
  • comments
  • duration (in seconds, duration of video or audio content)

Geo data

Following Open Graph spec:

  • country-name
  • postal-code
  • street-address
  • region
  • locality
  • latitude
  • longitude

Product info

Following Pinterest spec:

  • price
  • currency_code
  • brand
  • product_id
  • availability
  • quantity