Facebook Methods description: pages.getInfo

anna_150.jpg

Returns all visible pages according to the filters specified. This may be used to find all pages of which a user is a fan of, or to query specific page_ids. The session_key parameter is optional. When the session_key parameter is not passed, you can only get information for pages that have been added your application. The uid parameter is not even considered. With a session_key, normal privacy rules are put into place.

Parameters

 

string api_key The application key associated with the calling application.
string session_key The session key of the logged in user.
float call_id The request’s sequence number. Each successive call for any session must use a sequence number greater than the last. We suggest using the current time in milliseconds, such as PHP’s microtime(true) function.
string sig An MD5 hash of the current request and your secret key, as described in the authentication guide.
string v This must be set to 1.0 to use this version of the API.
string format Optional - desired response format. Either “XML” (default) or “JSON”.
string callback Optional - wrap the response inside a function call. This is primarily to enable cross-domain javascript requests using the <script> tag, sometimes known as “JSONP“. This works with both XML and JSON.
array fields List of desired fields in return. This is a comma-separated list of field strings.
array page_ids Optional - List of page ids. This is a comma_separated list of page ids.
int uid Optional - The id of the user. Defaults to the logged in user iff the session_key is valid, AND no page_ids are passed. Used to get the pages a given user is a fan of
string type Optional - Used to limit results to a single type of page. Note that it only applies when the uid applies because it’s not an indexable column of the page_fan table. If this parameter is passed without the page_id or uid parameter, it returns the pages the logged in user is a fan of of the given type. If this parameter is passed with the page_ids parameter WITHOUT a uid parameter, it’s not considered. Passed with the uid parameter, it works as earlier stated with the uid substituted for the logged in user.

Example Return XML

 

 

<?xml version="1.0" encoding="UTF-8"?>
<pages_getInfo_response xmlns="http://api.facebook.com/1.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://api.facebook.com/1.0/ http://api.facebook.com/1.0/facebook.xsd" list="true">
  <page>
    <page_id>4846711747</page_id>
    <name>Kronos Quartet</name>
    <pic_small>http://profile.ak.facebook.com/object2/283/56/t4846711747_9511.jpg</pic_small>
    <pic_big>http://profile.ak.facebook.com/object2/283/56/n4846711747_9511.jpg</pic_big>
    <pic_square>http://profile.ak.facebook.com/object2/283/56/q4846711747_9511.jpg</pic_square>
    <pic_large>http://profile.ak.facebook.com/object2/283/56/4846711747_9511.jpg</pic_large>
    <type>MUSICIANS</type>
    <website>http://www.kronosquartet.org</website>
    <has_added_app>0</has_added_app</>
    <genre/>
    <general_manager/>
    <band_members>David Harrington . Violin
John Sherba . Violin
Hank Dutt . Viola
Jeffrey Zeigler . Cello
</band_members>
    <bio>For more than 30 years, the Kronos Quartet has pursued a singular artistic vision with a spirit of fearless exploration. Through collaborating with many of the world.s most eclectic composers and performers, commissioning hundreds of works and arrangements for string quartet, performing thousands of concerts worldwide, and releasing more than 40 recordings of extraordinary breadth, Kronos has become one of the most influential groups of our time.

Kronos. expansive discography on Nonesuch Records includes Pieces of Africa, a showcase of African-born composers; a 2003 Grammy-winner, Alban Berg.s Lyric Suite; Nuevo, a Grammy- and Latin Grammy.nominated celebration of Mexican culture; and a ten-disc retrospective anthology, Kronos Quartet: 25 Years. Kronos. recordings have been featured prominently on numerous film soundtracks including Requiem for a Dream, The Fountain, 21 Grams, Heat, and True Stories.

Kronos. diverse repertoire includes music by 20th-century masters (Bartk, Webern), contemporary composers (Sofia Gubaidulina, Arvo Prt), jazz legends (Charles Mingus, Thelonious Monk), and artists from even farther afield (Jimi Hendrix, Pandit Pran Nath). Integral to Kronos. work is a series of long-running collaborations with many of the world.s foremost composers, including .Father of Minimalism. Terry Riley, Henryk Grecki, Philip Glass, Franghiz Ali-Zadeh, Steve Reich, and Osvaldo Golijov.

