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

video_tag

API Reference › FQL › video_tag

Description

An FQL table containing information about a video tag. The video_tag table can be used to find all users tagged in a specific video, or all videos that a user has been tagged in. video_tag uses the same visibility constraints as video, so a user can see a video tag if and only if that user can see the video itself.

Columns

NameDescription

created_time

number

The date when the video being queried was added.

subject

numeric string

For tagged users, use the user ID of the subject for the tag being queried. For videos associated with events or groups, use the event ID or group ID for subject.

updated_time

number

The date when the video being queried was last modified.

vid

numeric string

The ID of the video being queried. The vid cannot be longer than 50 characters. Note: Because the vid is a string, you should always wrap the vid in quotes when referenced in a query.

Examples

  • SELECT ... FROM video_tag WHERE vid = A
  • SELECT ... FROM video_tag WHERE subject = A
Note: Additional filters on other columns can be specified but they may make the query less efficient.

Permissions

To read video_tag you need

  • Any valid access_token for Page owned videos
  • user_videos permissions for all videos owned by the user (including nonpublic videos)
  • friend_videos permissions for videos owned by the user's friends (including nonpublic videos that the friend has allowed the user to view)
Facebook © 2013 · English (US)
AboutAdvertisingCareersPlatform PoliciesPrivacy Policy