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.

Get Fields and Edges on an Album.


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

Returns a recommendation of a single retailer for a specific brand. This endpoint returns a retailer-brand pair and an advertiser who can advertise on behalf of the producer.

This endpoint is mainly for Facebook’s Marketing Partners using Collaborative Ads.

CPASCollaboration Request

A collaboration request is a partnership request coming from a brand or agency to a retailer or marketing partner. Used for Collaborative Ads.

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 List

A product list inside the 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 retailers 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

Commerce Order

Represents an order placed directly on Facebook or Instagram


Graph API Reference Conversation /conversation


Represents a destination in a catalog


A Document


Get fields and edges on an Event.


Represents a flight in a catalog


A Facebook group.

Group Doc

Graph API Reference Group Doc /group-doc

Group Message


Image Copyright

Represents a copyright on an image asset.

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 groups a Page is a member of.

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

RTBDynamic Post

A dynamically generated Post, used for Dynamic Ad Creatives


Graph API Reference Request /request

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

Returns information about a specific phone number.

Whats App Business HSM

Retrieves information about the message template

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.
Ads Archive

Returns archived ads based on your search. By default we only return all ads that are eligible for delivery and that have the ACTIVE status.

Debug Token