Show Menu
TOPICS×

Filters

Use the Basic and Builder tabs to create rules to track activities on the social web.

Filters

Use the Basic and Builder tabs to create rules to track activities on the social web.
As best practice, use the Basic tab if you are familiar with setting up listening rules and are comfortable using boolean logic. Use the Builder tab if you are unfamiliar with setting up rules. The Builder prevents you, for example, from adding a filter that is not supported by your selected platforms. When using the Basic tab, be aware that you can specify filters that are not applicable for your selected platforms. In this case, nothing will be collected for that filter.
This section contains the following information:

Maximum Character Length for Rules

The maximum character length for rules depends on the platform, as explained in the following table. These lengths are imposed limitations from the data providers and apply to rules created using the Basic and Builder tabs.
Platforms that allow as many as 2,048 characters in listening rules
  • Disqus
  • Twitter
Platforms that allow as many as 255 characters in listening rules
  • Instagram
  • DailyMotion
  • MetaCafe
  • Reddit
  • Flickr
  • YouTube
  • G+
  • VK
Platforms that allow as many as 222 characters in listening rules |
  • WordPress
If you exceed the character limit for a provider, an error message displays. Be aware that if you select providers from each group, your rule cannot exceed the most restrictive character limit (222 for WordPress). You could modify the rule to fit the most restrictive character limit; however, best practice is to create two rules with the same display name. Each rule can then comply with its respective character limit.

Basic Tab

The Basic tab opens by default. Add a rule using keywords. You can use Boolean operators, such as All (AND), Any (OR), and None (NOT) to narrow results. For a full list of supported filters, see Filter List .
Instagram does not allow the use of the All (AND) and None (NOT) operators.
The following illustration shows a rule created on the Basic tab using boolean logic:
Operators are case-sensitive. When typing the AND, OR, or NOT operators, ensure that they are all uppercase letters.
For example, consider the following examples:
AND hash_tag:adobe Not Keywords:photoshop
AND hash_tag:adobe NOT Keywords:photoshop
Not in the first example should be NOT , as in the second example (all uppercase letters).
Note that while you are creating a rule on the Basic tab, you can click the Builder tab, if desired. However, some syntax code that you can specify on the Basic tab might not be compatible with the Builder functionality. If this is the case, the Builder tab is disabled. For example, if you change parentheses in the above example, the Builder tab will be disabled and a pop-up message displays informing you that the rule is supported for collection purposes but it cannot be displayed in the Builder.
For Twitter only, you can click Preview to display the Twitter Preview pane. For more information, see Twitter Preview .

Builder Tab

After you select one or more platforms, the Filters section expands to display more options. The Builder tab lets you construct term sets using an intuitive user interface using the three operators that Social supports: All (AND), Any (OR), and None (NOT), as explained below.
Instagram does not allow the use of the All (AND) and None (NOT) operators.
From the All (AND) and None (NOT) drop-down lists, select the desired filter types, provide user input as needed, then click Add next to each operator.
From the Any (OR) drop-down lists, select the desired filter type, provide user input as needed, then click Add to New Group to create the initial Any (OR) group (boolean parenthesis) for the filter. To add another filter to this group, select the desired filter type, provide user input as needed, then click Add to Group . To add another Any (OR) group (boolean parenthesis), click Add to New Group . You can then click inside any group to add additional rules, as needed.
You can add multiple filters for each filter operator to target and narrow your results. For more information, see the text below each filter in the user interface or refer to Filter List .
As you build a rule by adding operators and filters, the rule displays in the Generated Rule box. You can use the Generated Rule box to understand the logic that Social uses to construct rule sets and to help you fine-tune your rule.
For example, suppose you create a rule using the following operators and rules:
  • You select Twitter as the platform.
  • In the All (AND) section, you add the keywords "adobe" and "social," separated by commas.
  • In the All (AND) section, you add the Word Proximity filter and specify 3.
  • In the All (AND) section, you add the Has Geo filter set.
  • In the Any (OR) section, you add the keywords, "analytics" and "adlens," separated by commas.
  • In the None (NOT) section, you add the keywords, "brick" and "house," separated by commas.
Your completed rule should look like the following illustration. Note the text in the Generated Rule box at the bottom of the illustration.
This rule will collect data for tweets that contain geo data and mention both "adobe" and "social" within three words of each other, mention "analytics" or "adlens," but do not mention "brick" or "house."
You can add more filters as desired, or you can delete existing filters by clicking the x on each filter's tile.
In addition, you can add more platforms at any time, providing that these platforms support all of your selected filters. If you have selected a filter that is not supported by a particular platform, that platform's check box is disabled. In summary, if you select multiple platforms before selecting filter types, only those filters supported by all selected platforms are available for use. However, if you attempt to add additional platforms after you have selected one or more filter, the platforms you intend to add must also support the selected filters.
The text in the Generated Rule box is not editable. If you want to further edit the rule using boolean logic, click the Basic tab at the top of the Rules section to display the generated rule in an editable text box.
Click the following link for a full list of all available filters, with platform information, descriptions, examples, and advanced syntax to use on the Basic tab.

