Facebook API Data Model

actions

string

Actions

☐

Action links.

admin_creator

string

itgen_facebook_admin_creator

☐

The admin creator of a Page post. If the Page has only one admin, no data will be returned. Requires a Page Access Token and the business_management permission.

application_an_ad_space_limit

int32

itgen_facebook_application_an_ad_space_limit

☐

The maximum number of Ad Spaces allowed for each Audience Network supported platform.

application_app_install_tracked

boolean

itgen_facebook_application_app_install_tracked

☐

Whether the app install is trackable or not.

application_app_name

string

itgen_facebook_application_app_name

☐

Application name.

application_app_type

int32

itgen_facebook_application_app_type

☐

Type.

application_auth_dialog_data_help_url

string

itgen_facebook_application_auth_dialog_data_help_url

☐

The URL of a special landing page that helps people who are using an app begin publishing Open Graph activity.

application_auth_dialog_headline

string

itgen_facebook_application_auth_dialog_headline

☐

One line description of an app that appears in the Login Dialog.

application_auth_dialog_perms_explanation

string

itgen_facebook_application_auth_dialog_perms_explanation

☐

The text to explain why an app needs additional permissions. This appears in the Login Dialog.

application_auth_referral_default_activity_privacy

string

itgen_facebook_application_auth_referral_default_activity_privacy

☐

The default privacy setting selected for Open Graph activities in the Auth Dialog.

application_auth_referral_enabled

int32

itgen_facebook_application_auth_referral_enabled

☐

Indicates whether Authenticated Referrals are enabled.

application_auth_referral_response_type

string

itgen_facebook_application_auth_referral_response_type

☐

The format that an app receives for the authentication token from the Login Dialog.

application_canvas_fluid_height

boolean

itgen_facebook_application_canvas_fluid_height

☐

Indicates whether the app uses fluid or settable height values for Canvas.

application_canvas_fluid_width

int32

itgen_facebook_application_canvas_fluid_width

☐

Indicates whether the app uses fluid or fixed width values for Canvas.

application_canvas_url

string

itgen_facebook_application_canvas_url

☐

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

application_category

string

itgen_facebook_application_category

☐

The category of the app.

application_client_config

string

itgen_facebook_application_client_config

☐

Config data for the client.

application_company

string

itgen_facebook_application_company

☐

The company the app belongs to.

application_configured_ios_sso

boolean

itgen_facebook_application_configured_ios_sso

☐

True if the app has configured Single Sign On on iOS.

application_contact_email

string

itgen_facebook_application_contact_email

☐

Email address listed for people using the app to contact developers.

application_created_time

datetime

itgen_facebook_application_created_time

☐

Timestamp that indicates when the app was created.

application_creator_uid

decimal

itgen_facebook_application_creator_uid

☐

User ID of the creator of this app.

application_daily_active_users

int32

itgen_facebook_application_daily_active_users

☐

The number of daily active users the app has.

application_daily_active_users_rank

int32

itgen_facebook_application_daily_active_users_rank

☐

Ranking of this app vs other apps comparing daily active users.

application_deauth_callback_url

string

itgen_facebook_application_deauth_callback_url

☐

URL that is pinged whenever a person removes the app.

application_default_share_mode

string

itgen_facebook_application_default_share_mode

☐

The platform that should be used to share content.

application_description

string

itgen_facebook_application_description

☐

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

application_financial_id

string

itgen_facebook_application_financial_id

☐

The ID for the corresponding audience network financial entity.

application_hosting_url

string

itgen_facebook_application_hosting_url

☐

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

application_icon_url

string

itgen_facebook_application_icon_url

☐

The URL of this app's icon.

application_id

decimal

itgen_facebook_application_id

☐

The app ID.

application_ios_bundle_id

string

itgen_facebook_application_ios_bundle_id

☐

List of bundle IDs of the associated iOS app.

application_ios_supports_native_proxy_auth_flow

boolean

itgen_facebook_application_ios_supports_native_proxy_auth_flow

☐

Whether to support the native proxy login flow.

application_ios_supports_system_auth

boolean

itgen_facebook_application_ios_supports_system_auth

☐

Whether to support the iOS integrated Login Dialog.

application_ipad_app_store_id

string

itgen_facebook_application_ipad_app_store_id

☐

ID of the app in the iPad App Store.

application_iphone_app_store_id

string

