Facebook Developers
DocsToolsSupportNewsApps
Log In
  • Social Plugins
  • Facebook Login
  • Open Graph
  • Facebook APIs
    • Graph API
    • FQL
    • Open Graph
    • Dialogs
    • Chat
    • Internationalization
    • Ads
  • Games
  • Media
  • Payments
  • App Center
  • Promote Your App
  • iOS
  • Android
  • Web
  • Technology Partners
  • Tables
    • album
    • app_role
    • application
    • apprequest
    • checkin
    • comment
    • comments_info
    • connection
    • cookies
    • column
    • developer
    • domain
    • domain_admin
    • event
    • event_member
    • family
    • friend
    • friendlist
    • friendlist_member
    • friend_request
    • group
    • group_member
    • insights
    • like
    • link
    • link_image_src
    • link_stat
    • location_post
    • mailbox_folder
    • message
    • note
    • notification
    • object_url
    • page
    • page_admin
    • page_blocked_user
    • page_global_brand_child
    • page_fan
    • page_milestone
    • permissions
    • permissions_info
    • photo
    • photo_src
    • photo_tag
    • place
    • privacy
    • privacy_setting
    • profile
    • profile_tab
    • profile_view
    • question
    • question_option
    • question_option_votes
    • review
    • score
    • standard_friend_info
    • standard_user_info
    • status
    • stream
    • stream_filter
    • stream_tag
    • subscription
    • table
    • thread
    • translation
    • unified_message
    • unified_message_count
    • unified_message_sync
    • unified_thread
    • unified_thread_action
    • unified_thread_count
    • unified_thread_sync
    • url_like
    • user
    • video
    • video_tag

friendlist

API Reference › FQL › friendlist

Description

An FQL table which returns any friend lists created by the current session user.

Columns

NameDescription

count

unsigned int32

The number of members in the friendlist that the flid specifies

flid

string

The ID of the friend list. Note: This is only indexable for friend lists belonging to the current session user

name

string

The name of the friend list.

owner

id

The ID of the user who created the friend list.

owner_cursor

string

A cursor used to paginate through a query that is index on the owner

type

string

The type of the friends list; Possible values are: close_friends, acquaintances, restricted,user_created, education, work, current_city or family.

Examples

  • SELECT ... FROM friendlist WHERE flid = A
  • SELECT ... FROM friendlist WHERE owner = A
  • SELECT ... FROM friendlist WHERE owner = A AND type = B
Note: Additional filters on other columns can be specified but they may make the query less efficient.

Permissions

To read the friendlist table you need

  • read_friendlists [permissions][1] to query any friend list that belongs to the current session user.
Facebook © 2013 · English (US)
AboutAdvertisingCareersPlatform PoliciesPrivacy Policy