Graph API

The latest version is:

v18.0

The Graph API is the primary way for apps to read and write to the Facebook social graph. All of our SDKs and products interact with the Graph API in some way, and our other APIs are extensions of the Graph API, so understanding how the Graph API works is crucial.

If you are unfamiliar with the Graph API, we recommend that you start with these documents:

1. Overview – Learn how the Graph API is structured, and how it works.
2. Get Started – Explore the Graph API endpoints using the Graph API Explorer tool and run your first request.
3. Batch requests – Learn how to send multiple API requests in one call.
4. Debug requests – Learn how to debug API requests.
5. Handle errors – Learn how to handle common errors encountered when using the Graph API.
6. Field expansion – Learn how to limit the number of objects returned in a request and perform nested requests.
7. Secure requests – Learn how to make secure requests to the Graph API.
8. Resumable Uploads API – Learn how to upload files to the Graph API.

Reference

Learn how to read our reference documents so you can easily find what you're looking for.

Where to Start

We strongly recommend you start with the Graph API Overview to learn the structure of the Facebook Social Graph.