COVERITLIVE API - EVENT/DATA (V. 2.0)

The Request

This method provides a feed of data items from a particular CoveritLive event. This data can include submitted comments, published comments (guest and writer), and published media (images, audio, video).

URL:
https://api.coveritlive.com/remote/2/event/data
Response Format:
JSON
HTTP Method(s):
GET
API Rate Limited:
true (1 unique request per 5 seconds). Each request is cached based on url parameters for 5 seconds, so do not repeat identical requests more than 1 once every 5 seconds.
In addition to the parameters listed in the Request Parameters section, the event/data method also includes the following parameters:

Parameter Description Required
event_code The event code for the event for which data is being retreived. Each CiL event that is created is assigned a unique event code that identifies it in the database - The event owner can find this value after creating a new event, by selecting the "altcast_code" which is found in their Viewer Window embed code (e.g. the event code is "46e6cd22b5" in "altcast_code=46e6cd22b5"). This value is also returned by the event/list API method. yes
item_id The item ID at which you want to start receiving events. The item ID is unique and is provided in the data for any item returned. If it's not included, it will default to the earliest possible event stream item (up to the default item_count limit). no
item_count Controls the number of event stream items that are returned. If no value is provided, the last 500 matching items will be returned in descending order of creation date. Set item_count to an integer less than 500 to limit the number of items returned. If this value is set to an integer greater than 500, only the last 500 matching items will be returned.

If the item_id parameter is also included in the request, the item_count items directly after the item with item_id will be returned. Set item_count to a negative value to return the item_count items directly before the item with item_id. For example:

Retrieve 10 most recent items - set item_count to 10 (item_count=10)

Retrieve 10 items that are NEWER than item with id XXX - set item_id to XXX and item_count to 10 (item_id=XXX&item_count=10)

Retrieve 10 items that are OLDER than item with id XXX - set item_id to XXX and item_count to -10 (item_id=XXX&item_count=-10)

no
single_item

Indicates whether to return a single item specified by item_id. Set this parameter to "y" if you want to return 1 item equal to the item_id. Defaults to "n".

no
item_status Controls the status of the returned items. Possible values include:

edited - returns all items that have been edited after being published.

deleted - returns all items that have been deleted after being published.

Omit this parameter to return the normal event items (which includes edited items, but excludes deleted items).
no
elements A pipe (|) delimited list of elements to return. Possible values include:

adimage - Advertising image

audio - Audio items in the event

facebook - a Facebook post (published through "Search" in the Event Studio)

guest_comment - Guest comments

host_comment - Host comments

image - Non-advertising image

instagram - an Instagram image or video (published through "Search" in the Event Studio)

rss - an RSS item summary (published through "Search" in the Event Studio)

tweet - Guest comments made via Twitter

video - Video items in the event

wikipedia - a Wikipedia article summary (published through "Search" in the Event Studio)

no
author_name This parameter is used when wanting to return all items published under a particular author. This will search fields such as a writer's post name, and Twitter/Instagram handle and guest names added by viewers comments. This parameters should be URL encoded. no
published_by This parameter is used when wanting to return all items published by a particular CoveritLive user. no
source Where an item originated - will currently only return guest comments. If parameter not included or left blank, items from all sources will be returned. Possible values:

native - typed by a person viewing the event

api - Comment supplied by comment/create API method
no
include_replies Indicates whether to include replies to items in the event data. Set this parameter to "y" if you want replies included in the event data. Defaults to "n". no
include_inserted_items

Indicates whether to include inserted items in the event data. Set this parameter to "y" if you want inserted items included in the event data. Defaults to "n".

A note about inserted items: Inserted items are items that have been inserted before or after another root item that already exists in the event. This can be achieved using the EventStudio, or the content/create API method. Inserted items are associated with their root item, and so aren't listed with the other items returned in the event/data response. Instead they are included in an array attached to their root item, in a similar fashion to replies.