The numerous artists Kronos counts among its collaborators include Bollywood .playback singer. Asha Bhosle; American soprano Dawn Upshaw; Mexican rockers Caf  Tacuba; the Romanian gypsy band Taraf de Hadouks; and the unbridled British cabaret trio, the Tiger Lillies. Kronos has performed with icons Allen Ginsberg, Zakir Hussain, Modern Jazz Quartet, Tom Waits, Betty Carter, and David Bowie, and has appeared on recordings by Amon Tobin, Dan Zanes, DJ Spooky, Dave Matthews, Nelly Furtado, Rokia Traor , Joan Armatrading, Matmos, and Don Walser.

A non-profit organization based in San Francisco, the Kronos Quartet is committed to mentoring emerging musicians, and in 2007 Kronos led its first Professional Training Workshop with four string quartets at Carnegie Hall.  One of Kronos. most exciting initiatives is the Kronos: Under 30 Project, providing select musicians under 30 years old an opportunity to write music for Kronos.</bio>
    <hometown>San Francisco, CA</hometown>
    <current_location>San Francisco, CA</current_location>
    <record_label>Nonesuch</record_label>
    <booking_agent/>
    <artists_we_like/>
    <influences>Composers: John Adams, Alban Berg, John Cage, George Crumb, Philip Glass, Osvaldo Golijov, Michael Gordon, Henryk Gorecki, Sofia Gubaidulina, Jimi Hendrix, Clint Mansell, Matmos, Charles Mingus, Thelonious Monk, Mr. Bungle, Arvo Part, Astor Piazzolla, Steve Reich, Terry Riley, Alfred Schnittke, Dmitri Shostakovich, Sigur Ros, Peteris Vasks, Julia Wolfe, Frank Zappa, John Zorn

Collaborators: Asha Bhosle, David Bowie, Cafe Tacuba, Nelly Furtado, Allen Ginsberg, Huun Huur-Tu, Wu Man, Modern Jazz Quartet, Pandit Pran Nath, Taraf de Haidouks, Tiger Lillies, Rokia Traore, Dawn Upshaw, Tom Waits, Don Walser
</influences>
    <band_interests/>
   </page>
</pages_getInfo_response>

Response

