Featured Content

APIs to feature the best Content in your community, and retrieve it later for display or analysis.

Feature Content

posthttps://{networkName}.quill.fyre.co/api/v3.0/collection/{collectionId}/feature/{messageId}/

Features content (and posts it above the comment editor).

Path Parameters

name	required	type	description
collectionId	true	number	The Collection ID for which content will be featured. For example: '10633838'.
messageId	true	string	The ID of the content to feature.

Query Parameters

name	required	type	description
lftoken	true	string	A Livefyre Authentication token for the user featuring content. This is returned from the Auth endpoint.

Responses

200

Feature

Structure

property	type	description
status	string
code	string
data	null

Example application/json

{
  "status": "ok",
  "code": 200,
  "data": null
}

Unfeature Content

posthttps://{networkName}.quill.fyre.co/api/v3.0/collection/{collectionId}/unfeature/{messageId}/

Unfeatures content (and removes it from above the comment editor, and returns it to the stream).

Path Parameters

name	required	type	description
collectionId	true	number	The Collection ID for which content will be unfeatured. For example: '10633838'.
messageId	true	string	The ID of the content to unfeature.

Query Parameters

name	required	type	description
lftoken	true	string	A Livefyre Authentication token for the user unfeaturing content. This is returned from the Auth endpoint.

Responses

200

Unfeature

Structure

property	type	description
status	string
code	string
data	string

Example application/json

{
  "status": "ok",
  "code": 200,
  "data": null
}

Featured (Collection)

gethttps://{networkName}.bootstrap.fyre.co/bs3/v3.1/{network}/{siteId}/{b64articleId}/featured

Retrieves the most recent 50 pieces of featured content (and its authors) for the input Collection. (Use paging to return all content, rather than only the most recent 50.)

Path Parameters

name	required	type	description
network	true	number	Your Livefyre provided network. For example: labs.fyre.co.
b64articleId	true	string	The article ID you chose to uniquely identify a Collection in your site, encoded using Base64.
siteId	true	string	The Livefyre-provided ID for the website or application from which featured content will be pulled. For example: 303617.

Responses

200

Featured

Structure

property	type	description
paging	object
paging.hasPrev	boolean
paging.limit	number
data	object
data.content	array
data.content.[]	object	A snapshot of a Content item
data.content.[].source	integer	Content provided by Livefyre can originate from social providers other than Livefyre (e.g. Twitter, Facebook). The sources and the enumerated values that correspond to them are: Livefyre: 0, 4, 5, 8 Twitter: 1, 2, 7, 15, 20 Facebook: 3, 6, 14 Google Plus: 10 YouTube: 12, 16 RSS: 13 Instagram: 19
data.content.[].type	integer	Enum indicating the type of Content that this object is. 0: Message. This is the most common type of content, something posted by an author. 1: Opine. This is an opinion that an author has left about another piece of content. 2: Embed. An embedded image which is part of another Content item.
data.content.[].vis	integer	Enum indicating the visibility of the Content. Not all content is visible to everyone. For example, moderators can see content that has yet to be approved, and “bozod” content is visible only to their trollish authors. 0: None 1: Everyone. The Content is public. 2: Owner. Only the author of the Content can see the Content. 3: Group. Content is visible to the author of the Content and any moderators of the Collection that it is contained in.
data.content.[].collectionId	string	ID of a Collection that contains this Content item
data.content.[].content	object
data.content.[].content.bodyHtml	string	The main message of the Content, as an HTML string.
data.content.[].content.authorId	string	ID of the Author of this Content
data.content.[].content.parentId	string	If this Content is in reply to or a part of some other Content, then this will be the ID of that other Content. Otherwise, it will be an empty string.
data.content.[].content.updatedAt	number	Unix Epoch time of when this Content item was last updated
data.content.[].content.createdAt	number	Unix Epoch time of when this Content was first created
data.content.[].content.id	string	ID of this Content item
data.content.[].content.attachments	array
data.content.[].content.attachments.[]	object	http://oembed.com/
data.content.[].content.attachments.[].provider_url	string
data.content.[].content.attachments.[].title	string
data.content.[].content.attachments.[].url	string
data.content.[].content.attachments.[].type	string
data.content.[].content.attachments.[].thumbnail_width	number
data.content.[].content.attachments.[].height	number
data.content.[].content.attachments.[].width	number
data.content.[].content.attachments.[].version	string
data.content.[].content.attachments.[].link	string
data.content.[].content.attachments.[].author_name	string
data.content.[].content.attachments.[].provider_name	string
data.content.[].content.attachments.[].thumbnail_url	string
data.content.[].content.attachments.[].thumbnail_height	number
data.content.[].content.attachments.[].author_url	string
data.content.[].content.annotations	object
data.content.[].content.annotations.likedBy	array	Present when the Content has been liked
data.content.[].content.annotations.likedBy.[]	string	ID of Author who liked the Message
data.content.[].content.annotations.featuredmessage	object	Present when the Content has been featured
data.content.[].content.annotations.featuredmessage.authorId	string	ID of Author who featured the Content
data.content.[].content.annotations.featuredmessage.value	string	When featured from Livefyre Apps, this is the UNIX epoch time of when it was featured
data.content.[].content.annotations.featuredmessage.collectionId	string	ID of Livefyre Collection in which this Content is featured
data.content.[].content.annotations.geocode	object	Describes a location associated with the Content
data.content.[].content.annotations.geocode.latitude	number	latitude
data.content.[].content.annotations.geocode.longitude	number	longitude
data.authors	object
data.authors.additionalProperties	object
data.authors.additionalProperties.displayName	string
data.authors.additionalProperties.tags	array
data.authors.additionalProperties.tags.[]	string
data.authors.additionalProperties.profileUrl	string
data.authors.additionalProperties.avatar	string
data.authors.additionalProperties.type	number
data.authors.additionalProperties.id	string