Due to the nature of inserted items, filtering using the elements request parameter will not apply to inserted items, only the root item they are attached to. For example, if the elements request parameter is set to "tweet", and there is an inserted "host_comment" attached to a root "tweet", that inserted item will still be returned because its root item has been returned. Conversely, if the elements request parameter is set to "host_comment", that same inserted "host_comment" will not be returned, because its root item is a tweet, which isn't being returned.

no
tag_color

The tag_color parameter can be used to select items tagged with one or more of the designated colors. Possible values include:

red

yellow

green

orange

blue

coral

purple

brown

For multiple colors, submit a pipe (|) delimited list.
ex: tag_color=red|yellow|blue

no
tag_color_exclude

The tag_color_exclude parameter can be used to select items that are NOT tagged with one or more of the designated colors. Possible values include:

red

yellow

green

orange

blue

coral

purple

brown

For multiple colors, submit a pipe (|) delimited list.
ex: tag_color_exclude=yellow|blue

Only one of tag_color or tag_color_exclude parameters can be used in a single request.

no
tag_category

The tag_category parameter can used to select items that were published with a tag_category value that exactly matches the input value. To match any part of the tag_category, submit your term with '%' signs.

ex: tag_category=dog matches only if the entire tag_category is dog.
tag_category=%dog% will match 'Big Dog', 'dog biscuits', 'topdog'.

no

Example #1 - Retrieve the last 25 published host and guest comments after a particular item


https://api.coveritlive.com/remote/2/event/data?
event_code=000000000
&token=05c413a1242b409fa91f574cea05072b
&item_id=11649181 
&item_count=25
&elements=host_comment%7Cguest_comment

This request would retrieve:

  • event data for the event with event_code 000000000 which is accessible to the user identified by token 05c413a1242b409fa91f574cea05072b
  • retrieving 25 items in the event stream that are directly after (i.e. newer than) the item with an item_id of 11649181
  • and only elements of the following types would be returned: host_comment guest_comment

Example #2 - Retrieve the last 25 published host and guest comments before a particular item

	
	https://api.coveritlive.com/remote/2/event/data?
	event_code=000000000
	&token=05c413a1242b409fa91f574cea05072b
	&item_id=11649181 
	&item_count=-25
	&elements=host_comment%7Cguest_comment
	
	

This request would retrieve:

  • event data for the event with event_code 000000000 which is accessible to the user identified by token 05c413a1242b409fa91f574cea05072b
  • retrieving 25 items in the event stream that are directly before (i.e. older than) the item with an item_id of 11649181
  • and only elements of the following types would be returned: host_comment guest_comment

The Response

The event data is returned in the data field of a general response. The data returned consists of the following fields:

Field Name Field Value(s) Explanation
code {string} Event Code - a unique code that identifies the event.
title {string} Event Title - the title of the event.
status upcoming
live
finished
Status of the event.
item_count {int} Count of event stream items.
scheduled_starttime {int} Date and time event was scheduled to start. Value is integer representing seconds since Unix Epoch (January 1 1970 00:00:00) GMT timezone.
start_timestamp {int} Date and time event started - empty if status is upcoming. Value is integer representing seconds since Unix Epoch (January 1 1970 00:00:00) GMT timezone.
end_timestamp {int} Date and time event ended - empty if status is upcoming or live. Value is integer representing seconds since Unix Epoch (January 1 1970 00:00:00) GMT timezone
event_items {Array} An array of objects representing items in the event. These may include host_comments, guest_comments, audio, images, videos, instagram, Facebook, RSS and Wikipedia.

host_comment objects have the following fields:


Field Name Field Value(s) Explanation
type host_comment Describes the type of this object.
itemID {string} ID of this event item
timestamp {int} Date and time object was published - format UNIX timestamp.
author_name {string} Display name of the author/initiator of the item. Empty if not applicable.
author_avatar {string} URL of thumbnail image associated with author_name. Empty if none provided. (NOTE: Image size is not guaranteed and may vary depending on image source and type. It is recommended that consumers of the Event Data feed adjust image size appropriately for the destination environment.)
private false
true
Denotes whether this host_comment was a private message between event hosts/panelists and event readers.
comment {string} Comment text
time {string} Time comment entered as displayed in event using format: HH:MM
replies {Array} If the include_replies request parameter has been set to "y", this field may include an array of reply objects that correspond to any replies to this particular item.
inserted_items {Array} If the include_inserted_items request parameter has been set to "y", this field may include an array of inserted items. These items will be in the same format as a regular event item (host_comment, guest_comment, tweet, etc ...)
tag_color {string} If the item was tagged when it was published or the tag color was changed after publishing, this field will contain the color of the tag.
tag_category {string} If the item was tagged with text categories when it was published or if the category tags were added after publishing, this field will contain a list of all text tags.
published_by {string} This is the username of the CoveritLive User that posted the content from EventStudio
raw_data {object} This is the raw unparsed data for the post.

guest_comment objects have the following fields:


Field Name Field Value(s) Explanation
type guest_comment Describes the type of this object.
itemID {string} ID of this event item
timestamp {int} Date and time object was published - format UNIX timestamp.
author_name {string} Display name of the author/initiator of the item. Empty if not applicable. If the comment was made via Twitter the author name will be appended with: " via Twitter"
author_avatar {string} URL of thumbnail image associated with author_name. Empty if none provided. (NOTE: Image size is not guaranteed and may vary depending on image source and type. It is recommended that consumers of the Event Data feed adjust image size appropriately for the destination environment.)
moderation moderated
unmoderated
Applies to host and viewer comments.
source {string} The source of the comment, currently this value is either empty or contains the string: api. If Reader Comment API was enabled on the event and your application had submitted the comment through the API the source value returned would indicate this.
private false
true
{empty}
Denotes whether this guest_comment was a private message between event hosts/panelists and event readers.
comment {string} Comment text
time {string} Time comment entered as displayed in event using format: HH:MM
tweet_data {object} If the comment is a tweet, this field will contain a tweet_object with additional twitter data (only present in Tweets captured after July 16 2012).
replies {Array} If the include_replies request parameter has been set to "y", this field may include an array of reply objects that correspond to any replies to this particular item.
inserted_items {Array} If the include_inserted_items request parameter has been set to "y", this field may include an array of inserted items. These items will be in the same format as a regular event item (host_comment, guest_comment, tweet, etc ...)
tag_color {string} If the item was tagged when it was published or the tag color was changed after publishing, this field will contain the color of the tag.
tag_category {string} If the item was tagged with text categories when it was published or if the category tags were added after publishing, this field will contain a list of all text tags.
raw_data {object} This is the raw unparsed data for the post.

audio objects have the following fields:


Field Name Field Value(s) Explanation
type audio Describes the type of this object.
itemID {string} ID of this event item
timestamp {int} Date and time object was published - format UNIX timestamp.
uri {string} URI of audio file.
embed {string} Flash embed code for playing audio.
name {string} User provided name of file or filename on disk if not provided
time {string} Time item entered as displayed in event using format: HH:MM
replies {Array} If the include_replies request parameter has been set to "y", this field may include an array of reply objects that correspond to any replies to this particular item.
inserted_items {Array} If the include_inserted_items request parameter has been set to "y", this field may include an array of inserted items. These items will be in the same format as a regular event item (host_comment, guest_comment, tweet, etc ...)
tag_color {string} If the item was tagged when it was published or the tag color was changed after publishing, this field will contain the color of the tag.
tag_category {string} If the item was tagged with text categories when it was published or if the category tags were added after publishing, this field will contain a list of all text tags.
published_by {string} This is the username of the CoveritLive User that posted the content from EventStudio
raw_data {object} This is the raw unparsed data for the post.

image objects have the following fields:


Field Name Field Value(s) Explanation
type image Describes the type of this object.
itemID {string} ID of this event item
timestamp {int} Date and time object was published - format UNIX timestamp.
is_advert false
true
Denotes whether the image is an advertisement.
embed {string} URI within HTML IMG tag optionally with link surrounding it.
uri {string} URI of full sized image file
uri_height {int} Pixel display height for the image file.
uri_width {int} Pixel display width for the image file.
uri_thumb {string} URI for optional thumbnail image file.
uri_thumb_height {int} Pixel height for optional thumbnail image file.
uri_thumb_width {int} Pixel width for optional thumbnail image file.
caption {string} User provided image caption data. Empty if no caption provided.
name {string} User provided name of file or filename on disk if not provided.
time {string} Time item entered as displayed in event using format: HH:MM
replies {Array} If the include_replies request parameter has been set to "y", this field may include an array of reply objects that correspond to any replies to this particular item.
inserted_items {Array} If the include_inserted_items request parameter has been set to "y", this field may include an array of inserted items. These items will be in the same format as a regular event item (host_comment, guest_comment, tweet, etc ...)
tag_color {string} If the item was tagged when it was published or the tag color was changed after publishing, this field will contain the color of the tag.
tag_category {string} If the item was tagged with text categories when it was published or if the category tags were added after publishing, this field will contain a list of all text tags.
published_by {string} This is the username of the CoveritLive User that posted the content from EventStudio
raw_data {object} This is the raw unparsed data for the post.

video objects have the following fields:


Field Name Field Value(s) Explanation
type video Describes the type of this object.
itemID {string} ID of this event item
timestamp {int} Date and time object was published - format UNIX timestamp.
uri {string} HTTP page of video file if file is hosted (Ustream, LiveStream, Qik.com), empty otherwise.
embed {string} Embedding HTML code for display of video - commonly YouTube.
height {int} Display height for the URI.
width {int} Display width for the URI.
name {string} User provided name of file or filename on disk if not provided.
time {string} Time video entered as displayed in event using format: HH:MM
replies {Array} If the include_replies request parameter has been set to "y", this field may include an array of reply objects that correspond to any replies to this particular item.
inserted_items {Array} If the include_inserted_items request parameter has been set to "y", this field may include an array of inserted items. These items will be in the same format as a regular event item (host_comment, guest_comment, tweet, etc ...)
tag_color {string} If the item was tagged when it was published or the tag color was changed after publishing, this field will contain the color of the tag.
tag_category {string} If the item was tagged with text categories when it was published or if the category tags were added after publishing, this field will contain a list of all text tags.
published_by {string} This is the username of the CoveritLive User that posted the content from EventStudio
raw_data {object} This is the raw unparsed data for the post.

tweet objects have the following fields:


Field Name Field Value(s) Explanation
id {string} The string representation of the unique identifier for this Tweet. Equivalent to the id_str field in Tweet objects in the Twitter API.
name {string} The display name of the tweet author.
username {string} The username of the tweet author.
created_at {string} UTC time when the tweet was created. Equivalent to the created_at field in Tweet objects in the Twitter API
replies {Array} If the include_replies request parameter has been set to "y", this field may include an array of reply objects that correspond to any replies to this particular item.
inserted_items {Array} If the include_inserted_items request parameter has been set to "y", this field may include an array of inserted items. These items will be in the same format as a regular event item (host_comment, guest_comment, tweet, etc ...)
tag_color {string} If the item was tagged when it was published or the tag color was changed after publishing, this field will contain the color of the tag.
tag_category {string} If the item was tagged with text categories when it was published or if the category tags were added after publishing, this field will contain a list of all text tags.
published_by {string} This is the username of the CoveritLive User that posted the content from EventStudio
raw_data {object} This is the raw unparsed data for the post.

instagram objects have the following fields:


Field Name Field Value(s) Explanation
type instagram Describes the type of this object.
itemID {string} ID of this event item
timestamp {int} Date and time object was published - format UNIX timestamp.
author_name {string} The Instagram username of the user who created the original image.
link {uri} Link to the original image page in Instagram.
images {object} A JSON object containing the image details, including width, height and url.
videos {object} If this Instagram item is a video, this field contains a JSON object containing the video details, including width, height and url.
comment {string} The tags/caption attached to the Instagram image.
time {string} Time item entered as displayed in event using format: HH:MM
replies {Array} If the include_replies request parameter has been set to "y", this field may include an array of reply objects that correspond to any replies to this particular item.
inserted_items {Array} If the include_inserted_items request parameter has been set to "y", this field may include an array of inserted items. These items will be in the same format as a regular event item (host_comment, guest_comment, tweet, etc ...)
tag_color {string} If the item was tagged when it was published or the tag color was changed after publishing, this field will contain the color of the tag.
tag_category {string} If the item was tagged with text categories when it was published or if the category tags were added after publishing, this field will contain a list of all text tags.
published_by {string} This is the username of the CoveritLive User that posted the content from EventStudio
raw_data {object} This is the raw unparsed data for the post.

