What's in the Interaction Targets?

This page shows you how the targets in the Interaction object are populated. There are several different cases to consider.

From another target

Usually the targets in the interaction namespace are mapped from another target. For example, in the case of a Tweet, the interaction.content target is assigned the same value you would find in the twitter.text target. In the case of a Retweet, the interaction.content target contains the string you would find in the twitter.retweet.text target.

By DataSift

We populate some interaction targets according to programmatic rules. For example, we assign a random floating-point value between 0 and 100 to interaction.sample.

Another example is interaction.type. We assign a string to this target to represent the data source; "twitter" if the interaction comes from Twitter, "facebook" if it comes from Facebook, and so on.

From a JSON field

Some interaction targets are populated with data that only appears in the JSON output data. One example occurs for data from DailyMotion, which uses the data in the dailymotion.link JSON element to populate the interaction.link target. There is no dailymotion.link target so the only way to filter on this data is in the Interaction namespace.

From an alternative source

Sometimes a target is populated using hard-coded logic, unique to that data source. For example, in the case of an Instagram object, the interaction.author.link target contains the string "http://instagram.com/{username}" for the user associated with that interaction.

Hybrid population

Sometimes a target is populated in a way that depends on the context. For example, for data coming from Google+, the interaction.author.name target is populated from the googleplus.actor.display_name target in the case of a Google+ "activity" or "like". Hovewer, for a "plus one", the interaction.author.name target is populated from the value in Google's googleplus.display_name field in the JSON. There is no googleplus.display_name target.

Note: This section describes the interaction targets that you can filter against, and describes how they are populated. Take a look at Targets vs Output Data to learn more about the differences.

In the following tables, any item that is hyperlinked is a target. Anything that is not linked is not a target; it is a JSON element unless otherwise stated.

Bitly

Interaction Bitly
interaction.age
interaction.content
interaction.geo bitly.geo
interaction.hashtags
interaction.link bitly.url
interaction.mentions
interaction.mention_ids
interaction.publisher.name
interaction.raw_content A dynamically generated target that exists solely inside the filtering engine. It is a copy of interaction.content before we strip links, mentions, and hashtags.
interaction.source bitly.cname
interaction.subtype
interaction.title
interaction.type The string "bitly"
interaction.author.avatar
interaction.author.id
interaction.author.language
interaction.author.link
interaction.author.name
interaction.author.username

Blog

Interaction Blog
interaction.age blog.age
interaction.content blog.content
interaction.geo
interaction.hashtags
interaction.link blog.link
interaction.mentions
interaction.mention_ids
interaction.publisher.name
interaction.raw_content A dynamically generated target that exists solely inside the filtering engine. It is a copy of interaction.content before we strip links, mentions, and hashtags.
interaction.source
interaction.subtype blog.type
interaction.title blog.title
interaction.type The string "blog"
interaction.author.avatar
interaction.author.id
interaction.author.language
interaction.author.link blog.author.link
interaction.author.name blog.author.name
interaction.author.username

Board

Interaction Board
interaction.age board.age
interaction.content board.content
interaction.geo
interaction.hashtags
interaction.link board.link
interaction.mentions
interaction.mention_ids
interaction.publisher.name
interaction.raw_content A dynamically generated target that exists solely inside the filtering engine. It is a copy of interaction.content before we strip links, mentions, and hashtags.
interaction.source
interaction.subtype board.type
interaction.title board.title
interaction.type The string "board"
interaction.author.avatar board.author.avatar
interaction.author.id
interaction.author.language
interaction.author.link board.author.link
interaction.author.name board.author.name
interaction.author.username board.author.username

DailyMotion

Interaction DailyMotion
interaction.age
interaction.content dailymotion.content
interaction.geo
interaction.hashtags
interaction.link The dailymotion.link JSON element
interaction.mentions
interaction.mention_ids
interaction.publisher.name
interaction.raw_content A dynamically generated target that exists solely inside the filtering engine. It is a copy of interaction.content before we strip links, mentions, and hashtags.
interaction.source
interaction.subtype dailymotion.type
interaction.title dailymotion.title
interaction.type The string "dailymotion"
interaction.author.avatar
interaction.author.id
interaction.author.language
interaction.author.link dailymotion.author.link
interaction.author.name dailymotion.author.name
interaction.author.username dailymotion.author.username

Disqus