Example application/json

{
  "paging": {
    "hasPrev": false,
    "limit": null
  },
  "data": {
    "content": [
      {
        "source": 19,
        "collectionId": "132677714",
        "collection": null,
        "content": {
          "attachments": [
            {
              "provider_url": "http://instagram.com",
              "title": "just got our cupcakes in, vanilla chocolate chip & double chocolate chip. #yummy #vegancupcake #dairyfree #crueltyfree #delicious #parkslope #brooklyn #theVspot @mrcarabano @alexcarabano @ziostefano",
              "url": "https://scontent.cdninstagram.com/hphotos-xaf1/t51.2885-15/s640x640/sh0.08/e35/11909349_493164437532074_903287131_n.jpg",
              "type": "photo",
              "thumbnail_width": 150,
              "height": 640,
              "width": 640,
              "version": "1.0",
              "link": "https://instagram.com/p/7qL_8gmDN8/",
              "author_name": "thevspotrestaurant",
              "provider_name": "Instagram",
              "thumbnail_url": "https://scontent.cdninstagram.com/hphotos-xfa1/t51.2885-15/s150x150/e35/c6.0.1068.1068/11950556_841625375936809_874759990_n.jpg",
              "thumbnail_height": 150,
              "author_url": "http://www.instagram.com/thevspotrestaurant"
            }
          ],
          "generator": {
            "id": "instagram.com"
          },
          "bodyHtml": "just got our cupcakes in, vanilla chocolate chip & double chocolate chip. #yummy #vegancupcake #dairyfree #crueltyfree #delicious #parkslope #brooklyn #theVspot @mrcarabano @alexcarabano @ziostefano",
          "annotations": {
            "featuredmessage": {
              "authorId": "TEMP-0b93dcdb2472d860@sales.fyre.co",
              "value": 1442337134,
              "collectionId": "132677714"
            },
            "geocode": {
              "latitude": 40.678052687,
              "longitude": -73.979415828
            }
          },
          "authorId": "414661547@instagram.com",
          "parentId": "",
          "updatedAt": 1442337155,
          "id": "instagram-1074724233891296124_414661547@instagram.com",
          "createdAt": 1442337134
        },
        "vis": 1,
        "type": 0,
        "event": 1442337845033953
      },
      {
        "erefs": [
          "M2KJJs0fxNKa5ZoxMg+kNqYWTacF76bsUMrJc7VazNlJknYymBP/EbSIe/Zrcgl7GbkbBoty/t7PfncMKTUCZzcIPk/TT9uV5XIXB3l9EZGb2I0588+cMNmL4NMjpiNUwkJY7w==",
          "u5xVwcUvddADfY2jrhqmgkETi4XzXOomas2646EX4m6k1tEQO0JcNgg5nQ5TKSXMYDG0AbfSf78kPhuKySQojfNiPLt4q+QutVdMam6r1u2EUfLYdNO3ZpB9bep1/4sGedS2Bg=="
        ],
        "source": 19,
        "collectionId": "132677714",
        "collection": null,
        "content": {
          "id": "instagram-987755210109869306_6402294@instagram.com",
          "createdAt": 1431969618,
          "parentId": ""
        },
        "vis": 3,
        "type": 0,
        "event": 1432053769522037
      }
    ],
    "authors": {
      "414661547@instagram.com": {
        "displayName": "Restaurant/Comedy Club",
        "tags": [],
        "profileUrl": "http://www.instagram.com/thevspotrestaurant",
        "avatar": "https://igcdn-photos-f-a.akamaihd.net/hphotos-ak-xfa1/t51.2885-19/11375249_171656349833669_472241260_a.jpg",
        "type": 8,
        "id": "414661547@instagram.com"
      }
    }
  }
}

