Graph:Page

From Facebook Developer Wiki (FbDevWiki.com)
Jump to: navigation, search

A Facebook Page. This object supports Real-Time Updates for all properties except the ones marked with a *. Pages in specific categories have additional fields depending on category.

Contents

Example

https://graph.facebook.com/platform (Facebook Platform)

Properties

Different values may exist depending on the page's category

Name Description Permissions Returns Condition
id The Page's ID Publicly available A JSON string always included
name The Page's name Publicly available A JSON string always included
picture URL to the pages profile picture Publicly available A JSON string of a URL always included
link URL to the actual page on Facebook Publicly available A JSON string of a URL always included
category The Page's category Publicly available A JSON string of a Page Category always included
website URL entered into the page's information as the website, format not enforced Publicly available A JSON string when category is one of: "Product/service" and has content
username The human-friendly username of this object (alternative to the id) Publicly available A JSON string included if one exists
founded Information entered into page's information as "founded", usually a date but it's not enforced Publicly available A JSON string when category is one of: "Product/service" and has content
company_overview "Overview" information entered into the page's info Publicly available A JSON string when category is one of: "Product/service" and has content
mission "mission" information entered into the page's info Publicly available A JSON string when category is one of: "Product/service" and has content
likes [was fan_count] * The number of users who like the Page Publicly available A JSON number always included
type object type Publicly available A JSON string included when passed GET variable metadata=1 example
location associated location Publicly available A JSON object included if value exists
birthday associated birthdate Publicly available A JSON string included if value exists
personal_info Publicly available A JSON string included if value exists
      • Need to list all possible values and which page categories they exist under... unfortunately can only be done by trying random pages. --Wong 14:35, 29 March 2011 (UTC)


Connections

Name Description Permissions Returns
feed The Page's wall Available to everyone on Facebook A JSON Array of Post objects
picture The Page's profile picture Publicly available Returns a HTTP 302 with the URL of the user's profile picture. This way you can include this directly in an img tag and have it display properly.
tagged The photos, videos, and posts in which this Page has been tagged Publicly available An heterogeneous array of Photo, Video or Post objects
links * The Page's posted links Available to everyone on Facebook An array of Link objects
photos * The photos this Page has uploaded Publicly available An array of Photo objects
groups * The groups this Page is a member of Available to everyone on Facebook An array of JSON objects containing group id, version, name and unread fields
albums * The photo albums this Page has created Publicly available An array of Album objects
statuses * The Page's status updates Available to everyone on Facebook An array of Status message objects
videos * The videos this Page has created Available to everyone on Facebook An array of Video objects
notes * The Page's notes Available to everyone on Facebook An array of Note objects
posts * The Page's own posts Publicly available An array of Post objects
events * The events this Page is attending Available to everyone on Facebook
checkins Checkins made by friends of the current session user Requires friends_checkins permissions An array of Checkin objects
members "(#604) Your statement is not indexable. The WHERE clause must contain an indexable column. Such columns are marked with * in the tables linked from http://developers.facebook.com/docs/reference/fql " See filed bug related to page/members
tabs The Page's profile tabs Page admin access_token array of objects containing id, name, link, application, custom_name, is_permanent, position, and is_non_connection_landing_tab.

Notes

From a comment on the official docs:

Yes you can post feed to any page after taking the publish stream extented permission from any account.
$Attachment = array('message' => $_POST['postText']);.
$Result = $facebook->api('/'.$page_id.'/feed/', 'post', $attachment);
Personal tools
Namespaces
Variants
Actions
Navigation
Graph API
FQL
Toolbox