Interaction Facebook Pages
interaction.age
interaction.content disqus.message
interaction.geo
interaction.hashtags
interaction.link The first non-empty target from this list:
disqus.thread.link
disqus.post.link
interaction.mentions
interaction.mention_ids
interaction.publisher.name
interaction.raw_content A dynamically generated target that exists solely inside the filtering engine. It is a copy of interaction.content before we strip links, mentions, and hashtags.
interaction.source
interaction.subtype disqus.type
interaction.title
interaction.type The string "disqus"
interaction.author.avatar
interaction.author.id The first non-empty target from this list:
disqus.author.id
disqus.voter.id
interaction.author.language
interaction.author.link
interaction.author.name
interaction.author.username disqus.author.username

Facebook Pages

Interaction Facebook Pages
interaction.age
interaction.content The first non-empty target from this list:
facebook_page.message
facebook_page.story
facebook_page.picture
facebook_page.source
facebook_page.link
interaction.geo facebook_page.place.location
interaction.hashtags
interaction.link
interaction.mentions
interaction.mention_ids
interaction.publisher.name
interaction.raw_content A dynamically generated target that exists solely inside the filtering engine. It is a copy of interaction.content before we strip links, mentions, and hashtags.
interaction.source
interaction.subtype facebook_page.type
interaction.title
interaction.type The string "facebook_page"
interaction.author.avatar facebook_page.from/{id}/picture
interaction.author.id facebook_page.from.id
interaction.author.language
interaction.author.link http://www.facebook.com/profile.php?id={id}
interaction.author.name facebook_page.from.name
interaction.author.username

Google+

Interaction Google+
interaction.age
interaction.content The first non-empty target from this list:
googleplus.object.original_content<div>googleplus.object.content<div>googleplus.annotation<div>googleplus.title
interaction.geo
interaction.hashtags
interaction.link googleplus.url
interaction.mentions
interaction.mention_ids
interaction.publisher.name
interaction.raw_content A dynamically generated target that exists solely inside the filtering engine. It is a copy of interaction.content before we strip links, mentions, and hashtags.
interaction.source
interaction.subtype googleplus.type
interaction.title googleplus.title
interaction.type The string "googleplus"
interaction.author.avatar The google_plus.actor.image.url JSON element
interaction.author.id googleplus.actor.id
interaction.author.language
interaction.author.link The first non-empty target from this list:
<div>googleplus.actor.url (for activities and comments)<div>googleplus.url (for plus ones)
interaction.author.name <div> For activities and comments: <div> googleplus.actor.display_name <div> For plus ones: <div> The googleplus.display_name JSON element
interaction.author.username

IMDb

Interaction IMDb
interaction.age
interaction.content imdb.content
interaction.geo
interaction.hashtags
interaction.link imdb.link
interaction.mentions
interaction.mention_ids
interaction.publisher.name
interaction.raw_content A dynamically generated target that exists solely inside the filtering engine. It is a copy of interaction.content before we strip links, mentions, and hashtags.
interaction.source
interaction.subtype imdb.type
interaction.title imdb.title
interaction.type The string "imdb"
interaction.author.avatar The imdb.author.avatar JSON element
interaction.author.id
interaction.author.language
interaction.author.link imdb.author.link
interaction.author.name imdb.author.name
interaction.author.username The imdb.author.username JSON element

Instagram

Interaction Instagram
interaction.age instagram.age
interaction.content The first non-empty target from this list:
instagram.text
instagram.caption.text
interaction.geo instagram.geo
interaction.hashtags instagram.tags
interaction.link
interaction.mentions
interaction.mention_ids
interaction.publisher.name
interaction.raw_content A dynamically generated target that exists solely inside the filtering engine. It is a copy of interaction.content before we strip links, mentions, and hashtags.
interaction.source
interaction.subtype instagram.type
interaction.title
interaction.type The string "instagram"
interaction.author.avatar The first non-empty JSON element from this list:
instagram.user.profile_picture (for images or videos)
instagram.from.profile_picture (for comments)
instagram.profile_picture (for likes)
interaction.author.id <div> For images and videos
The instagram.user.id JSON element <div> For comments <div> The instagram.from.id target
For likes <div> The instagram.id JSON element
interaction.author.language
interaction.author.link http://instagram.com/{username}
interaction.author.name <div>instagram.from.full_name for comments
interaction.author.username <div> For images and videos: <div> The instagram.user.username JSON element <div> For comments: <div> The instagram.from.username target
For likes:
The instagram.username JSON element

IntenseDebate