Featured (Site)

gethttps://{networkName}.bootstrap.fyre.co/bs3/v3.1/{network}/{siteId}/featured

Retrieves the most recent 50 pieces of featured content (and its authors) for the input site. (Use paging to return all content, rather than only the most recent 50.)

Path Parameters

name	required	type	description
network	true	number	Your Livefyre provided network. For example: labs.fyre.co.
siteId	true	string	The Livefyre-provided ID for the website or application from which featured content will be pulled. For example: 303617.

Responses

200

Featured

Structure

property	type	description
paging	object
paging.hasPrev	boolean
paging.limit	number
data	object
data.content	array
data.content.[]	object	A snapshot of a Content item
data.content.[].source	integer	Content provided by Livefyre can originate from social providers other than Livefyre (e.g. Twitter, Facebook). The sources and the enumerated values that correspond to them are: Livefyre: 0, 4, 5, 8 Twitter: 1, 2, 7, 15, 20 Facebook: 3, 6, 14 Google Plus: 10 YouTube: 12, 16 RSS: 13 Instagram: 19
data.content.[].type	integer	Enum indicating the type of Content that this object is. 0: Message. This is the most common type of content, something posted by an author. 1: Opine. This is an opinion that an author has left about another piece of content. 2: Embed. An embedded image which is part of another Content item.
data.content.[].vis	integer	Enum indicating the visibility of the Content. Not all content is visible to everyone. For example, moderators can see content that has yet to be approved, and “bozod” content is visible only to their trollish authors. 0: None 1: Everyone. The Content is public. 2: Owner. Only the author of the Content can see the Content. 3: Group. Content is visible to the author of the Content and any moderators of the Collection that it is contained in.
data.content.[].collectionId	string	ID of a Collection that contains this Content item
data.content.[].content	object
data.content.[].content.bodyHtml	string	The main message of the Content, as an HTML string.
data.content.[].content.authorId	string	ID of the Author of this Content
data.content.[].content.parentId	string	If this Content is in reply to or a part of some other Content, then this will be the ID of that other Content. Otherwise, it will be an empty string.
data.content.[].content.updatedAt	number	Unix Epoch time of when this Content item was last updated
data.content.[].content.createdAt	number	Unix Epoch time of when this Content was first created
data.content.[].content.id	string	ID of this Content item
data.content.[].content.attachments	array
data.content.[].content.attachments.[]	object	http://oembed.com/
data.content.[].content.attachments.[].provider_url	string
data.content.[].content.attachments.[].title	string
data.content.[].content.attachments.[].url	string
data.content.[].content.attachments.[].type	string
data.content.[].content.attachments.[].thumbnail_width	number
data.content.[].content.attachments.[].height	number
data.content.[].content.attachments.[].width	number
data.content.[].content.attachments.[].version	string
data.content.[].content.attachments.[].link	string
data.content.[].content.attachments.[].author_name	string
data.content.[].content.attachments.[].provider_name	string
data.content.[].content.attachments.[].thumbnail_url	string
data.content.[].content.attachments.[].thumbnail_height	number
data.content.[].content.attachments.[].author_url	string
data.content.[].content.annotations	object
data.content.[].content.annotations.likedBy	array	Present when the Content has been liked
data.content.[].content.annotations.likedBy.[]	string	ID of Author who liked the Message
data.content.[].content.annotations.featuredmessage	object	Present when the Content has been featured
data.content.[].content.annotations.featuredmessage.authorId	string	ID of Author who featured the Content
data.content.[].content.annotations.featuredmessage.value	string	When featured from Livefyre Apps, this is the UNIX epoch time of when it was featured
data.content.[].content.annotations.featuredmessage.collectionId	string	ID of Livefyre Collection in which this Content is featured
data.content.[].content.annotations.geocode	object	Describes a location associated with the Content
data.content.[].content.annotations.geocode.latitude	number	latitude
data.content.[].content.annotations.geocode.longitude	number	longitude
data.authors	object
data.authors.additionalProperties	object
data.authors.additionalProperties.displayName	string
data.authors.additionalProperties.tags	array
data.authors.additionalProperties.tags.[]	string
data.authors.additionalProperties.profileUrl	string
data.authors.additionalProperties.avatar	string
data.authors.additionalProperties.type	number
data.authors.additionalProperties.id	string

