The Graph API is the primary way that data is retrieved or posted to Facebook. The Graph API Getting Started Guide contains an overview of the basics of the API and walks you through using the Graph API Explorer. It also shows you how names work, how permissions work and what connections are.
Pictures are available on many objects and are the most commonly used object in the graph. This document covers how to access them. Pictures are not photographs. For photographs that people upload see the Photo and Album reference API documents.
When accessing objects in the graph, you can control which fields are returned.
Many of the Graph APIs let you get data in small sets and provide a way to page forward and backwards in time. This document covers how to use the pagination arguments and results.
You can search through public objects with the Graph API. This document covers the basics on the objects you can search and how to page through results.
Many APIs return dates. This document covers the default format we use at Facebook and how you can change it.
Much of the data you'll be accessing via the Graph API requires that people give your app permission to access it. This includes reading anything beyond public data or writing data to the timeline. This document gives you pointers to what you need to do about the topics of privacy, permissions, login and auth tokens.
This document covers information about how to secure calls to the Graph API. It includes using appsecret_proof
and pointers to improving security around access tokens.
People, pages, groups and apps all have a way to post stories to the timeline. This article provides the basics of how to create simple posts and covers how to generate likes and create comments.
You can delete objects from the graph. This article shows you how, as well as how to remove likes.
You can get updates on objects you care about without having to poll Facebook on a regular basis. Facebook will push updates to you when they change. This can result in significant performance improvement for your app.
You can batch a bunch of requests and make them all at once, instead of having to make a bunch of small requests. This can improve latency and overhead associated with making a large number of changes.
This feature allows you to get a number of objects with a single query result. Much like batch requests for results, field expansion can reduce latency and improve the performance of your app.
We offer an API for app authors who want to programatically get analytics for their app.
We provide a set of APIs to manage Pages. This lets you build apps that you can use to manage posts, gather analytics, post pictures or many other things.
Games on Facebook can create Facebook groups to give game players the chance to coordinate and socialize.
A guide to working with comments.
The list of errors that Graph API calls can generate.
Many objects allow you to determine the attributes and connections they support at runtime. This can be useful for debugging.
You can retrieve localized content from the Graph API by adding the locale
parameter.
Some examples for accessing the Graph API.
There are parameters that you can pass with Graph API requests that modify input and output types.
Graph API for app analytics.
How to use App and Game Groups.
If your application needs the ability to access significant amounts of data in a single go - or you need to make changes to several objects at once, it is often more efficient batch your queries rather than make multiple individual HTTP requests. To enable this, the Graph API support Batching. Batching allows you to pass instructions for several operations in a single HTTP request.
Data Access through the Graph API.
Dates in the Graph API.
Deleting objects and likes with the Graph API.
Graph API Field Expansion
Examples of using the Graph API.
Introspection allows you to see an object's attributes and connections.
The locale parameter.
Paging through Graph API results
Privacy Parameter for Graph API, REST API and Open Graph Actions.
Publishing with the Graph API
The Graph API supports realtime updates to enable your app using Facebook to subscribe to changes in data from Facebook. Your app caches data and receives updates, rather than polling Facebook’s servers. Caching data and using this API can improve the reliability of your app and decrease its load times.
Request parameters that can be used with Graph API calls.
Searching with the Graph API.
Every Graph API call requires the use of an access_token
. Access tokens are portable, which makes them vulnerable to a variety of attacks where malicious apps can steal a token and use it on behalf of an app or a person. This document covers some of the ways you can improve security in your app using a couple of methods that Facebook offers.
Selecting results with the Graph API.
A guide to using comments.
Instance for an achievement for a user.
A photo album
An application registered on Facebook Platform
A checkin made through Facebook Places or the Graph API.
A Comment on a Graph API object
A website domain within the Graph API
Errors using the Graph API
A Facebook event
A Facebook friend list
A Facebook group
Statistics about applications, pages, or domain.
A shared link
A message in a thread
A Facebook Note
An Offer published by a page.
An order object associated with Facebook Credits.
A Facebook Page
A payment made through our Payments API.
An individual photo within an album
Using pictures with the Graph API
An individual entry in a profile's feed
A question asked by a user, as represented in the Graph API.
An option allowed as an answer to a question.
A review for an application
A status message on a user's wall
A message thread
A user profile.
An individual video