itgen_facebook_application_iphone_app_store_id

☐

ID of the app in the iPhone App Store.

application_is_viewer_admin

boolean

itgen_facebook_application_is_viewer_admin

☐

Test if viewer is one of admins of this app.

application_link

string

itgen_facebook_application_link

☐

A link to the app on Facebook.

application_logging_token

string

itgen_facebook_application_logging_token

☐

To use for logging purposes.

application_logo_url

string

itgen_facebook_application_logo_url

☐

The URL of the app's logo.

application_migrations

string

itgen_facebook_application_migrations

☐

List of statuses of migrations for this app.

application_mobile_profile_section_url

string

itgen_facebook_application_mobile_profile_section_url

☐

Mobile URL of the app section on a person's profile.

application_mobile_web_url

string

itgen_facebook_application_mobile_web_url

☐

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

application_monthly_active_users

int32

itgen_facebook_application_monthly_active_users

☐

The number of monthly active users the app has.

application_monthly_active_users_rank

int32

itgen_facebook_application_monthly_active_users_rank

☐

Ranking of this app vs other apps comparing monthly active users.

application_name

string

itgen_facebook_application_name

☐

The name of the app.

application_namespace

string

itgen_facebook_application_namespace

☐

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

application_page_tab_default_name

string

itgen_facebook_application_page_tab_default_name

☐

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

application_page_tab_url

string

itgen_facebook_application_page_tab_url

☐

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

application_photo_url

string

itgen_facebook_application_photo_url

☐

The URL of the app photo.

application_privacy_policy_url

string

itgen_facebook_application_privacy_policy_url

☐

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

application_profile_section_url

string

itgen_facebook_application_profile_section_url

☐

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

application_property_id

string

itgen_facebook_application_property_id

☐

The monetization property which owns this app.

application_real_time_mode_devices

string

itgen_facebook_application_real_time_mode_devices

☐

List of real time hashed device.

application_secure_canvas_url

string

itgen_facebook_application_secure_canvas_url

☐

The secure URL from which Canvas app content is loaded.

application_secure_page_tab_url

string

itgen_facebook_application_secure_page_tab_url

☐

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

application_server_ip_whitelist

string

itgen_facebook_application_server_ip_whitelist

☐

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

application_social_discovery

int32

itgen_facebook_application_social_discovery

☐

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

application_subcategory

string

itgen_facebook_application_subcategory

☐

The subcategory the app can be found under.

application_supported_platforms

string

itgen_facebook_application_supported_platforms

☐

All the platform the app supports: WEB, CANVAS, MOBILE_WEB, IPHONE, IPAD, ANDROID, WINDOWS, AMAZON, SUPPLEMENTARY_IMAGES, GAMEROOM, INSTANT_GAME.

application_terms_of_service_url

string

itgen_facebook_application_terms_of_service_url

☐

URL to Terms of Service that appears in the Login Dialog.

application_url_scheme_suffix

string

itgen_facebook_application_url_scheme_suffix

☐

URL scheme suffix.

application_user_support_email

string

itgen_facebook_application_user_support_email

☐

Main contact email for this app where people can receive support.

application_user_support_url

string

itgen_facebook_application_user_support_url

☐

URL shown in the Canvas footer that people can visit to get support for the app.

application_website_url

string

itgen_facebook_application_website_url

☐

URL of a website that integrates with this app.

application_weekly_active_users

int32

itgen_facebook_application_weekly_active_users

☐

The number of weekly active users the app has.

attachments

string

itgen_facebook_attachments

☐

Any attachments that are associated with the story.

backdated_time

datetime

itgen_facebook_backdated_time

☐

The backdated time for backdate post. For regular post, this field will be set to null.

call_to_action

string

itgen_facebook_call_to_action

☐

The call to action type used in any Page posts for mobile app engagement ads.

caption

string

itgen_facebook_caption

☐

Link caption in post that appears below name. The caption must be an actual URLs and should accurately reflect the URL and associated advertiser or business someone visits when they click on it.

child_attachments

string

itgen_facebook_child_attachments

☐

Sub-shares of a multi-link share post.

created_time

datetime

Created

☐

The time the post was initially published. For a post about a life event, this will be the date and time of the life event.

description

string

Description

☐

A description of a link in the post(appears beneath the caption).

feed_targeting

string

itgen_facebook_feed_targeting

☐