Example application/json

{
  "paging": {
    "hasPrev": false,
    "limit": null
  },
  "data": {
    "content": [
      {
        "source": 19,
        "collectionId": "132677714",
        "collection": null,
        "content": {
          "attachments": [
            {
              "provider_url": "http://instagram.com",
              "title": "Take modern technique and improvisation class with Artistic Director, Taylor Donofrio! Class is held every Tuesday at 6:30pm in #ParkSlope #Brooklyn. Today marks the first class of the session! We hope to see you there! www.donofriodanceco.com/events  #class #moderntechnique #inthestudio #dance #Brooklyndance #sweat #move #learn #mindandbody #vscocam #spacefordance #Fallishere #livealive",
              "url": "https://scontent.cdninstagram.com/hphotos-xaf1/t51.2885-15/s640x640/sh0.08/e35/11820585_1495140967475672_1192251690_n.jpg",
              "type": "photo",
              "thumbnail_width": 150,
              "height": 640,
              "width": 640,
              "version": "1.0",
              "link": "https://instagram.com/p/7qNEiuiIlG/",
              "author_name": "donofriodanceco",
              "provider_name": "Instagram",
              "thumbnail_url": "https://scontent.cdninstagram.com/hphotos-xaf1/t51.2885-15/s150x150/e35/11820585_1495140967475672_1192251690_n.jpg",
              "thumbnail_height": 150,
              "author_url": "http://www.instagram.com/donofriodanceco"
            }
          ],
          "generator": {
            "id": "instagram.com"
          },
          "bodyHtml": "Take modern technique and improvisation class with Artistic Director, Taylor Donofrio! Class is held every Tuesday at 6:30pm in #ParkSlope #Brooklyn. Today marks the first class of the session! We hope to see you there! www.donofriodanceco.com/events  #class #moderntechnique #inthestudio #dance #Brooklyndance #sweat #move #learn #mindandbody #vscocam #spacefordance #Fallishere #livealive",
          "annotations": {
            "featuredmessage": {
              "authorId": "TEMP-0b93dcdb2472d860@sales.fyre.co",
              "value": 1442337695,
              "collectionId": "132677714"
            },
            "geocode": {
              "latitude": 40.6753387,
              "longitude": -73.9783783
            }
          },
          "authorId": "497670545@instagram.com",
          "parentId": "",
          "updatedAt": 1442337710,
          "id": "instagram-1074728947851757894_497670545@instagram.com",
          "createdAt": 1442337695
        },
        "vis": 1,
        "type": 0,
        "event": 1442337838589493
      },
      {
        "erefs": [
          "M2KJJs0fxNKa5ZoxMg+kNqYWTacF76bsUMrJc7VazNlJknYymBP/EbSIe/Zrcgl7GbkbBoty/t7PfncMKTUCZzcIPk/TT9uV5XIXB3l9EZGb2I0588+cMNmL4NMjpiNUwkJY7w==",
          "u5xVwcUvddADfY2jrhqmgkETi4XzXOomas2646EX4m6k1tEQO0JcNgg5nQ5TKSXMYDG0AbfSf78kPhuKySQojfNiPLt4q+QutVdMam6r1u2EUfLYdNO3ZpB9bep1/4sGedS2Bg=="
        ],
        "source": 19,
        "collectionId": "132677714",
        "collection": null,
        "content": {
          "id": "instagram-987755210109869306_6402294@instagram.com",
          "createdAt": 1431969618,
          "parentId": ""
        },
        "vis": 3,
        "type": 0,
        "event": 1432053769522037
      }
    ],
    "authors": {
      "497670545@instagram.com": {
        "displayName": "Donofrio Dance Company",
        "tags": [],
        "profileUrl": "http://www.instagram.com/donofriodanceco",
        "avatar": "https://igcdn-photos-e-a.akamaihd.net/hphotos-ak-xaf1/t51.2885-19/11856814_802209839897652_651365056_a.jpg",
        "type": 8,
        "id": "497670545@instagram.com"
      }
    }
  }
}

