The Graph API

The primary way for apps to read and write to the Facebook social graph. The Graph API has multiple versions available, read about what has changed and how to upgrade from older versions.

Overview

Learn how the Graph API is structured, how versioning works and what access tokens are.

Using the Graph API

Learn how to publish to and retrieve data from Facebook using the Graph API.

API Reference

Get the full details of all the nodes, edges, and fields in the latest version of the Graph API.

Graph API and SDKs

Learn how to use our iOS, Android, JavaScript, PHP SDKs with the Graph API. Third-party SDKs are also available.

Staying up to date

The current, latest version of the Graph API is v2.8. Please read our Changlog and blog posts to stay up to date.

To prevent broken experiences for people using your app, we strongly recommend to upgrade your apps to the latest current version at the earliest opportunity.


Roadmap

The full list of announced breaking changes and additions to our APIs and SDKs.

Versions and Migrations

Update your code to call a specific API version in order to get two years of stability for Core APIs. Use migrations to change the behaviour of an old API version.

Changelog

See what has changed in Facebook's APIs and SDKs.

Upgrade Guide

Detailed information about how to upgrade from older versions.

Further Reading

Common App Scenarios

Because the Graph API can be used in a massive variety of ways, we have provided a list of common scenarios for apps in this doc, to help you locate the reference doc that you need to build a solution for it.

Advanced Guides

After you've conquered the basics of Graph API, you might want to learn more. We have guides to advanced topics like Making Multiple API Requests, Real Time Updates, and Securing API calls in our Advanced Guides section.

Other APIs

The Graph API is connected to some other Facebook APIs such as the Public Feed and Keyword Insights APIs. You can read our guides to these APIs in this section.