Skip to main content

A module to parse the Open Graph Protocol

Project description

Topicaxis-opengraph is a fork of that adds support for Python 3.

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


$ pip install topicaxis-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." />

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

topicaxis-opengraph-0.5.tar.gz (4.5 kB view hashes)

Uploaded source

Built Distribution

topicaxis_opengraph-0.5-py3-none-any.whl (4.7 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page