Flockler API v1
Introduction Articles Sections Sites Images

Attachment fields descriptions

Below you will find descriptions for the following article attachments:

Facebook post

Field Data type Description Values
commenting_post_id_str string
created_time datetime Post creation time in Facebook
from_id_str string ID of the creator of this post in Facebook
from_name string Name of the creator of this post in Facebook
link string URL of the posted link
link_caption string Caption of the link preview image
link_description string Description of the link preview
link_name string Title of the link preview
message string Content of the post
object_id string ID of the object (in Facebook) that has been attached to the post
picture string URL of the thumbnail of the photo, video or link preview
post_id_str string ID of this post (in Facebook)
post_type string Type of the post post, status, comment, link, photo, video, app_created_story
picture_attachments array of embedded attachments Picture attachments in the post
Facebook Post Picture attachments
Field Data type Description Values
url string Facebook URL of attachment
type string Type of attachment photo
image_height integer Height of image in pixels
image_width integer Width of image in pixels
image_src string URL of attached image file
target_id string ID of resource the attachment points to 
facebook_post: {
    commenting_post_id_str: "",
    created_time: "2015-01-14T06:01:46+0000",
    from_id_str: "188243277870846",
    from_name: "Flockler",
    link: "https://www.facebook.com/flockler/photos/a.213749671986873.64920.188243277870846/970032819691884/?type=1",
    link_caption: "",
    link_description: "",
    link_name: "",
    message: "http://eepurl.com/79-t5 - Download Free Content Marketing Book - The Content",
    object_id: "970032819691884",
    picture: "https://fbcdn-sphotos-d-a.akamaihd.net/hphotos-ak-xpf1/v/t1.0-9/16508_970032819691884_5848541574316189968_n.jpg?oh=19298e9cb79c90bf8003d179d52747f4&oe=5593C8D1&__gda__=1433682746_60e2ac3e4547b2c11f0a8ca4efdf7ada",
    post_id_str: "188243277870846_970032949691871",
    post_type: "photo",
    picture_attachments: [
        {
            "url": "https://www.facebook.com/787774564620625/photos/a.965216176876462.1073741827.787774564620625/965295190201894/?type=3",
            "type": "photo",
            "image_height": 454,
            "image_src": "https://scontent.xx.fbcdn.net/hphotos-xpt1/v/t1.0-9/s720x720/12108232_965295190201894_8450402027683822787_n.jpg?oh=88f8c22791b03c09e83271b35696106d&oe=568C3A4A",
            "image_width": 720,
            "target_id": "965295190201894"
        }
    ]
}

Tweet

Field Data type Description Other possible values in addition to data type
created_at string UTC time when this tweet was created straight from Twitter API. Format is dictated by Twitter. “Wed Aug 27 13:08:45 +0000 2013”, “2016-05-05 12:45:23”
media_url string URL to the image or video embedded to the tweet
name string Username of the tweet creator in Twitter
oembed string Embedded representation of the tweet in oEmbed format
profile_image_url string URL to the profile picture of the item creator in Twitter
profile_url string URL to the profile of the item creator in Twitter
retweet_of_id string ID of the original tweet that has been retweeted
screen_name string Username of the tweeter of this tweet in Twitter
text string Content of the tweet
tweet_id_str string ID of this tweet in Twitter
user_id_str string ID of the tweeter in Twitter
url string URL to the original tweet in Twitter 
tweet: {
    created_at: "2015-03-03 13:01:55",
    media_url: null,
    name: "Social Orra",
    oembed: "<blockquote class="twitter-tweet"><p>5 Great Tips To Improve Your Social Media Contest Engagement. <a href="https://twitter.com/hashtag/contentmarketing?src=hash">#contentmarketing</a> <a href="http://t.co/eaWuKA2SuC">http://t.co/eaWuKA2SuC</a></p>&mdash; Social Orra (@SocialOrra) <a href="https://twitter.com/SocialOrra/status/572743707117674497">March 3, 2015</a></blockquote> <script async src="//platform.twitter.com/widgets.js" charset="utf-8"></script>",
    profile_image_url: "https://flockler.com/thumbs/twitter_profile_images/2426336588_s48x48.png",
    profile_url: "https://twitter.com/SocialOrra",
    retweet_of_id: null,
    screen_name: "SocialOrra",
    text: "5 Great Tips To Improve Your Social Media Contest Engagement. #contentmarketing http://t.co/eaWuKA2SuC",
    tweet_id_str: "572743707117674497",
    user_id_str: "2426336588",
    url: "https://twitter.com/SocialOrra/status/572743707117674497"
}

Instagram

Field Data type Description Other possible values in addition to data type
caption string Caption of the item null
created_time datetime Creation time in Instagram
link string Link to the original item in Instagram
media_id string ID of this item in Instagram
media_type string Type of the item
Values: image, video
profile_picture string URL to the profile picture of the item creator in Instagram
user_full_name string Full name of the item creator in Instagram
user_id string User_id of the item creator in Instagram
username string Username of the item creator in Instagram
users_in_photo array of object Array of Instagram users tagged in the photo.
Note that this field does not contain any users tagged in the caption or comments.
video_low_resolution string URL to the low resolution version of the item.
Note that this URL expires on its own and will be null after expiration. Avoid use in production.		 null
video_low_resolution_expires_at datetime URL expiration time null
video_standard_resolution string URL to the standard resolution version of the item.
Note that this URL expires on its own and will be null after expiration. Avoid use in production.		 null
video_standard_resolution_expires_at datetime URL expiration time null 
instagram_item: {
    caption: "Social Media Tune-Up: If your business treats social media like a chore then your fans and followers will probably think your brand is a bore. For more #SM4Biz tips --> http://buff.ly/1CVycRk",
    created_time: "2015-03-02T20:46:07Z",
    link: "https://instagram.com/p/zvT4H5DiCF/",
    media_id: "932051067536810117_596700903",
    media_type: "image",
    profile_picture: "https://flockler.com/thumbs/instagram_profile_images/596700903_s48x48.jpg",
    user_full_name: "Richie Kawamoto",
    user_id: "596700903",
    username: "richiekawamoto",
    video_low_resolution: null,
    video_standard_resolution: null
}

Video

Field Data type Description Other possible values in addition to data type
cover_url string Url to the full size version of the cover image, see Image resizing
embed_src string URL to the embedded version of the video
original_url string URL to the original video
service string Name of the service video is from
username string Username of the uploader of the video 
video: {
  cover_url: "https://flockler.com/files/3141/beg-ly9tqgk.jpg",
  embed_src: "https://www.youtube.com/embed/BEG-ly9tQGk",
  original_url: "https://youtube.com/watch?v=BEG-ly9tQGk",
  service: "youtube",
  username: "larsandersen23"
}