Featured (Network)

gethttps://{networkName}.bootstrap.fyre.co/bs3/v3.1/{network}/featured

Retrieves the most recent 50 pieces of featured content (and its authors) for the input network. (Use paging to return all content, rather than only the most recent 50.)

Path Parameters

name	required	type	description
network	true	number	Your Livefyre provided network. For example: labs.fyre.co.

Responses

200

Featured

Structure

property	type	description
paging	object
paging.hasPrev	boolean
paging.limit	number
data	object
data.content	array
data.content.[]	object	A snapshot of a Content item
data.content.[].source	integer	Content provided by Livefyre can originate from social providers other than Livefyre (e.g. Twitter, Facebook). The sources and the enumerated values that correspond to them are: Livefyre: 0, 4, 5, 8 Twitter: 1, 2, 7, 15, 20 Facebook: 3, 6, 14 Google Plus: 10 YouTube: 12, 16 RSS: 13 Instagram: 19
data.content.[].type	integer	Enum indicating the type of Content that this object is. 0: Message. This is the most common type of content, something posted by an author. 1: Opine. This is an opinion that an author has left about another piece of content. 2: Embed. An embedded image which is part of another Content item.
data.content.[].vis	integer	Enum indicating the visibility of the Content. Not all content is visible to everyone. For example, moderators can see content that has yet to be approved, and “bozod” content is visible only to their trollish authors. 0: None 1: Everyone. The Content is public. 2: Owner. Only the author of the Content can see the Content. 3: Group. Content is visible to the author of the Content and any moderators of the Collection that it is contained in.
data.content.[].collectionId	string	ID of a Collection that contains this Content item
data.content.[].content	object
data.content.[].content.bodyHtml	string	The main message of the Content, as an HTML string.
data.content.[].content.authorId	string	ID of the Author of this Content
data.content.[].content.parentId	string	If this Content is in reply to or a part of some other Content, then this will be the ID of that other Content. Otherwise, it will be an empty string.
data.content.[].content.updatedAt	number	Unix Epoch time of when this Content item was last updated
data.content.[].content.createdAt	number	Unix Epoch time of when this Content was first created
data.content.[].content.id	string	ID of this Content item
data.content.[].content.attachments	array
data.content.[].content.attachments.[]	object	http://oembed.com/
data.content.[].content.attachments.[].provider_url	string
data.content.[].content.attachments.[].title	string
data.content.[].content.attachments.[].url	string
data.content.[].content.attachments.[].type	string
data.content.[].content.attachments.[].thumbnail_width	number
data.content.[].content.attachments.[].height	number
data.content.[].content.attachments.[].width	number
data.content.[].content.attachments.[].version	string
data.content.[].content.attachments.[].link	string
data.content.[].content.attachments.[].author_name	string
data.content.[].content.attachments.[].provider_name	string
data.content.[].content.attachments.[].thumbnail_url	string
data.content.[].content.attachments.[].thumbnail_height	number
data.content.[].content.attachments.[].author_url	string
data.content.[].content.annotations	object
data.content.[].content.annotations.likedBy	array	Present when the Content has been liked
data.content.[].content.annotations.likedBy.[]	string	ID of Author who liked the Message
data.content.[].content.annotations.featuredmessage	object	Present when the Content has been featured
data.content.[].content.annotations.featuredmessage.authorId	string	ID of Author who featured the Content
data.content.[].content.annotations.featuredmessage.value	string	When featured from Livefyre Apps, this is the UNIX epoch time of when it was featured
data.content.[].content.annotations.featuredmessage.collectionId	string	ID of Livefyre Collection in which this Content is featured
data.content.[].content.annotations.geocode	object	Describes a location associated with the Content
data.content.[].content.annotations.geocode.latitude	number	latitude
data.content.[].content.annotations.geocode.longitude	number	longitude
data.authors	object
data.authors.additionalProperties	object
data.authors.additionalProperties.displayName	string
data.authors.additionalProperties.tags	array
data.authors.additionalProperties.tags.[]	string
data.authors.additionalProperties.profileUrl	string
data.authors.additionalProperties.avatar	string
data.authors.additionalProperties.type	number
data.authors.additionalProperties.id	string

Example application/json

