The Graph API Search interface has changes pending with the Q3 2013 migration. Please see the blog post for more information on what's changed. Changes listed in the blog post will go live on July 10th, 2013.
In this document:
You can search over all public objects in the social graph with
https://graph.facebook.com/search. The format is:
All Graph API search queries require an access token passed in with the
access_token=<token> parameter. The type of access token you need depends on the type of search you're executing.
placeobjects requires an app access token.
We support search for the following types of objects:
centerparameter (with latitude and longitude) and an optional
type=locationand add the
type=locationand specify the ID of the
place. For example for Posts at Facebook HQ, use: https://graph.facebook.com/search?type=location&place=166793820034304
You can restrict the fields returned by these searches using the
?fields= URL parameter, in the same way you can when reading other objects. For example, to get only the names of events, you can do the following:
Some fields such as
start_time for events, are always returned.
You can also search an individual user's News Feed, restricted to that user's friends, by adding a
q argument to the
home connection URL:
/me/home retrieves an outdated view of the News Feed. This is currently a known issue and we don't have any near term plans to bring them back up into parity.
When searching for public posts or posts on the user's News Feed, you can page over the results by using the
until both accept a unix timestamp. When paging back in time, you should use
until in conjunction with
until is the unixtime value of the
created_time field in the last object returned by your previous query. When paging forward in time you should set
since to be the unixtime value of the
created_time field in the first object returned by your previous query. Please note, you can only search about 1 to 2 weeks back in the News Feed.