The page info elements returned are those visible to the Facebook platform. Following is a list of arguments and the elements they return:

  • page_id - The id corresponding to the page returned. This is always returned (whether included in fields or not, and always as the first subelement.
  • name - Page entered profile field. May not be blank.
  • pic_small - URL of profile picture, with max width 50px and max height 150px. May be blank.
  • pic_square - URL of a square section of the profile picture, with width 50px and height 50px. May be blank.
  • pic_big - URL of profile picture with max width 200px and max height 600px. May be blank.
  • pic - URL of profile picture with max width 100px and max height 300px. May be blank.
  • pic_large - URL of profile picture with max width 396px and max height 1188px. May be blank
  • type - The type of page
  • website - Website of Page, may be blank
  • has_added_app - Bool (0 or 1) indicating whether the page has added the calling application
  • founded - When company was founded, may be blank
  • company_overview - Company overiew, may be blank
  • mission - Mission of company, may be blank
  • products - Company’s products, may be blank
  • location - Contains the lcoation of the entity. Applies to Local Businesses. Contains five children: street, city, state, country, zip
    Notes on each of the chiildren:

    • street may be blank
    • city may be blank
    • state is a well-defind two-letter American state or Canadian province abbreviation, and may be blank
    • country is well-defined, and may be blank.
    • zip is an integer, and is 0 if unspecified.
  • parking parking options available. Contains three children: street, lot, and valet.
    Notes on the children:

    • Each field returned is a boolean value (1 or 0) indicating if the Page has the specified parking option
  • public_transit - public transit details, e.g. Take Caltrain to Palo Alto station. Walk down Universty one block.
  • hours - Contains the operating hours. Each local business will be allowed to specify up to two sets of operating hours per day. Contains the following children, mon_1_open, mon_1_close, tue_1_open, tue_1_close, wed_1_open, wed_1_close, thu_1_open, thu_1_close, fri_1_open, fri_1_close, sat_1_open, sat_1_close, sun_1_open, sun_1_close, mon_2_open, mon_2_close, tue_2_open, tue_2_close, wed_2_open, wed_2_close, thu_2_open, thu_2_close, fri_2_open, fri_2_close, sat_2_open, sat_2_close, sun_2_open, sun_2_close.
    Notes on the children:

    • Each field is returned with time (in seconds since epoch). For example, 9.00AM is represented as 406800
  • attire - Restaurant recommended attire, may be one of Unspecfied, Casual, or Dressy
  • payment_options - Payment options accepted. Contains five children: cash_only, visa, amex, master_card, and discover.
    Notes on the children:

    • Each field returned is a boolean value (1 or 0) indicating if the Page accepts the given payment option.
    • Note that if cash_only is set to 1, the others would be set to 0.
  • culinary_team - Culinary team, may be blank
  • general_manager - General manager, may be blank
  • price_range - Price range, one of the following strings: “Unspecified”, “$ (0-10)”, “$$ (10-30)”, “$$$ (30-50)”, “$$$ (50+)”
  • restaurant_services - Other services offered by a restaurant. Contains the following children: reserve, walkins, groups, kids, takeout, delivery, catering, waiter, and outdoor.
    Notes on the children:

    • Each field returned is a boolean value (1 or 0)
  • restaurant_specialties - Restaurant specialties. Contains the following children: breakfast, lunch, dinner, coffee, and drinks.
    Notes on the children:

    • Each field returned is a boolean value (1 or 0)
  • release_date - Release date of film, may be blank
  • genre - Free form text field, genre of music, tv or film, may be blank
  • starring - Who’s starring in TV/Film, may be blank
  • screenplay_by - Screenplay of Film by, may be blank
  • directed_by - Who directed TV/Film, may be blank
  • produced_by - Who produced TV/Film, may be blank
  • studio - Studio Film was produced, may be blank
  • awards - Awards received by TV/Film, may be blank
  • plot_outline - Plot outline of TV/Film, may be blank
  • network - Network of TV show, may be blank
  • season - Season of TV show, may be blank
  • schedule - Schedule of TV show, may be blank
  • written_by - Who wrote TV/Film, may be blank
  • band_members - Members of the band, may be blank
  • hometown - hometown field, may be blank
  • current_location - current location, may be blank
  • record_label - record label, may be blank
  • booking_agent - boooking agent, may be blank
  • artists_we_like - Artists also liked by the musician, may be blank
  • influences - influences, may be blank
  • band_interests - band interests, may be blank
  • bio - biography field, may be blank
  • affilation - affiliation field of person or team, may be blank
  • birthday - birthday field, may be blank. In the format mm/dd/yyyy
  • personal_info - personal information of public figure, may be blank
  • personal_interests - personal interests of public figure, may be blank
  • members - members of team, may be blank
  • built - when automotive was built, may be blank
  • features - features of automotive, may be blank
  • mpg - mpg of automotive, may be blank
  • general_info - general info field, may be blank

FQL Equivalent

This function is similar to doing the following FQL query, with the appropriate parameters filled in:

 

SELECT fields FROM page WHERE page_id IN
(SELECT page_id FROM page_fan WHERE uid = uid AND type = type)

Error codes

1 An unknown error occurred. Please resubmit the request.
2 The service is not available at this time.
4 The application has reached the maximum number of requests allowed. More requests are allowed once the time window has completed.
5 The request came from a remote address not allowed by this application.
100 One of the parameters specified was missing or invalid.
101 The api key submitted is not associated with any known application.
102 The session key was improperly submitted or has reached its timeout. Direct the user to log in again to obtain another key.
103 The submitted call_id was not greater than the previous call_id for this session.
104 Incorrect signature.

Source page

Tags: ,

Related Post

March 8th, 2008
Categories: Apps development, Facebook Methods . Author: admin

No Comments

No comments yet.

Comments RSS TrackBack Identifier URI

Leave a comment

Facebook Methods description: users.isAppAdded Facebook Hack Tutorial: How to View Bigger Size Picture From Small Private Profiles Picture Without Losing in Resolution
SRTH SRTH