Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A python module to parse the Open Graph Protocol
branch: master
Failed to load latest commit information.
opengraph + remove false test
.gitignore some restricitions I forgot
README.rst Updated README.rst. new release at pypi


OpenGraph is a module of python for parsing the Open Graph Protocol, you can read more about the specification at


$ pip install opengraph


  • Use it as a python dict
  • Input and parsing from a specific url
  • Input and parsung from html previous extracted
  • HTML output
  • JSON output


From an URL

>>> import opengraph
>>> video = opengraph.OpenGraph(url="")
>>> video.is_valid()
>>> for x,y in video.items():
...     print "%-15s => %s" % (x, y)
site_name       => YouTube
description     => Eric Clapton and Paul McCartney perform George Harrison's "While My Guitar Gently Weeps" at the...
title           => While My Guitar Gently Weeps
url             =>
image           =>
video:type      => application/x-shockwave-flash
video:height    => 224
video           =>
video:width     => 398
type            => video


>>> HTML = """
... <html xmlns:og="">
... <head>
... <title>The Rock (1996)</title>
... <meta property="og:title" content="The Rock" />
... <meta property="og:type" content="movie" />
... <meta property="og:url" content="" />
... <meta property="og:image" content="" />
... </head>
... </html>
... """
>>> movie = opengraph.OpenGraph() # or you can instantiate as follows: opengraph.OpenGraph(html=HTML)
>>> movie.parser(HTML)
>>> video.is_valid()

Generate JSON or HTML

>>> ogp = opengraph.OpenGraph("")
>>> print ogp.to_json()
{"image:type": "image/png", "title": "Open Graph protocol", "url": "", "image": "", "scrape": false, "_url": "", "image:height": "300", "type": "website", "image:width": "300", "description": "The Open Graph protocol enables any web page to become a rich object in a social graph."}
>>> print ogp.to_html()

<meta property="og:image:type" content="image/png" />
<meta property="og:title" content="Open Graph protocol" />
<meta property="og:url" content="" />
<meta property="og:image" content="" />
<meta property="og:scrape" content="False" />
<meta property="og:_url" content="" />
<meta property="og:image:height" content="300" />
<meta property="og:type" content="website" />
<meta property="og:image:width" content="300" />
<meta property="og:description" content="The Open Graph protocol enables any web page to become a rich object in a social graph." />
Something went wrong with that request. Please try again.