{
  "paging": {
    "hasPrev": false,
    "limit": null
  },
  "data": {
    "content": [
      {
        "source": 19,
        "collectionId": "115007930",
        "collection": null,
        "content": {
          "attachments": [
            {
              "provider_url": "http://instagram.com",
              "title": "Harry Potter and the Goblet of Fire.",
              "url": "https://scontent.cdninstagram.com/hphotos-xaf1/t51.2885-15/s640x640/e15/11820456_903218793066632_2018970577_n.jpg",
              "type": "photo",
              "thumbnail_width": 150,
              "height": 640,
              "width": 640,
              "version": "1.0",
              "link": "https://instagram.com/p/6NyBUxyMuK/",
              "author_name": "koraliene",
              "provider_name": "Instagram",
              "thumbnail_url": "https://scontent.cdninstagram.com/hphotos-xaf1/t51.2885-15/s150x150/e15/11820456_903218793066632_2018970577_n.jpg",
              "thumbnail_height": 150,
              "author_url": "http://www.instagram.com/koraliene"
            }
          ],
          "generator": {
            "id": "instagram.com"
          },
          "bodyHtml": "Harry Potter and the Goblet of Fire.\n#harrypotter #thegobletoffire #trimagischesturnier #voldemort #liebe #avadakedavra #quidditch #KRUM! #todesser #deatheater #hermionegranger #ronweasley #darklord #eristwiederda #bartycrouchjr #madeye #dracomalfoy",
          "annotations": {
            "featuredmessage": {
              "authorId": "TEMP-58445cd4e57c1e76@sales.fyre.co",
              "value": 1439236506,
              "collectionId": "115007930"
            }
          },
          "authorId": "1716944657@instagram.com",
          "parentId": "",
          "updatedAt": 1439236535,
          "id": "instagram-1048714281602304906_1716944657@instagram.com",
          "createdAt": 1439236506
        },
        "vis": 1,
        "type": 0,
        "event": 1439236744110663
      },
      {
        "source": 0,
        "collectionId": "117213121",
        "collection": null,
        "content": {
          "attachments": [
            {
              "provider_url": "http://www.youtube.com/",
              "title": "GoPro: Shotgun Balloon Drop",
              "url": "http://www.youtube.com/watch?v=_hYC-ukmlU0",
              "type": "video",
              "html": "<iframe class=\"embedly-embed\" src=\"//cdn.embedly.com/widgets/media.html?src=http%3A%2F%2Fwww.youtube.com%2Fembed%2F_hYC-ukmlU0%3Fwmode%3Dtransparent%26feature%3Doembed&wmode=transparent&url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3D_hYC-ukmlU0&image=http%3A%2F%2Fi.ytimg.com%2Fvi%2F_hYC-ukmlU0%2Fhqdefault.jpg&key=9a490b23ba72460b82aa369e9dfb1234&type=text%2Fhtml&schema=youtube\" width=\"854\" height=\"480\" scrolling=\"no\" frameborder=\"0\" allowfullscreen></iframe>",
              "author_name": "GoPro",
              "height": 480,
              "width": 854,
              "version": "1.0",
              "link": "https://www.youtube.com/watch?v=_hYC-ukmlU0",
              "thumbnail_width": 480,
              "provider_name": "YouTube",
              "thumbnail_url": "http://i.ytimg.com/vi/_hYC-ukmlU0/hqdefault.jpg",
              "thumbnail_height": 360,
              "author_url": "http://www.youtube.com/user/GoProCamera"
            }
          ],
          "generator": {
            "id": "livefyre.com"
          },
          "bodyHtml": "<p>This is awesome <a href=\"https://www.youtube.com/watch?v=_hYC-ukmlU0\" target=\"_blank\" rel=\"nofollow\">https://www.youtube.com/watch?v=_hYC-ukmlU0</a></p>",
          "annotations": {
            "featuredmessage": {
              "authorId": "TEMP-2423f811d093a14f@sales.fyre.co",
              "value": 1428334500,
              "collectionId": "117213121"
            }
          },
          "authorId": "371505-jonkish21@sales.fyre.co",
          "parentId": "",
          "updatedAt": 1426798902,
          "id": "284414041",
          "createdAt": 1426798887
        },
        "vis": 1,
        "type": 0,
        "event": 1428334501094017
      }
    ],
    "authors": {
      "1716944657@instagram.com": {
        "displayName": "Karoline",
        "tags": [],
        "profileUrl": "http://www.instagram.com/koraliene",
        "avatar": "https://igcdn-photos-g-a.akamaihd.net/hphotos-ak-xfa1/t51.2885-19/11377913_116078835392886_1656868764_a.jpg",
        "type": 8,
        "id": "1716944657@instagram.com"
      },
      "371505-jonkish21@sales.fyre.co": {
        "displayName": "JonKish21",
        "tags": [],
        "profileUrl": "",
        "avatar": "https://dpstvy7p9whsy.cloudfront.net/a/anon/50.jpg",
        "type": 1,
        "id": "371505-jonkish21@sales.fyre.co"
      }
    }
  }
}