Object that controls news feed targeting for this post.Anyone in these groups will be more likely to see this post, others will be less likely, but may still see it anyway.Any of the targeting fields shown here can be used, none are required(applies to Pages only).

from

string

itgen_facebook_from

☐

Information (name and id) about the Profile that created the Post. If you read this field with a user access token, it returns only the current user.

full_picture

string

itgen_facebook_full_picture

☐

URL to a full-sized version of the Photo published in the Post or scraped from a link in the Post. If the photo's largest dimension exceeds 720 pixels, it will be resized, with the largest dimension set to 720.

icon

string

Icon

☐

A link to an icon representing the type of this pos.

id

string

ID

☐

The post ID.

instagram_eligibility

string

itgen_facebook_instagram_eligibility

☐

Whether the post can be promoted on Instagram. It returns the enum 'eligible' if it can be promoted. Otherwise it returns an enum for why it cannot be promoted.

is_hidden

boolean

Is Hidden

☐

Whether this post can be promoted in Instagram.

is_published

boolean

Is Published

☐

Indicates whether a scheduled post was published (applies to scheduled Page Post only, for users post and instantly published posts this value is always true).Note that this value is always false for page posts created as part of the Ad Creation process.

link

string

itgen_facebook_link

☐

The link attached to this post.

message

string

itgen_facebook_message

☐

The status message in the post.

message_tags

string

itgen_facebook_message_tags

☐

An array of profiles tagged in the message text. If you read this field with a user user access token, it returns only the current user.

name

string

Name

☐

The name of the link.

object_id

string

Object ID

☐

The ID of any uploaded photo or video attached to the post.

parent_id

string

itgen_facebook_parent_id

☐

The ID of a parent post for this post, if it exists. For example, if this story is a 'Your Page was mentioned in a post' story, the parent_id will be the original post where the mention happened.

permalink_url

string

itgen_facebook_permalink_url

☐

URL to the permalink page of the post.

picture

string

Picture

☐

URL to a resized version of the Photo published in the Post or scraped from a link in the Post. If the photo's largest dimension exceeds 130 pixels, it will be resized, with the largest dimension set to 130.

place_id

decimal

Place ID

☐

The place ID.

place_name

string

Place Name

☐

Name.

place_overall_rating

double

itgen_facebook_place_overall_rating

☐

Overall Rating of Place, on a 5-star scale. 0 means not enough data to get a combined rating.

privacy

string

Privacy

☐

The privacy settings of the post.

promotion_status

string

itgen_facebook_promotion_status

☐

Status of the promotion. Requires Page admin privileges. Possible values: active = Promotion is currently running, draft = Promotion is still in draft mode, extendable = Promotion's campaign has ended but can be restarted, finished = Promotion has ended, inactive = No active promotion, ineligible = Post is ineligible for boosting, learn why the post may be ineligible,paused = Promotion is currently paused, pending = Promotion is still under review, rejected = Promotion was rejected by the review process.

properties

string

itgen_facebook_properties

☐

A list of properties for any attached video, for example, the length of the video.

shares

string

Shares

☐

The shares count of this post. The share count may include deleted posts and posts you cannot see for privacy reasons.

source

string

Source

☐

A URL to any Flash movie or video file attached to the post.

status_type

string

itgen_facebook_status_type

☐

Description of the type of a status update: mobile_status_update, created_note, added_photos, added_video, shared_story, created_group, created_event, wall_post, app_created_story, published_story, tagged_in_photo, approved_friend.

targeting

string

itgen_facebook_targeting

☐

Object that limits the audience for this content.Only audiences in the specified demographics can view this content.The demographics are additive.Each additional value adds its audience to the cumulative targeted audience.These values do not override any Page-level demographic restrictions that may be in place.

to

string

itgen_facebook_to

☐

Profiles mentioned or targeted in this post. If you read this field with a user access token, it returns only the current user.

type

string

Type

☐

A string indicating the object type of this post: link, status, photo, video, offer.

updated_time

datetime

Updated

☐

This field's behavior depends on the type of object the Post is on. Group Posts: Time when the Post was created or commented upon, Page Posts: Time when the Post was created, edited, or commented upon, User Posts: Time when the Post was created, edited, or commented upon.

with_tags

string

itgen_facebook_with_tags

☐

Profiles tagged as being 'with' the publisher of the post. If you read this field with a user access token, it returns only the current user.