Open Graph Reference Documentation
Need to know how to make a Open Graph query? Check out the Open Graph Guide.
Using any of these actions or objects in an Open Graph story will require review from Facebook before people can publish stories with them. Learn more about Open Graph Review.
Action Types
NameDescription
apps.savesAn action representing someone saving an app to try later.
books.quotesAn action representing someone quoting from a book.
books.ratesAn action representing someone rating a book.
books.readsAn action representing someone reading a book.
books.wants_to_readAn action representing someone wanting to read a book.
fitness.bikesAn action representing someone cycling a course.
fitness.runsAn action representing someone running a course.
fitness.walksAn action representing someone walking a course.
games.achievesAn action representing someone reaching a game achievement.
games.celebrateAn action representing someone celebrating a victory in a game.
games.playsAn action representing someone playing a game. Stories for this action will only appear in the activity log.
games.savesAn action representing someone saving a game.
music.listensAn action representing someone listening to a song, album, radio station, playlist or musician
music.playlistsAn action representing someone creating a playlist.
news.publishesAn action representing someone publishing a news article.
news.readsAn action representing someone reading a news article.
og.followsAn action representing someone following a Facebook user
og.likesAn action representing someone liking any object.
pages.savesAn action representing someone saving a place.
restaurant.visitedAn action representing someone visiting a restaurant.
restaurant.wants_to_visitAn action representing someone wanting to visit a restaurant
sellers.ratesAn action representing a commerce seller has been given a rating.
video.ratesAn action representing someone rating a movie, TV show, episode or another piece of video content.
video.wants_to_watchAn action representing someone wanting to watch video content.
video.watchesAn action representing someone watching video content.
Object Types
NameDescription
articleThis object represents an article on a website. It is the preferred type for blog posts and news stories.
bookThis 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.authorThis object type represents a single author of a book.
books.bookThis object type represents a book or publication. This is an appropriate type for ebooks, as well as traditional paperback or hardback books
books.genreThis object type represents the genre of a book or publication.
business.businessThis object type represents a place of business that has a location, operating hours and contact information.
fitness.courseThis object type represents the user's activity contributing to a particular run, walk, or bike course.
game.achievement This object type represents a specific achievement in a game. An app must be in the 'Games' category in App Dashboard to be able to use this object type. Every achievement has a `game:points` value associate with it. This is not related to the points the user has scored in the game, but is a way for the app to indicate the relative importance and scarcity of different achievements: * Each game gets a total of 1,000 points to distribute across its achievements * Each game gets a maximum of 1,000 achievements * Achievements which are scarcer and have higher point values will receive more distribution in Facebook's social channels. For example, achievements which have point values of less than 10 will get almost no distribution. Apps should aim for between 50-100 achievements consisting of a mix of 50 (difficult), 25 (medium), and 10 (easy) point value achievements Read more on how to use achievements in [this guide](/docs/howtos/achievements/).
music.albumThis 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.playlistThis object type represents a music playlist, an ordered collection of songs from a collection of artists.
music.radio_stationThis 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.songThis object type represents a single song.
placeThis 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.
productThis 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.groupThis object type represents a group of product items.
product.itemThis object type represents a product item.
profileThis object type represents a person. While appropriate for celebrities, artists, or musicians, this object type can be used for the profile of any individual. The `fb:profile_id` field associates the object with a Facebook user.
restaurant.menuThis object type represents a restaurant's menu. A restaurant can have multiple menus, and each menu has multiple sections.
restaurant.menu_itemThis object type represents a single item on a restaurant's menu. Every item belongs within a menu section.
restaurant.menu_sectionThis object type represents a section in a restaurant's menu. A section contains multiple menu items.
restaurant.restaurantThis object type represents a restaurant at a specific location.
video.episodeThis object type represents an episode of a TV show and contains references to the actors and other professionals involved in its production. An episode is defined by us as a full-length episode that is part of a series. This type must reference the series this it is part of.
video.movieThis object type represents a movie, and contains references to the actors and other professionals involved in its production. A movie is defined by us as a full-length feature or short film. Do not use this type to represent movie trailers, movie clips, user-generated video content, etc.
video.otherThis object type represents a generic video, and contains references to the actors and other professionals involved in its production. For specific types of video content, use the `video.movie` or `video.tv_show` object types. This type is for any other type of video content not represented elsewhere (eg. trailers, music videos, clips, news segments etc.)
video.tv_showThis object type represents a TV show, and contains references to the actors and other professionals involved in its production. For individual episodes of a series, use the `video.episode` object type. A TV show is defined by us as a series or set of episodes that are produced under the same title (eg. a television or online series)