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.
NodeDescription
/video

A video

Album

A photo album

Application

A Facebook app

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.

Canvas

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 Text

Text element of the canvas

Canvas Video

A video inside canvas

Collaborative Ads Directory

Directory of businesses that use collaborative ads

Event

Get fields and edges on an Event.

Extended Credit Allocation Config

Represents a relationship between two business portfolio for the purpose of sharing credit line between them.

Games IAPProduct

An in-app-purchaseable product

Group Message

GroupMessage

Image Copyright

Represents a copyright on an image asset.

Instagram Oembed

InstagramOembed

Live Video Input Stream

An ingest stream for a live video

Mailing Address

A mailing address object

Media Fingerprint

Media fingerprint

Object Private Replies

Private replies for an object

Oembed Page

OembedPage

Oembed Post

OembedPost

Oembed Video

OembedVideo

Offline Conversion Data Set Upload

A subset of Offline Event Data Set

Page

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.

Page/insights

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

Photo

This represents a Photo on Facebook.

Place

A place

Place Topic

The category of a place Page

Post

A Facebook Feed story

Shadow IGUser

Instagram User object

Threat Exchange Impact Report

Represents a report of a partner of on-platform impact as a result of shared ThreatExchange data, which covers a specific time range on a single collaboration.

User

Get fields and edges on a User.

Video Copyright

A video copyright

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 HSM

Retrieves information about the message template

Whats App Business Solution

Get data on a multi-partner solution.

个人主页

Graph API Reference Profile /profile

位置标签

An instance of a person being tagged at a place or in a photo, video, post, status or link

对话

Graph API Reference Conversation /conversation

对话

Graph API Reference Thread /thread

对象 Sharedposts

Graph API Reference /object/sharedposts

对象心情

First revision to publish

对象评论

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

小组

A Facebook group.

小组文档

Graph API Reference Group Doc /group-doc

应用链接主机

An individual app link host object created by an app

支付

Graph API Reference Payment /payment

模拟用户

Graph API Reference Test User /test-user

消息

An individual message in the Facebook messaging system.

获赞对象

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

评论

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.

请求

Graph API Reference Request /request

里程碑

Graph API Reference Milestone /milestone

链接

A link shared on a wall.

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

Returns archived ads based on your search.

Branded Content Search

Returns branded content based on your search. By default we only return content that is currently available on Facebook or Instagram, and content that was created on or after August 17, 2023.

Debug Token

Metadata about a particular access token

Generatepreviews

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

Message Template Library

Get a list of message templates in your app user's template library.