Featured (Head)

gethttps://{networkName}.bootstrap.fyre.co/bs3/{network}/{siteId}/{b64articleId}/featured-head.json

Retrieves the featured content presented in the top of a Collection.

Path Parameters

name	required	type	description
network	true	number	Your Livefyre provided network. For example: labs.fyre.co.
b64articleId	true	string	The article ID you chose to uniquely identify a Collection in your site, encoded using Base64.
siteId	true	string	The Livefyre-provided ID for the website or application from which featured content will be pulled. For example: 303617.

Responses

200

Featured

Structure

property	type	description
content	array
content.[]	object	A snapshot of a Content item
content.[].source	integer	Content provided by Livefyre can originate from social providers other than Livefyre (e.g. Twitter, Facebook). The sources and the enumerated values that correspond to them are: Livefyre: 0, 4, 5, 8 Twitter: 1, 2, 7, 15, 20 Facebook: 3, 6, 14 Google Plus: 10 YouTube: 12, 16 RSS: 13 Instagram: 19
content.[].type	integer	Enum indicating the type of Content that this object is. 0: Message. This is the most common type of content, something posted by an author. 1: Opine. This is an opinion that an author has left about another piece of content. 2: Embed. An embedded image which is part of another Content item.
content.[].vis	integer	Enum indicating the visibility of the Content. Not all content is visible to everyone. For example, moderators can see content that has yet to be approved, and “bozod” content is visible only to their trollish authors. 0: None 1: Everyone. The Content is public. 2: Owner. Only the author of the Content can see the Content. 3: Group. Content is visible to the author of the Content and any moderators of the Collection that it is contained in.
content.[].collectionId	string	ID of a Collection that contains this Content item
content.[].content	object
content.[].content.bodyHtml	string	The main message of the Content, as an HTML string.
content.[].content.authorId	string	ID of the Author of this Content
content.[].content.parentId	string	If this Content is in reply to or a part of some other Content, then this will be the ID of that other Content. Otherwise, it will be an empty string.
content.[].content.updatedAt	number	Unix Epoch time of when this Content item was last updated
content.[].content.createdAt	number	Unix Epoch time of when this Content was first created
content.[].content.id	string	ID of this Content item
content.[].content.attachments	array
content.[].content.attachments.[]	object	http://oembed.com/
content.[].content.attachments.[].provider_url	string
content.[].content.attachments.[].title	string
content.[].content.attachments.[].url	string
content.[].content.attachments.[].type	string
content.[].content.attachments.[].thumbnail_width	number
content.[].content.attachments.[].height	number
content.[].content.attachments.[].width	number
content.[].content.attachments.[].version	string
content.[].content.attachments.[].link	string
content.[].content.attachments.[].author_name	string
content.[].content.attachments.[].provider_name	string
content.[].content.attachments.[].thumbnail_url	string
content.[].content.attachments.[].thumbnail_height	number
content.[].content.attachments.[].author_url	string
content.[].content.annotations	object
content.[].content.annotations.likedBy	array	Present when the Content has been liked
content.[].content.annotations.likedBy.[]	string	ID of Author who liked the Message
content.[].content.annotations.featuredmessage	object	Present when the Content has been featured
content.[].content.annotations.featuredmessage.authorId	string	ID of Author who featured the Content
content.[].content.annotations.featuredmessage.value	string	When featured from Livefyre Apps, this is the UNIX epoch time of when it was featured
content.[].content.annotations.featuredmessage.collectionId	string	ID of Livefyre Collection in which this Content is featured
content.[].content.annotations.geocode	object	Describes a location associated with the Content
content.[].content.annotations.geocode.latitude	number	latitude
content.[].content.annotations.geocode.longitude	number	longitude
authors	object
authors.[]	object
authors.[].displayName	string
authors.[].tags	array
authors.[].tags.[]	string
authors.[].profileUrl	string
authors.[].avatar	string
authors.[].type	number
authors.[].id	string