Interaction IntenseDebate
interaction.age
interaction.content intensedebate.content
interaction.geo
interaction.hashtags
interaction.link The intensedebate.link JSON element
interaction.mentions
interaction.mention_ids
interaction.publisher.name
interaction.raw_content A dynamically generated target that exists solely inside the filtering engine. It is a copy of interaction.content before we strip links, mentions, and hashtags.
interaction.source
interaction.subtype intensedebate.type
interaction.title intensedebate.article.title
interaction.type The string "intensedebate"
interaction.author.avatar gravatar.com link when provided
interaction.author.id
interaction.author.language
interaction.author.link intensedebate.author.link
interaction.author.name
interaction.author.username intensedebate.author.username

LexisNexis

Interaction LexisNexis
interaction.age
interaction.content lexisnexis.article.content
interaction.geo
interaction.hashtags
interaction.link
interaction.mentions
interaction.mention_ids
interaction.publisher.name lexisnexis.source.name
interaction.raw_content A dynamically generated target that exists solely inside the filtering engine. It is a copy of interaction.content before we strip links, mentions, and hashtags.
interaction.subtype lexisnexis.article.type
interaction.title lexisnexis.article.title
interaction.type The string "lexisnexis"
interaction.author.avatar
interaction.author.id
interaction.author.language
interaction.author.link
interaction.author.name
interaction.author.username

NewsCred

Interaction NewsCred
interaction.age
interaction.content The first non-empty target from this list:
newscred.article.content
newscred.image.caption
newscred.video.caption
interaction.geo
interaction.hashtags
interaction.link The newscred.article.link JSON element
interaction.mentions
interaction.mention_ids
interaction.publisher.name newscred.source.name
interaction.raw_content A dynamically generated target that exists solely inside the filtering engine. It is a copy of interaction.content before we strip links, mentions, and hashtags.
interaction.source newscred.source.name
interaction.subtype
interaction.title newscred.article.title or newscred.video.title
interaction.type The string "newscred"
interaction.author.avatar
interaction.author.id The GUID of the first author in the newscred.article.authors list
interaction.author.language
interaction.author.link
interaction.author.name First entry in the newscred.article.authors array
interaction.author.username

Reddit

Interaction Reddit
interaction.age
interaction.content reddit.content
interaction.geo
interaction.hashtags
interaction.link reddit.link
interaction.mentions
interaction.mention_ids
interaction.publisher.name
interaction.raw_content A dynamically generated target that exists solely inside the filtering engine. It is a copy of interaction.content before we strip links, mentions, and hashtags.
interaction.source
interaction.subtype reddit.type
interaction.title reddit.title
interaction.type The string "reddit"
interaction.author.avatar
interaction.author.id
interaction.author.language
interaction.author.link reddit.author.link
interaction.author.name reddit.author.name
interaction.author.username The reddit.author.username JSON element

Topix

Interaction Topix
interaction.age
interaction.content topix.content
interaction.geo
interaction.hashtags
interaction.link topix.link
interaction.mentions
interaction.mention_ids
interaction.publisher.name
interaction.raw_content A dynamically generated target that exists solely inside the filtering engine. It is a copy of interaction.content before we strip links, mentions, and hashtags.
interaction.source The topix.source JSON element
interaction.subtype topix.type
interaction.title topix.title
interaction.type The string "topix"
interaction.author.avatar The topix.author.avatar JSON element
interaction.author.id
interaction.author.language
interaction.author.link The topix.author.link JSON element
interaction.author.name topix.author.name
interaction.author.username The topix.author.username JSON element

Tumblr

Interaction Tumblr
interaction.age
interaction.content tumblr.caption for photo, video and audio posts
tumblr.body for text posts and chat
tumblr.text for quotes
tumblr.answer for answers
tumblr.description for links
interaction.geo
interaction.hashtags tumblr.tags and tumblr.hashtags
interaction.link tumblr.post_url
interaction.media_type tumblr.type
interaction.mentions
interaction.mention_ids
interaction.publisher.name
interaction.raw_content A dynamically generated target that exists solely inside the filtering engine. It is a copy of interaction.content before we strip links, mentions, and hashtags.
interaction.source
interaction.subtype tumblr.activity
interaction.title tumblr.question for answers
tumblr.title or tumblr.reblogged.parent.title for other post types
interaction.type The string "tumblr"
interaction.author.avatar
interaction.author.id tumblr.blogid
interaction.author.language
interaction.author.link 'http://' + blogName + '.tumblr.com/'
interaction.author.name
interaction.author.username tumblr.blog_name

Twitter

