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

checkin

API Reference › FQL › checkin

Description

An FQL table that returns information about a checkin to a place.

Columns

NameDescription

app_id

id

The ID of an app that made the checkin.

author_uid

id

The ID of the user making the checkin.

checkin_id

id

The ID of the check-in.

coords

struct

The latitude and longitude of the location.

latitude

float (min: -90) (max: 90)

A float, in decimal degrees, describing the latitude. Minumum is -90.0, maximum is 90.0.

longitude

float (min: -180) (max: 180)

A float, in decimal, describing the longitude. Minumum is -180.0, maximum is 180.0.

altitude

float

A float, in meters, describing the altitude.

accuracy

float

A float, in meters, describing the accuracy.

altitudeAccuracy

float

A float describing the accuracy of the altitude.

heading

float

A double or null, in degrees, describing the heading direction calculated based on previous position.

speed

float

A double or null, in meters/second, describing the speed calculated based on previous position.

timestamp

timestamp

A UNIX timestamp for the time of the request

message

string

The message the author posted with the checkin.

post_id

string

The ID of the stream post created by the check-in

tagged_uids

array

The IDs of users tagged in the checkin.

target_id

id

The ID of Event or Page the user is checking into.

target_type

string

The type of the target for the checkin. This can beevent or page

timestamp

timestamp

A UNIX timestamp of the checkin.

Examples

  • SELECT ... FROM checkin WHERE checkin_id = A
  • SELECT ... FROM checkin WHERE author_uid = A
  • SELECT ... FROM checkin WHERE page_id = A
Note: Additional filters on other columns can be specified but they may make the query less efficient.

Permissions

To read checkins you need

  • the user_status permission to read the user's checkins.
  • the friends_status permission to read the user's friend's checkins.
Facebook © 2013 · English (US)
AboutAdvertisingCareersPlatform PoliciesPrivacy Policy