facebook objects have the following fields:


Field Name Field Value(s) Explanation
type facebook Describes the type of this object.
itemID {string} ID of this event item
timestamp {int} Date and time object was published - format UNIX timestamp.
author_name {string} The Facebook username of the user who created the original post.
author_avatar {string} The URL of the avatar of the Facebook user who created the original post.
content_link {string} The URL of the original Facebook post (on Facebook).
profile_link {string} The URL of the profile page of the Facebook user who created the original post.
comment {string} The text of the Facebook post.
image_url {string} The URL of an image associated with the original Facebook post.
link {string} The URL of a link associated with the original Facebook post.
time {string} Time item entered as displayed in event using format: HH:MM
replies {Array} If the include_replies request parameter has been set to "y", this field may include an array of reply objects that correspond to any replies to this particular item.
inserted_items {Array} If the include_inserted_items request parameter has been set to "y", this field may include an array of inserted items. These items will be in the same format as a regular event item (host_comment, guest_comment, tweet, etc ...)
tag_color {string} If the item was tagged when it was published or the tag color was changed after publishing, this field will contain the color of the tag.
tag_category {string} If the item was tagged with text categories when it was published or if the category tags were added after publishing, this field will contain a list of all text tags.
published_by {string} This is the username of the CoveritLive User that posted the content from EventStudio
raw_data {object} This is the raw unparsed data for the post.

wikipedia objects have the following fields:


Field Name Field Value(s) Explanation
type wikipedia Describes the type of this object.
itemID {string} ID of this event item
timestamp {int} Date and time object was published - format UNIX timestamp.
title {string} The title of the Wikipedia article.
link {uri} A link to the Wikipedia article.
image {uri} The URL of the image associated with the article, if it exists.
content {string} A short synopsis of the Wikipedia article.
time {string} Time item entered as displayed in event using format: HH:MM
replies {Array} If the include_replies request parameter has been set to "y", this field may include an array of reply objects that correspond to any replies to this particular item.
inserted_items {Array} If the include_inserted_items request parameter has been set to "y", this field may include an array of inserted items. These items will be in the same format as a regular event item (host_comment, guest_comment, tweet, etc ...)
tag_color {string} If the item was tagged when it was published or the tag color was changed after publishing, this field will contain the color of the tag.
tag_category {string} If the item was tagged with text categories when it was published or if the category tags were added after publishing, this field will contain a list of all text tags.
published_by {string} This is the username of the CoveritLive User that posted the content from EventStudio
raw_data {object} This is the raw unparsed data for the post.

rss objects have the following fields:


Field Name Field Value(s) Explanation
type rss Describes the type of this object.
itemID {string} ID of this event item
timestamp {int} Date and time object was published - format UNIX timestamp.
title {string} The title of the RSS item.
link {uri} A link from the RSS item to the original article/story.
image {uri} The URL of the image associated with the RSS item, if it exists.
content {string} A short synopsis of the RSS item.

NOTE: This content may contain HTML tags
time {string} Time item entered as displayed in event using format: HH:MM
replies {Array} If the include_replies request parameter has been set to "y", this field may include an array of reply objects that correspond to any replies to this particular item.
inserted_items {Array} If the include_inserted_items request parameter has been set to "y", this field may include an array of inserted items. These items will be in the same format as a regular event item (host_comment, guest_comment, tweet, etc ...)
tag_color {string} If the item was tagged when it was published or the tag color was changed after publishing, this field will contain the color of the tag.
tag_category {string} If the item was tagged with text categories when it was published or if the category tags were added after publishing, this field will contain a list of all text tags.
published_by {string} This is the username of the CoveritLive User that posted the content from EventStudio
raw_data {object} This is the raw unparsed data for the post.

