Graph API Version

Graph API Reference

Graph API Root Nodes

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.

Instance for an achievement for a user.

Achievement Type

Graph API Reference Achievement Type /achievement-type


Get Fields and Edges on an Album.

App Link Host

An individual app link host object created by an app

App Request

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


A Facebook app

Async Session

Represents an async job request to Graph API

Atlas Ad Set

An Atlas AdSet

Atlas Campaign

An Atlas Campaign

Atlas FBConversion Event

Conversion Event Node

Atlas Publisher

An Atlas Publisher

Atlas Report

An Atlas Report

Atlas Report Run

An Atlas ReportRun

Atlas Report Schedule

An Atlas ReportSchedule

Atlas Tracking Connection

An Ad Platform Tracking Connection

Business Unit

Represents a group of certain types of Business objects in a Business. Will be used by Measurement Hub initially with more usage coming later on.

CPASAdvertiser Partnership Recommendation

contains a single merchant-producer pair that are recommended to partner, and an advertiser who can advertise on behalf of the producer

CPASCollaboration Request

Request from either producer/merchant to another producer/merchant.

CTCert Domain

A domain name that has been issued new certificates.


A canvas document

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

Collaborative Ads Directory

Directory of businesses that use collaborative ads. This endpoint must be used in conjunction with the collaborative_ads_merchants field below.


A comment can be made on various types of content on Facebook. Most Graph API nodes have a /comments edge that lists all the comments on that object. The /comment node returns a single comment.

Commerce Merchant Settings

Commerce Merchant Settings object


Graph API Reference Conversation /conversation

Debug Token

Debug token endpoint docs


Represents a destination in a catalog


A Document


A web domain claimed within Facebook Insights


Get fields and edges on an Event.


Represents a flight in a catalog

Friend List

This represents a user's friend list on Facebook


A Facebook group.

Group Doc

Graph API Reference Group Doc /group-doc

Instagram Oembed


Lead Gen Data

A lead ad form


A link shared on a wall.

Live Encoder

Get fields and edges on a LiveEncoder.

Live Video

Get fields and edges on a LiveVideo.

Live Video Input Stream

An ingest stream for a live video

Mailing Address

A mailing address object

Media Fingerprint

Media fingerprint


An individual message in the Facebook messaging system.


Graph API Reference Milestone /milestone

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.

Object Comments

This reference describes the /comments edge that is common to multiple Graph API nodes. The structure and operations are the same for each node.

Object Likes

This reference describes the /likes edge that is common to multiple Graph API nodes. The structure and operations are the same for each node.

Object Private Replies

Private replies for an object

Object Reactions

First revision to publish

Object Sharedposts

Graph API Reference /object/sharedposts

Oembed Page


Oembed Post


Oembed Video


Offline Conversion Data Set

A Data Set for Offline Conversions object

Offline Conversion Data Set Upload

A subset of Offline Event Data Set


Get fields and edges on a Page.

Page Call To Action

Page's call-to-action

Page Post

A Facebook feed story

Page Upcoming Change

Notification of page upcoming changes.


This object represents a single Insights metric that is tied to another particular Graph API object (Page, App, Post, etc.).


Graph API Reference Payment /payment


This represents a Photo on Facebook.


A place

Place Topic

The category of a place Page


A Facebook Feed story


Graph API Reference Profile /profile

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

Store Catalog Settings

Represents settings specific to local inventory of a product catalog

Test User

Graph API Reference Test User /test-user


Graph API Reference Thread /thread


Get fields and edges on a User.


A Video

Video Copyright

A video copyright

Video Copyright Rule

A video copyright rules

Video List

A playlist for videos

Video Poll

Embedded video poll

Video Poll Option

Represents a single poll option that may be selected by the user

Whats App Business Account

Returns the account information of a WhatsApp Business Account

Whats App Business Account To Number Current Status

The current status of the relationship between EntWhatsAppBusinessAccount and EntWhatsAppAccountNumber.

Whats App Business HSM

Retrieves information about the message template

Work Knowledge Collection

Represents a collection of Workplace Knowledge

Graph API Root Edges

Root edges are edges that can be queried directly. They allow you to access collections of nodes that are not on a parent node.

Returns the certificates issued for a domain name.


Endpoint to generate preview without using any Facebook specific assets (e.g. adaccount)