Facebook Developers
DocsToolsSupportNewsApps
Log In
  • Social Plugins
  • Facebook Login
  • Open Graph
  • Facebook APIs
    • Graph API
    • FQL
    • Open Graph
    • Dialogs
    • Chat
    • Internationalization
    • Ads
  • Games
  • Payments
  • App Center
  • Promote Your App
  • iOS
  • Android
  • JavaScript
  • PHP
  • More SDKs
  • 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
    • offsite_conversion_event
    • 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

application

API Reference › FQL › application

Description

An application as represented in FQL.

Columns

NameDescription

android_key_hash

array

Android key hash of the app.

api_key

string

The API key of the application being queried.

app_domains

array

Domains and subdomains this app can use. App access_token required.

app_id

numeric string

The ID of the application being queried.

app_name

string

Name of the app.

app_type

bool

Type of the app.

appcenter_icon_url

string

The URL identifying the hi-resolution version of the application's icon image

auth_dialog_data_help_url

string

The URL of a special landing page that helps users of an app begin publishing Open Graph activity. App access_token required.

auth_dialog_headline

string

One line description of an app that appears in the Auth Dialog. App access_token required; only returned if specifically requested via the fields URL parameter. string

auth_dialog_perms_explanation

string

The text to explain why an app needs additional permissions that appears in the Auth Dialog. App access_token required.

auth_referral_default_activity_privacy

string

The default privacy setting selected for Open Graph activities in the Auth Dialog. App access_token required; only returned if specifically requested via the fields URL parameter. string which is one of, SELF, EVERYONE, ALL_FRIENDS or NONE.

auth_referral_enabled

bool

Indicates whether Authenticated Referrals are enabled. App access_token required.

auth_referral_extended_perms

array

Extended permissions that a user can choose to grant when Authenticated Referrals are enabled. App access_token required.

auth_referral_friend_perms

array

Basic friends permissions that a user must grant when Authenticated Referrals are enabled. App access_token required.

auth_referral_response_type

string

The format that an app receives the Auth token from the Auth Dialog in. App access_token required; only returned if specifically requested via the fields URL parameter. string which is one of, code or token.

auth_referral_user_perms

array

Basic user permissions that a user must grant when Authenticated Referrals are enabled. App access_token required.

canvas_fluid_height

bool

Indicates whether app uses fluid or settable height values for Canvas. App access_token required.

canvas_fluid_width

bool

Indicates whether app uses fluid or fixed width values for Canvas. App access_token required.

canvas_url

string

The non-secure URL from which Canvas app content is loaded. App access_token required.

category

string

The category the application can be found under.

client_config

array

Config data for the client

company_name

string

The name of the company that built the application. Note: Only one of company_name and developers will contain data, never both.

configured_ios_sso

bool

True if the app has configured Single Sign On on iOS

contact_email

string

Email address listed for users to contact developers. App access_token required.

created_time

string

UNIX timestamp that indicates when the app was created. App access_token required.

creator_uid

string

User ID of the creator of this app. App access_token required.

daily_active_users

numeric string

The number of Facebook users who've used the application in the last day.

deauth_callback_url

string

URL that is pinged whenever a user removes the app. App access_token required.

description

string

The description of the application, as provided by the developer.

developers

array

A list of records, where each record identifies a Facebook user who is marked as a developer of the application. Note: Only one of company_name and developers will contain data, never both.

display_name

string

The name of the application.

hosting_url

string

Webspace created with one of our hosting partners for this app. App access_token required.

icon_url

string

The URL identifying the application's icon image.

ios_bundle_id

array

Bundle ID of the associated iOS app.

ipad_app_store_id

string

ID of the app in the iPad App Store. App access_token required.

iphone_app_store_id

string

ID of the app in the iPhone App Store. App access_token required.

is_facebook_app

bool

Whether or not the application is natively developed by Facebook.

link

string

Facebook profile link of the app.

logo_url

string

The URL identifying the application's logo image.

migration_status

array

Status of every valid migration for this app (true means enabled.)

mobile_profile_section_url

string

URL of the app section on a user's profile for the mobile site.

mobile_web_url

string

URL to which Mobile users will be directed when using the app. App access_token required.

monthly_active_users

numeric string

The number of Facebook users who've used the application in the last 30 days.

namespace

string

The string appended to apps.facebook.com/ to navigate to the application's canvas page.

page_tab_default_name

string

The title of the app when used in a Page Tab. App access_token required.

page_tab_url

string

The non-secure URL from which Page Tab app content is loaded. App access_token required.

privacy_policy_url

string

The URL that links to a Privacy Policy for the app. App access_token required.

profile_section_url

string

URL of the app section on a user's profile for the desktop site.

restriction_info

struct

Returns demographic restrictions for the app in a object with zero or more of the following fields: type, location, age, and age_distr. See restrictions field on the Graph API Application object for more information.

age

string

Age restrictions for the app

age_distribution

string

Age restrictions by locations

location

string

Location restrictions for the app

type

string

Custom made category restrictions for the app, such as alcohol restriction

secure_canvas_url

string

The secure URL from which Canvas app content is loaded. App access_token required.

secure_page_tab_url

string

The secure URL from which Page Tab app content is loaded. App access_token required.

server_ip_whitelist

string

App requests must originate from this comma-separated list of IP addresses. App access_token required.

social_discovery

bool

Indicates whether app usage stories show up in the Ticker or News Feed. App access_token required.

subcategory

string

The subcategory the application can be found under.

supports_attribution

bool

Indicates whether the app has opted out of app install tracking.

supports_implicit_sdk_logging

bool

Indicates whether the app has opted out of the mobile SDKs sending data on SDK interactions.

terms_of_service_url

string

URL to Terms of Service which is linked to in Auth Dialog. App access_token required.

url_scheme_suffix

string

user_support_email

string

Main contact email for this app. App access_token required.

user_support_url

string

URL of support for users of an app shown in Canvas footer. App access_token required.

website_url

string

URL of a website that integrates with this app. App access_token required.

weekly_active_users

numeric string

The number of Facebook users who've used the application in the last seven days.

Examples

  • SELECT ... FROM application WHERE app_id = A
  • SELECT ... FROM application WHERE api_key = A
  • SELECT ... FROM application WHERE namespace = A
Note: Additional filters on other columns can be specified but they may make the query less efficient.

Permissions

To read the application table you need

  • no access_token for all publicly available properties (indicated in the table below).
  • an app access_token for all properties for that app.
Facebook © 2013 · English (US)
AboutAdvertisingCareersPlatform PoliciesPrivacy Policy