reply objects have the following fields:


Field Name Field Value(s) Explanation
type reply Describes the type of this object.
replyID {string} ID of this reply item.
parentItemID {string} Item ID of the item that is reply is associated with.
author_name {string} Display name of the author of the reply. Empty if not applicable.
author_avatar {string} URL of thumbnail image associated with author_name. Empty if none provided. (NOTE: Image size is not guaranteed and may vary depending on image source and type. It is recommended that consumers of the Event Data feed adjust image size appropriately for the destination environment.)
comment {string} Text of the reply.
timestamp {int} Date and time the reply was published - format UNIX timestamp.
time {string} Time item entered as displayed in event using format: HH:MM

Example response to a successful event/data request:


{
    "result":"success",
    "message":"true",
    "type":"event",
    "action":"data",
    "version":2,
    "data":{
        "code":"7f577dcef3",
        "title":"Test API Event",
        "status":"live",
        "item_count":9,
        "scheduled_starttime":"1315576800",
        "start_timestamp":"1315576573",
        "end_timestamp":"-62169962400",
        "event_items":[
            {
                "type":"audio",
                "itemID":"13630093",
                "timestamp":1315576691,
                "name":"temp_audio_file.mp4",
                "time":"09:58",
                "uri":"http:\/\/cdn.cloudfiles.mosso.com\/c71712\/media\/audio\/201104\/phpcamiZEtemp_audio_file.mp4",
                "tag_color:"red",
                "tag_category":"#AUDIO #MUSIC",
                "embed":"<object codebase=\"http:\/\/www.apple.com\/qtactivex\/qtplugin.cab\" classid=\"clsid:02BF25D5-8C17-4B23-BC80-D3488ABDDC6B\" style=\"width:250px;\"><param name=\"src\" value=\"http:\/\/cdn.cloudfiles.mosso.com\/c71712\/media\/audio\/201104\/phpcamiZEtemp_audio_file.mp4\" \/><param name=\"controller\" value=\"True\" \/><param name=\"cache\" value=\"False\" \/><param name=\"autoplay\" value=\"False\" \/><param name=\"kioskmode\" value=\"False\" \/><param name=\"scale\" value=\"tofit\" \/><embed src=\"http:\/\/cdn.cloudfiles.mosso.com\/c71712\/media\/audio\/201104\/phpcamiZEtemp_audio_file.mp4\" pluginspage=\"http:\/\/www.apple.com\/quicktime\/download\/\" scale=\"tofit\" kioskmode=\"False\" qtsrc=\"http:\/\/cdn.cloudfiles.mosso.com\/c71712\/media\/audio\/201104\/phpcamiZEtemp_audio_file.mp4\" cache=\"False\" style=\"width:250px;\" controller=\"True\" type=\"video\/quicktime\" autoplay=\"False\" \/><\/object>"
            },
            {
                "type":"video",
                "itemID":"13630092",
                "timestamp":1315576686,
                "uri":"",
                "height":300,
                "width":400,
                "name":"movie.mov",
                "time":"09:58",
                "tag_color:"blue",
                "tag_category":"#VIDEO #GREATEST MVP MOVES",
                "embed":"<object codebase=\"http:\/\/www.apple.com\/qtactivex\/qtplugin.cab\" classid=\"clsid:02BF25D5-8C17-4B23-BC80-D3488ABDDC6B\" style=\"width: 400px; height: 300px;\"><param name=\"src\" value=\"http:\/\/cdn.cloudfiles.mosso.com\/c71712\/media\/video\/201011\/phpXTqi81movie.mov\" \/><param name=\"controller\" value=\"True\" \/><param name=\"cache\" value=\"False\" \/><param name=\"autoplay\" value=\"True\" \/><param name=\"kioskmode\" value=\"False\" \/><param name=\"scale\" value=\"tofit\" \/><embed src=\"http:\/\/cdn.cloudfiles.mosso.com\/c71712\/media\/video\/201011\/phpXTqi81movie.mov\" pluginspage=\"http:\/\/www.apple.com\/quicktime\/download\/\" scale=\"tofit\" kioskmode=\"False\" qtsrc=\"http:\/\/cdn.cloudfiles.mosso.com\/c71712\/media\/video\/201011\/phpXTqi81movie.mov\" cache=\"False\" style=\"width: 400px; height: 300px;\" controller=\"True\" type=\"video\/quicktime\" autoplay=\"False\" \/><\/object>"
            },
            {
                "type":"image",
                "itemID":"13630091",
                "timestamp":1315576678,
                "is_advert":"false",
                "embed":"<img src=\"http:\/\/cdn.cloudfiles.mosso.com\/c71712\/media\/image\/201104\/phpz6hzVr_thumb_IMG_20110324_135842.jpg\"  width=\"240\"  height=\"320\"  border=\"0\" style=\"border: 1px solid #999999;\">",
                "uri":"http:\/\/cdn.cloudfiles.mosso.com\/c71712\/media\/image\/201104\/phpz6hzVrIMG_20110324_135842.jpg",
                "uri_height":"2592",
                "uri_width":"1944",
                "uri_thumb":"http:\/\/cdn.cloudfiles.mosso.com\/c71712\/media\/image\/201104\/phpz6hzVr_thumb_IMG_20110324_135842.jpg",
                "uri_thumb_height":320,
                "uri_thumb_width":240,
                "caption":"",
                "name":"IMG_20110324_135842.jpg",
                "time":"09:57",
                "tag_color:"",
                "tag_category":"#PERFECT PITCH",
                "inserted_items": [
                    {
                        "type":"host_comment",
                        "itemID":"694",
                        "timestamp":1315576678,
                        "author_name":"Brownjord Owner",
                        "author_avatar":"",
                        "private":"false",
                        "comment":"Test inserted item after the image",
                        "time":"09:56"
                    },
                ]
            },
            {
                "type":"guest_comment",
                "itemID":"13630089",
                "timestamp":1315576620,
                "author_name":"Bob ",
                "moderation":"moderated",
                "source":"",
                "private":"false",
                "comment":"Test comment from a guest. ",
                "time":"09:57",
                "replies": [
                    {
                        "type":"reply"
                        "replyId":166
                        "parentItemId":16531724
                        "author_name":"John Brown"
                        "author_avatar":"https://cdn.cloudfiles.mosso.com/c71712/media/avitars/phpSd4d0jPhotoon2011-06-08at17.02.jpg"
                        "comment":"First reply to the test comment"
                        "time":"11:11"
                        "timestamp":1380035477
                    },
                    {
                        "type":"reply"
                        "replyId":168
                        "parentItemId":16531724
                        "author_name":"Mark Fernàndes"
                        "author_avatar":"http://cdn.cloudfiles.mosso.com/c71712/media/avitars/phpjxmsjzphoto_on_2011-06-07_at_16.54_2.jpg"
                        "comment":"second reply to the test comment"
                        "time":"11:11"
                        "timestamp":1380035484
                    }
                ]
            },
            {
                "type":"instagram",
                "itemID":"13630094",
                "timestamp":1315576620,
                "author_name":"Gaspar",
                "link":"http://instagr.am/p/UlyJMZGeQJ/",
                "images": {
                     "standard_resolution" : {
                          "width" : 612,
                          "height" : 612,
                          "url" : "http://distilleryimage1.s3.amazonaws.com/d8e8643860bc11e2b60722000a9f09f0_7.jpg"
                     }
                 }
                "comment":"#keepcalmandcarryon #keepcalmandcallbatman #batman #iphonesia",
                "time":"09:59"
            },
            {
                "type":"facebook",
                "itemID":"13630097",
                "timestamp":1315576621,
                "author_name":"Thedpost.com",
                "author_avatar":"https://graph.facebook.com/408697305917890/picture",
				"content_link":"https://www.facebook.com/408697305917890_472055599582060",
				"profile_link":"https://www.facebook.com/profile.php?id=408697305917890",
                "comment":"Police investigate homicide at NFL stadium",
                "time":"09:59"
            },
            {
                "type":"wikipedia",
                "itemID":"13630095",
                "timestamp":1315576630,
                "title":"Batman",
                "link":"http://en.wikipedia.org/wiki/Batman",
                "image":"http://upload.wikimedia.org/wikipedia/en/thumb/a/a7/Batman_Lee.png/100px-Batman_Lee.png",
                "content":"Batman is a fictional character, a comic book superhero created by artist Bob Kane and writer Bill Finger.",
                "time":"09:59"
            },
            {
                "type":"rss",
                "itemID":"13630096",
                "timestamp":1315576641,
                "title":"'Last Stand' star Schwarzenegger talks gun control",
                "link":"http://news.yahoo.com/last-stand-star-schwarzenegger-talks-gun-control-144207383.html",
                "image":"http://media.zenfs.com/en_us/News/ap_webfeeds/4ce7d1980e04d302260f6a7067002a5b.jpg",
                "content":"<p><a href='http://news.yahoo.com/last-stand-star-schwarzenegger-talks-gun-control-144207383.html'></a>LOS ANGELES (AP) — Arnold Schwarzenegger doesn't think there's a parallel between film and real-world gun violence.</p><br clear='all'>",
                "time":"09:59"
            },
            {
                "type":"host_comment",
                "itemID":"13630088",
                "timestamp":1315576600,
                "author_name":"Brownjord Owner",
                "author_avatar":"",
                "private":"false",
                "comment":"Test content from the host ",
                "time":"09:56"
            },
            {
                "type":"guest_comment",
                "itemID":"14540614",
                "timestamp":1345659003,
                "author_name":"coveritlive via Twitter",
                "author_avatar":"http:\/\/a0.twimg.com\/profile_images\/2262955395\/CIL_Twitter_avatar_normal.png",
                "moderation":"unmoderated",
                "private":"false",
                "comment":"Join the <a target=_blank href='https:\/\/twitter.com\/Cricketnation'>@Cricketnation<\/a> <a target=_blank href='https:\/\/twitter.com\/search\/%23LiveChat'>#LiveChat<\/a> with <a target=_blank href='https:\/\/twitter.com\/search\/%23NiceMoves'>#NiceMoves<\/a> & <a target=_blank href='https:\/\/twitter.com\/search\/%23SYTYCD'>#SYTYCD<\/a> dancer Chris Koehl <a target=_blank href='https:\/\/twitter.com\/D8ChrisK'>@D8ChrisK<\/a> on Facebook at 2 pm ET <a target=_blank href='http:\/\/t.co\/b4HMdd5E'>on.fb.me\/R0yXws<\/a>",
                "time":"14:10",
                "tweet_data": {
                    "id":"238327830860161024",
                    "name":"CoveritLive",
                    "username":"coveritlive",
                    "created_at":"Wed, 22 Aug 2012 17:32:37 +0000"
                }
            }
        ]
    }
}

event/data Error Responses

A variety of error responses (in addition to the common error responses) to event/data requests, and instructions on how to rectify them:

result response message response solution
invalid_element_types The ALL_COMMENT element request parameter can only be called by itself. When populating the element request parameter, if the value ALL_COMMENT is used, it cannot be combined with other values. (ie. element=all_comment or element=host_comment|guest_comment are both valid, but element=all_comment|host_comment is not valid).
invalid_item_id The item_id request parameter did not contain a valid item id. When populating the item_id request parameter, ensure it contains a valid item_id. The item_id must correspond to an item that exists in the event for which you are retrieving data.
invalid_item_status Item status parameter contains an invalid value When populating the item_status request parameter, ensure it contains a valid value. Valid values include "edited" and "deleted".
invalid_include_replies The include_replies parameter contains an invalid value. Valid values include: "y", "n". When populating the include_replies request parameter, ensure it contains a valid value. Valid values include "y" and "n".
invalid_include_inserted_items The include_inserted_items parameter contains an invalid value. Valid values include: "y", "n". When populating the include_inserted_items request parameter, ensure it contains a valid value. Valid values include "y" and "n".