Open Graph Reference Documentation

Log In

Product Docs

Login

Sharing

Web
iOS
Android
Custom Stories
Overview
Custom Stories on Web
Custom Stories in iOS
Custom Stories in Android
Using Actions
Actions
Using Objects
Creating Custom Stories
Localization
Custom Stories Insights
Submission Process
Reference
Social Plugins
Best Practices

Games

Payments

Ads for Apps

SDKs

iOS

Android

JavaScript

PHP

Unity

Third-Party

APIs

Graph API

Ads API

Open Graph Reference Documentation

Need to know how to make a Open Graph query? Check out the Open Graph Guide.

Action Types

Name	Description
books.quotes	An action representing someone quoting from a book.
books.rates	An action representing someone rating a book.
books.reads	An action representing someone reading a book.
books.wants_to_read	An action representing someone wanting to read a book.
fitness.bikes	An action representing someone cycling a course.
fitness.runs	An action representing someone running a course.
fitness.walks	An action representing someone walking a course.
music.listens	An action representing someone listening to a song, album, radio station, playlist or musician
music.playlists	An action representing someone creating a playlist.
news.publishes	An action representing someone publishing a news article.
news.reads	An action representing someone reading a news article.
og.follows	An action representing someone following a Facebook user
og.likes	An action representing someone liking any object.
places.saves	An action representing someone saving a place.
video.rates	An action representing someone rating a movie, TV show, episode or another piece of video content.
video.wants_to_watch	An action representing someone wanting to watch video content.
video.watches	An action representing someone watching video content.

Object Types

Name	Description
article	This object represents an article on a website. It is the preferred type for blog posts and news stories.
book	This object type represents a book or publication. This is an appropriate type for ebooks, as well as traditional paperback or hardback books. Do not use this type to represent magazines
books.author	This object type represents a single author of a book.
books.book	This object type represents a book or publication. This is an appropriate type for ebooks, as well as traditional paperback or hardback books
books.genre	This object type represents the genre of a book or publication.
business.business	This object type represents a place of business that has a location, operating hours and contact information.
fitness.course	This object type represents the user's activity contributing to a particular run, walk, or bike course.
fitness.unit	This object type represents a custom unit of measurement.
music.album	This object type represents a music album; in other words, an ordered collection of songs from an artist or a collection of artists. An album can comprise multiple discs.
music.playlist	This object type represents a music playlist, an ordered collection of songs from a collection of artists.
music.radio_station	This object type represents a 'radio' station of a stream of audio. The audio properties should be used to identify the location of the stream itself.
music.song	This object type represents a single song.
object	This type represents a generic object, and can be used for objects that are not of a common type, nor of a defined custom type.
place	This object type represents a place - such as a venue, a business, a landmark, or any other location which can be identified by longitude and latitude.
product	This object type represents a product. This includes both virtual and physical products, but it typically represents items that are available in an online store.
product.group	This object type represents a group of product items.
product.item	This object type represents a product item.
profile	This object type represents a person. While appropriate for celebrities, artists, or musicians, this object type can be used for the profile of any