Filter List

Platform information, descriptions, and examples for all available filters you can use while adding rules to track using Social.
In the Description and Examples column in the table below, the User Input information specifies the input you must perform when using the user interface on the Builder tab.
The Advanced Syntax information specifies the syntax you must use when building a rule using boolean logic on the Advanced tab. For example, to specify the syntax for a Twitter rule using the Author filter, you would specify author:mtalbot to collect mentions of a term on Twitter by the user with the "mtalbot" Twitter handle.
For more information, see Add Rules to Track .
If a provider receives a rule with filters it does not support, it gets treated as a keyword. For example, if Disqus gets part of its rule as country_code:US , it will look for the keyword, “country_code:US.”
Social supports the following filters (in alphabetical order):
Filter Applicable Platforms Description and Examples
Activity URL Contains
WordPress
Matches activities where the activity URL (i.e. permalink) contains the given phrase or keyword. URL encodings are not encoded at this time.
User Input: Specify a phrase or keyword.
Example: adobe matches all activities with "adobe" in the URL.
Advanced Syntax: activity_url_contains
Syntax Example: activity_url_contains:adobe
Author
Twitter
Matches any activity that matches the given user.
User Input: Specify an author. Do not include the @ character.
Example: adobe matches @adobe but not adobe photoshop .
Advanced Syntax: author
Syntax Example: author:mtalbot
Bio
Former name: Bio Contains
Twitter
Matches tweets whose author's Twitter bio contains the given keyword or phrase.
User Input: Specify the desired value.
Example: Start-up matches Start-up junkie but not Software Engineer startup .
Advanced Syntax: bio
Syntax Example: bio:start-up
Bio Location
Twitter
Matches tweets where the user's bio-level location contains the specified keyword or phrase. This operator performs a tokenized match, similar to the normal keyword rules on the message body.
The user bio location is a non-normalized, user-generated, free-form string.
User Input: Specify the desired value.
Example: boulder matches Boulder and Boulder, CO and Beautiful Boulder, CO .
Advanced Syntax: bio_location
Syntax Example: bio_location:boulder
Bio Name
Former name: Bio Name Contains
Twitter
Matches tweets where the user's display name (not username) as specified in their bio, contains a given substring.
User Input: Specify the desired value.
Example: Mike matches any tweets from a user who said he was named Mike in his bio.
Advanced Syntax: bio_name
Syntax Example: bio_name:mike
Bounding Box
Twitter
Matches against the exact location (x,y) of the Tweet (when present in Tweet) and against an intersecting Place bounding box if the exact location is not present, where the place is fully contained within the defined region.
User Input: Specify the values in the appropriate longitude and latitude boxes. The width and height of the bounding box cannot exceed 25 miles.
Example: -105.301758 39.964069 -105.178505 40.09455 matches all activities contained in a box around Boulder, CO.
Advanced Syntax: bounding_box
Syntax Example: bounding_box:[-105.301758 39.964069 -105.178505 40.09455]
Place Country
Former name: Country Code
Twitter
Matches tweets where the country code associated with a tagged place/location matches the specified country.
User Input: Select the desired country code from the drop-down list.
Advanced Syntax: place_country
Syntax Example: place_country:jp
Followers Count
Twitter
Matches tweets where the author has a friends count (the number of users they follow) that falls within the given range.
User Input: Specify the minimum number of friends and the maximum number of friends that the author must follow for a match to be made.
Advanced Syntax: followers_count
Syntax Example: followers_count:1000..10000
Friends Count
Twitter
Matches tweets where the author has a followers count within the given range.
User Input: Specify the minimum number of followers and the maximum number of followers that the author must have for a match to be made.
Advanced Syntax: friends_count
Syntax Example: friends_count:100..1000
From
Disqus, Twitter, WordPress
Matches any activity from a specific user. Can either be a username or MD5-hashed email. For Twitter, the user ID can be used as well. Do not include the @ character.
User Input: Specify a username.
Example: mikesmith matches all posts, comments, or likes from mikesmith .
Advanced Syntax: from
Syntax Example: from:mikesmith
Hashtag
Instagram, Twitter
Matches any activity with the given hashtag. Also supports phrases to match "phrase tags" that contain whitespace characters.
This operator performs an exact match, not a tokenized match. The rule 2012 matches posts with the exact tag 2012 , but not those with the tag 2012 election .
User Input: Specify a hashtag. Do not include the hashtag (#) character.
Example: boulderfire matches all posts containing or tagged #boulderfire , but not #boulderfirefighters .
Advanced Syntax: hash_tag
Syntax Example: hash_tag:boulderfire
Has Geo
Twitter
Matches activities which contain geo (geographic data) in the metadata.
User Input: None.
Advanced Syntax: has:geo
Syntax Example: has:geo
Has Hashtags
Twitter
Matches activities that contain hashtags in the message body.
User Input: None.
Advanced Syntax: has:hashtags
Syntax Example: has:hashtags
Has Language
WordPress
Matches activities that have been classified as any language.
User Input: None.
Advanced Syntax: has:lang
Syntax Example: has:lang
Has Links
Disqus, Twitter, WordPress
Matches activities that contain links in the message body.
User Input: None.
Advanced Syntax: has:links
Syntax Example: has:links
Has Media
Twitter
Matches any activities that contain a media URL, such as an image or video.
User Input: None.
Advanced Syntax: has:media
Syntax Example: has:media
Has Mentions
Twitter
Matches any activities that mention other users.
User Input: None.
Advanced Syntax: has:mentions
Syntax Example: has:mentions
Is Comment
WordPress
Matches only activities that are comments.
User Input: None.
Advanced Syntax: is:comment
Syntax Example: is:comment
Is Retweet
Twitter
Delivers only explicit retweets that match a rule. Can also be negated to exclude retweets that match a rule from delivery and only original content is delivered.
User Input: None.
Advanced Syntax: is:retweet
Syntax Example: is:retweet
Is Verified
Twitter
Delivers only Tweets where the author is "verified" by Twitter.
User Input: None.
Advanced Syntax: is:verified
Syntax Example: is:verified
Keywords
G+, Reddit, YouTube, DailyMotion, Flickr, Disqus, MetaCafe, Twitter, VK, WordPress
Matches an exact work or phrase. Word boundaries are respected. To match a substring, use the Contains filter, if applicable for the selected platforms.
User Input: Specify a word or phrase. You can specify multiple words by separating them with a comma.
For more information about specifying terms, see Guidelines for Term Selection .
Example: phone matches on the phone but not on the telephone .
Advanced Syntax: keywords
Syntax Example: keywords:phone
Language
Disqus, Twitter, WordPress
Matches activities that have been classified as a being a part of a particular language. Only one language is allowed.
User Input: Select the desired language from the drop-down list.
Advanced Syntax: lang
Syntax Example: lang:ja
Valid language codes include: Arabic, ar; Danish, da; German, de; Greek, el ; English, en ; Spanish, es; Persian, ; Finnish, fa; French, fr; Hebrew, he; Italian, it; Indonesian, id; Japanese, ja; Korean, ko; Dutch, nl; Norwegian, no; Polish, pl; Portuguese, pt; Russian, ru; Swedish, sv; Thai, tv; Turkish, tr; Ukrianian, uk; Chinese, zh.
Listed Count
Twitter
Matches tweets where the author has been listed within Twitter a number of times falls within the given range.
User Input: Specify the minimum and maximum list count.
Advanced Syntax: listed_count
Syntax Example: listed_count:5000..10000
Place
Twitter
Matches tweets tagged with the specified location.
User Input: Specify the desired location.
Example: Rio de Janeiro matches tweets from Rio de Janeiro.
Advanced Syntax: place
Syntax Example: place:Rio de Janeiro
Post Title
WordPress
Matches an exact phrase within the title of a post.
User Input: Specify the desired value.
Example: Big Data matches Making sense of big data within your company .
Advanced Syntax: post_title
Syntax Example: post_title:Big Data
Post Title Contains
WordPress
Matches activities that have the given substring in the body, regardless of tokenization. In other words, this does a pure substring match, and does not consider word boundaries.
User Input: Specify a word or phrase.
Example: phone matches on the phone but not on the telephone .
Advanced Syntax: post_title_contains
Syntax Example: post_title_contains:phone
Radius From Point
Twitter
Matches against the exact location (x,y) of the activity when present, and against an intersecting place bounding box if the exact location is not present, where the place is fully contained within the defined region.
User Input: Specify the desired distance, select mi (miles) or km (kilometers) from the drop-down list, then specify the values in the appropriate longitude and latitude boxes. The radius cannot exceed 25 miles.
Example: -105.27346517 40.01924738 10mi matches activity within 10 miles of 17th and Pearl Street in Boulder, CO.
Advanced Syntax: point_radius
Syntax Example: point_radius:[-105.27346517 40.01924738 10mi]
Retweets Of
Twitter
Matches tweets that are retweets of a specified user. Accepts both usernames and userids.
User Input: Specify the desired username, separated by commas.
Example: justinbieber matches any retweets of justinbieber.
Advanced Syntax: retweets_of
Syntax Example: retweets_of:justinbieber
Rule Variables
DailyMotion, Disqus, Flickr, G+, Instagram, Metacafe, Reddit, WordPress, Twitter, VK, YouTube
Includes a rule variable . This field is dynamic. If the external rule variable is modified, this rule is modified as well.
Note: If you add a rule variable to a listening rule and assign the rule to a social platform, any individual filters used in the rule variable must be applicable for that social platform. For example, the keyword filter is not applicable to Instagram. If you create a rule containing a variable that contains a keyword filter and assign it to Instagram, no data will be returned. Likewise, if you create a variable that contains the Bio Location filter, and include that variable in a listening rule for WordPress, no data will be returned because Bio Location applies to Twitter only.
User Input: Select the desired rule variable. You can add multiple rule variables.
Example: adobe social
Advanced Syntax: rule_variable
Syntax Example: rule_variable:[adobe social]
Source
Twitter
Matches any tweet generated by the given source application. The value must be either the name of the application, or the application's URL. Cannot be used alone.
User Input: Specify the application name or its URL.
Example: web matches activities from the web but not activities from a mobile app.
Advanced Syntax: source
Syntax Example: source:web
Statuses Count
Twitter
Matches tweets where the author has posted a number of statuses that falls within the given range.
User Input: Specify the minimum number of statuses and the maximum number of statuses that the author must have for a match to be made.
Advanced Syntax: statuses_count
Syntax Example: statuses_count:500..9999
Thread URL Contains
Disqus
Matches activities posted to a web page if its URL contains the given phrase or keyword. URL encodings are not encoded at this time.
User Input: Specify the desired value.
Example: obama matches all activities posted to a web page with the word "obama" in the URL.
Advanced Syntax: thread_url_contains
Syntax Example: thread_url_contains:obama
Timezone
Twitter
Matches tweets where the user-selected timezone specified in a user's profile settings matches the specified timezone.
User Input: Select the desired timezone from the drop-down list.
Advanced Syntax: time_zone
Syntax Example: time_zone:Tokyo
To
Disqus, Twitter
Matches any activity that is in reply to a particular user.
In Disqus, this operator only supports the hashed actor IDs delivered via the Disqus API, not pretty usernames or displayNames present on the platform.
In Twitter, the value must be the user's screen name (handle) or numeric ID (excluding the @ character).
User Input: Specify a username.
Example: mikesmith matches all activity in reply to mikesmith .
Advanced Syntax: to
Syntax Example: to:mikesmith
URL
Former name: URL Contains
Disqus, Twitter, WordPress,
Matches activities with URLs that literally contain the given phrase or keyword.
User Input: Specify a phrase or keyword.
Example: adobe matches https://adobe.com but not search on adobe .
Advanced Syntax: url
Syntax Example: url:adobe
Verb
Disqus
Matches activities where a new comment has been created, updated, or deleted.
User Input: Select an option from the drop-down list: Post, Update, or Delete.
Advanced Syntax: verb
Syntax Example: verb:delete
URL Contains
Disqus, Twitter
Matches activities with URLs that literally contain the given phrase or keyword.
User Input: Specify the desired value.
Example: google matches https://www.google.com but not search on google .
Advanced Syntax: url_contains
Syntax Example: url_contains:google
Word Proximity
Disqus, Twitter, WordPress
Matches an activity where the keywords are no more than N tokens from each other. Phrases are not allowed. This filter is especially useful for posts that contain a lot of text or for tweets in which you want the words to be in close proximity to each other.
User Input: Specify two keywords, then specify the maximum number of words that can separate the two words to be considered a match.
Punctuation, such as an apostrophe or hyphen, is not allowed inside keywords. For this reason, "we're" and "e-mail" cannot be used as keywords. An error message displays when you click Add if a keyword contains punctuation.
Example: adobe and photoshop .
If you specify these two words, then select 4 from the drop-down list, the following phrases are considered matches because no more than four words separate the two keywords: adobe photoshop or adobe makes photoshop .
The following phrase would not be considered a match because more than four words separate the two keywords: adobe recently released a new version of photoshop .
Advanced Syntax: proximity:[word1 word2 4]
Syntax Example: proximity:[adobe photoshop 4]
The following Filters have been deprecated:
Filter
Applicable Platforms
Bio Language
Twitter
Bio Location Contains
Twitter
Contains
Twitter
Place Contains
Twitter