Graph API Version

Graph API Reference

This is a full list of the Graph API root nodes. The main difference between a root node and a non-root node is that root nodes can be queried directly, while non-root nodes can be queried via root nodes or edges. If you want to learn how to use the Graph API, read our Using Graph API guide, and if you want to know which APIs can solve some frequent issues, try our Common Scenarios guide.

Graph API Root Nodes


Represents a person gaining a game achievement

Achievement Type

A games achievement type


A photo album

App Link Host

An app link host

App Request

An individual app request received by someone, sent by an app or another person


A Facebook app

Application Context

Provides access to available social context edges for this app

Audience Insights Rule

Definition of a rule

Canvas Button

A button inside the canvas

Canvas Carousel

A carousel inside a canvas

Canvas Footer

A footer of the canvas

Canvas Header

A header inside the canvas

Canvas Photo

A photo inside a canvas

Canvas Product Set

A product set inside the canvas

Canvas Store Locator

A store locator inside the canvas

Canvas Text

Text element of the canvas

Canvas Video

A video inside canvas


A single comment


A Facebook Messages conversation between a person and a Facebook Page


This entity represents a natural, accidental, or man-made disaster. It powers the Safety Check product as well as others.

Crisis Listing

This node represents a post made in the Community Help section of Safety Check, where people can offer or request resources after a natural disaster. These entries have well-defined positions and structured data in order to plot them on a map and facilitate matching.

Debug Token

Debug token endpoint docs


A Document


A web domain claimed within Facebook Insights

Education Experience

The person's education history


An event

Friend List

This represents a user's friend list on Facebook


A Facebook group

Group Doc

A document in a Facebook group

Instagram Carousel

An Instagram carousel

Instagram Comment

An Instagram comment

Instagram Media

An Instagram media

Instagram User

An Instagram user

Life Event

Page milestone information


A link shared on Facebook

Live Video

A live video

Mailing Address

A mailing address object

Media Fingerprint

Media fingerprint


A single message in Facebook Messenger


A milestone for a Facebook Page

Native Offer

A native offer represents an Offer on Facebook. The /{offer_id} node returns a single native offer. Each native offer requires a view to be rendered to users.


An individual unread Facebook notification

Object Comments

Comments on an object

Object Likes

Likes for an object

Object Sharedposts

Shares of this object

Open Graph Action Type

An Open Graph action type

Open Graph Context

Social context

Open Graph Object Type

An Open Graph object type


A Facebook page

Page Admin Note

Page's admin note

Page Call To Action

Page's call-to-action

Page Label

Page's label


Insights and metrics for an object

Pages Platform Component Flow Service Config

A node to get Native Component workflows info.


A single payment


This represents a Photo on Facebook


A place

Place Tag

A Place Tag

Place Topic

The category of a place Page


Special syntax for the link field.


A profile, which can be a user, page, group or event

Promotion Info

A promotional info for the post.

RTBDynamic Post

A dynamically generated Post, used for Dynamic Ad Creatives


An app request received by a person. A request can be sent by an app or another person

Saved Message Response

A saved message response for a Facebook Page


A status message in a profile's feed

Test User

A test user associated with a Facebook app. Test users are created and associated using the /app/accounts/test-users edge or the App Dashboard.


A messages thread in Facebook Messenger


Shares, app links, and Open Graph objects for a URL


Returns a single user node

User Context

Social context for a person


A Video

Video Copyright

A video copyright

Video Copyright Rule

A video copyright rules

Video List

A playlist for videos

Work Experience

Information about a user's work