OpengraphParser

OpengraphParser is a simple Ruby library for parsing Open Graph protocol information from a website. Learn more about the protocol at: ogp.me

Installation

gem install opengraph_parser

or add to Gemfile

gem "opengraph_parser"

Usage

Parsing an URL

og = OpenGraph.new("http://ogp.me")
og.title # => "Open Graph protocol"
og.type # => "website"
og.url # => "http://ogp.me/"
og.description # => "The Open Graph protocol enables any web page to become a rich object in a social graph."
og.images # => ["http://ogp.me/logo.png"]

You can also get other Open Graph metadata as:

og.metadata # => {"og:image:type"=>"image/png", "og:image:width"=>"300", "og:image:height"=>"300"}

Parsing a HTML document

og = OpenGraph.new(html_string)

Custom header fields

In some cases you may need to change fields in HTTP request header for an URL

og = OpenGraph.new("http://opg.me", { :headers => {'User-Agent' => 'Custom User Agent'} })

Fallback

If you try to parse Open Graph information for a website that doesn’t have any Open Graph metadata, the library will try to find other information in the website as the following rules:

You can disable this fallback lookup by passing false to init method:

og = OpenGraph.new("http://ogp.me", false)

Contributing to opengraph_parser

Copyright © 2013 Huy Ha. See LICENSE.txt for further details.