Example application/json

{
  "content": [
    {
      "source": 19,
      "collectionId": "132677714",
      "collection": null,
      "content": {
        "attachments": [
          {
            "provider_url": "http://instagram.com",
            "title": "Take modern technique and improvisation class with Artistic Director, Taylor Donofrio! Class is held every Tuesday at 6:30pm in #ParkSlope #Brooklyn. Today marks the first class of the session! We hope to see you there! www.donofriodanceco.com/events  #class #moderntechnique #inthestudio #dance #Brooklyndance #sweat #move #learn #mindandbody #vscocam #spacefordance #Fallishere #livealive",
            "url": "https://scontent.cdninstagram.com/hphotos-xaf1/t51.2885-15/s640x640/sh0.08/e35/11820585_1495140967475672_1192251690_n.jpg",
            "type": "photo",
            "thumbnail_width": 150,
            "height": 640,
            "width": 640,
            "version": "1.0",
            "link": "https://instagram.com/p/7qNEiuiIlG/",
            "author_name": "donofriodanceco",
            "provider_name": "Instagram",
            "thumbnail_url": "https://scontent.cdninstagram.com/hphotos-xaf1/t51.2885-15/s150x150/e35/11820585_1495140967475672_1192251690_n.jpg",
            "thumbnail_height": 150,
            "author_url": "http://www.instagram.com/donofriodanceco"
          }
        ],
        "generator": {
          "id": "instagram.com"
        },
        "bodyHtml": "Take modern technique and improvisation class with Artistic Director, Taylor Donofrio! Class is held every Tuesday at 6:30pm in #ParkSlope #Brooklyn. Today marks the first class of the session! We hope to see you there! www.donofriodanceco.com/events  #class #moderntechnique #inthestudio #dance #Brooklyndance #sweat #move #learn #mindandbody #vscocam #spacefordance #Fallishere #livealive",
        "annotations": {
          "featuredmessage": {
            "authorId": "TEMP-0b93dcdb2472d860@sales.fyre.co",
            "value": 1442337695,
            "collectionId": "132677714"
          },
          "geocode": {
            "latitude": 40.6753387,
            "longitude": -73.9783783
          }
        },
        "authorId": "497670545@instagram.com",
        "parentId": "",
        "updatedAt": 1442337710,
        "id": "instagram-1074728947851757894_497670545@instagram.com",
        "createdAt": 1442337695
      },
      "vis": 1,
      "type": 0,
      "event": 1442337838589493
    },
    {
      "erefs": [
        "M2KJJs0fxNKa5ZoxMg+kNqYWTacF76bsUMrJc7VazNlJknYymBP/EbSIe/Zrcgl7GbkbBoty/t7PfncMKTUCZzcIPk/TT9uV5XIXB3l9EZGb2I0588+cMNmL4NMjpiNUwkJY7w==",
        "u5xVwcUvddADfY2jrhqmgkETi4XzXOomas2646EX4m6k1tEQO0JcNgg5nQ5TKSXMYDG0AbfSf78kPhuKySQojfNiPLt4q+QutVdMam6r1u2EUfLYdNO3ZpB9bep1/4sGedS2Bg=="
      ],
      "source": 19,
      "collectionId": "132677714",
      "collection": null,
      "content": {
        "id": "instagram-987755210109869306_6402294@instagram.com",
        "createdAt": 1431969618,
        "parentId": ""
      },
      "vis": 3,
      "type": 0,
      "event": 1432053769522037
    }
  ],
  "isComplete": true,
  "size": 3,
  "authors": {
    "414661547@instagram.com": {
      "displayName": "Restaurant/Comedy Club",
      "tags": [],
      "profileUrl": "http://www.instagram.com/thevspotrestaurant",
      "avatar": "https://igcdn-photos-f-a.akamaihd.net/hphotos-ak-xfa1/t51.2885-19/11375249_171656349833669_472241260_a.jpg",
      "type": 8,
      "id": "414661547@instagram.com"
    },
    "497670545@instagram.com": {
      "displayName": "Donofrio Dance Company",
      "tags": [],
      "profileUrl": "http://www.instagram.com/donofriodanceco",
      "avatar": "https://igcdn-photos-e-a.akamaihd.net/hphotos-ak-xaf1/t51.2885-19/11856814_802209839897652_651365056_a.jpg",
      "type": 8,
      "id": "497670545@instagram.com"
    }
  }
}