Interaction Twitter
interaction.age
interaction.content twitter.text for a Tweet
twitter.retweet.text for a Retweet
interaction.geo twitter.geo
interaction.hashtags twitter.hashtags for a Tweet
twitter.retweet.hashtags for a Retweet
interaction.link
interaction.mentions twitter.mentions for a Tweet
twitter.retweet.mentions for a Retweet
interaction.mention_ids twitter.mention_ids for a Tweet
twitter.retweet.mention_ids for a Retweet
interaction.publisher.name
interaction.raw_content A dynamically generated target that exists solely inside the filtering engine. It is a copy of interaction.content before we strip links, mentions, and hashtags.
interaction.source twitter.source for a Tweet
twitter.retweet.source for a Retweet
interaction.subtype
interaction.title
interaction.type The string "twitter"
interaction.author.avatar The twitter.user.profile_image_url JSON element
interaction.author.id twitter.user.id for a Tweet
twitter.retweet.user.id for a Retweet
interaction.author.language
interaction.author.link
interaction.author.name twitter.user.name for a Tweet
twitter.retweet.user.name for a Retweet
interaction.author.username twitter.user.screen_name for a Tweet
twitter.retweet.user.screen_name for a Retweet

Video

Interaction Video
interaction.age video.age
interaction.content video.content
interaction.geo
interaction.hashtags
interaction.link video.videolink
interaction.mentions
interaction.mention_ids
interaction.publisher.name
interaction.raw_content A dynamically generated target that exists solely inside the filtering engine. It is a copy of interaction.content before we strip links, mentions, and hashtags.
interaction.source
interaction.subtype video.type
interaction.title video.title
interaction.type The string "video"
interaction.author.avatar
interaction.author.id
interaction.author.language
interaction.author.link video.author.link
interaction.author.name video.author.name
interaction.author.username video.author.username

Wikipedia

Interaction Wikipedia
interaction.age
interaction.content wikipedia.body or wikipedia.comment
interaction.geo
interaction.hashtags
interaction.link 'http://en.wikipedia.org/wiki/' + wikipedia.title
interaction.mentions
interaction.mention_ids
interaction.publisher.name
interaction.raw_content wikipedia.body or wikipedia.comment
interaction.source
interaction.subtype
interaction.title wikipedia.title
interaction.type The string "wikipedia"
interaction.author.avatar
interaction.author.id
interaction.author.language
interaction.author.link 'http://en.wikipedia.org/wiki/User:' + wikipedia.username
interaction.author.name
interaction.author.username The wikipedia.username JSON element

WordPress

Interaction WordPress
interaction.age
interaction.content wordpress.content
interaction.geo
interaction.hashtags
interaction.link wordpress.link
interaction.mentions
interaction.mention_ids
interaction.publisher.name
interaction.raw_content A dynamically generated target that exists solely inside the filtering engine. It is a copy of interaction.content before we strip links, mentions, and hashtags.
interaction.source
interaction.subtype wordpress.type
interaction.title wordpress.article.title
interaction.type The string "wordpress"
interaction.author.avatar
interaction.author.id
interaction.author.language
interaction.author.link wordpress.author.link
interaction.author.name
interaction.author.username wordpress.author.username

Yammer

Interaction Yammer
interaction.age
interaction.content yammer.body.plain
interaction.geo
interaction.hashtags
interaction.link
interaction.mentions
interaction.mention_ids
interaction.publisher.name
interaction.raw_content A dynamically generated target that exists solely inside the filtering engine. It is a copy of interaction.content before we strip links, mentions, and hashtags.
interaction.source
interaction.subtype yammer.type
interaction.title
interaction.type The string "yammer"
interaction.author.avatar
interaction.author.id yammer.sender.id
interaction.author.language
interaction.author.link yammer.sender.web_url
interaction.author.name yammer.sender.full_name
interaction.author.username yammer.sender.name

YouTube

Interaction YouTube
interaction.age youtube.age
interaction.content youtube.content
interaction.geo
interaction.hashtags
interaction.link youtube.videolink
interaction.mentions
interaction.mention_ids
interaction.publisher.name
interaction.raw_content A dynamically generated target that exists solely inside the filtering engine. It is a copy of interaction.content before we strip links, mentions, and hashtags.
interaction.source
interaction.subtype youtube.type
interaction.title youtube.title
interaction.type The string "youtube"
interaction.author.avatar
interaction.author.id
interaction.author.language
interaction.author.link youtube.author.link
interaction.author.name youtube.author.name
interaction.author.username youtube.author.username