Search

Action

Example

Result

AND

Narrows your search by retrieving mentions where all search terms are present.

atlantic AND “sailboat racing”

Any document where “Atlantic” and “sailboat racing” are both included.

OR

Expands your search to retrieve mentions containing at least one search term.

sailing OR sailboat

Either the term before or the term after “OR” must appear in the document.

NOT

Excludes mentions containing an unwanted term.

sailboat NOT race

Any document where “race” does not pull in as a result.

AND/OR

Use this when you need a keyword to pull results alongside one or more other keywords.

sailboat AND (racing OR race)

Any document where “sailboat” and either “racing” or “race” are present.

ASTERISK

Use this when you are looking for one or more different keywords in a document.

sail*

Matches documents that have the keywords sail, sailing, sailboat, etc.

SENTIMENT

Matches documents with provided sentiment. Supported values: positive, neutral, negative, and not rated.

sentiment:"positive"

Any document that has been assigned positive sentiment.

COUNTRY

Matches documents created in the specified country. Must use the 2 or 3-letter codes to specify the country.

Country abbreviation codes had be found HERE.

country:"us"

Learn more about Refining Your Search by Country.

Any document that was created by a source in the US.

LANGUAGE

Matches documents that have a specified language. Must use the 2 or 3-letter code to specify language, with the exception of Chinese (“zh-hans” or “zh-hant”). Must use lowercase.

language:"es"

Learn more about Refining Your Search by Language.

Any document that was created in Spanish.

SOURCE LANGUAGE

Matches documents that have a specified source language (language declared by the content source

itself). Must use the 2 or 3-letter code to specify language, with the exception of Chinese (“zh-Hans” or “zh-Hant”). Must use lowercase.

sourceLanguage: "es"

Learn more about Language Codes.

Any document from

sources that produce

Spanish content.

TITLE

Matches documents that have the specified word/phrase in the title.

title:"Sailing the World"

Any document that has “Sailing the World” in its title.

COLON

The colon is a character used in Boolean expressions. We see it used many times in this library. If you wish to use a colon in your keywords then you must use it in quotations so that the system doesn't think it's a Boolean expression, e.g. stock symbols.

"Euronext:ROTH"

Any document that contains "Euronext:ROTH".

CONTENT

Matches documents that have the specified word/phrase in the body.

content:" George Mendonsa"

Any document that has “George Mendonsa” in the body.

CASE SENSITIVE OPERATOR

Matches documents to include specific casing such as uppercase, lowercase, or a mix.

This can help find mentions of a brand such as Apple amongst all mentions of the term "apple".

caseSensitive:(Apple)

Any document where Apple is capitalized.

Search

Action

Example

Result

SITE

Matches all documents from a specified site.
​

Matches all documents from a site and its affiliated subdomain sites.

Note: Do NOT include https:// or http:// in the link

site:"www.bbc.com"

site:".bbc."

Returns all articles from BBC.com with no subdomains

Returns all content from the BBC website, including subdomains. e.g.. https://www.bbc.com/, https://www.bbc.co.uk, etc.

CONTAINS LINK

Matches all documents mentioning a certain domain, or any subdomain.

Note: Do NOT include https:// or http:// in the link

containsLink:"nytimes.com”

Returns all articles linking to and/or mentioning New York Times links.

SPECIFIC URL

Matches documents from a specific URL.

URL:"https://www.elitedaily.com/p/25-sailing-quotes-f
or-instagram-thatll-get-y
ou-likes-while-you-cruise
-into-the-sunset-185477
07"

Returns documents from
the URL
"https://www.elitedaily.com/p/25-sailing-quotes-f
or-instagram-thatll-get-y
ou-likes-while-you-cruise
-into-the-sunset-185477
07"

AUTHOR

Matches documents by a
specific author or
username.

author:"Yachting World"

Returns documents from
“Yachting World”.

DATA SOURCE

Matches documents from a specific data source. Source must be lowercase. See appendix for full list.

infoType:"news" AND sailing

Returns News documents with the term "sailing".

RSS

Matches documents from an RSS feed you've added to your account. To find an RSS ID, open up the RSS feed in Inbox. Copy the ID from the browser URL.

sourceId:"rss:c087e17836068602ecc7189db9c5fc"

Returns documents from this specific RSS feed.

SOURCE NAME

Find all documents from a particular source.

sourceName:"Washington Post"

Returns documents from the source named Washington Post

PRODUCT

REVIEWS

Matches reviews for a specific product or brand.

productReview:“Holiday Inn”

Returns documents from review pages that are for the Holiday Inn, e.g.:

CONTENT CATEGORY

Allows for more accurate categorization and simpler search organization.

contentCategory: "press_releases"

Returns documents from Press release wires.

OUTLET TYPE

Include or exclude new media results by specific categories.

outletType: "stock_market_news"

Returns documents related to stock market news. To exclude, you would add the NOT operator in front of it.

Search

Action

Example

Result

NEAR

Retrieve results for two words in close proximity with each other.

sailboat NEAR racing

Any document where the “sailboat” and “racing” are within 4 words of each other.

NEAR/N

Retrieve results within a specific distance of one another. The number used determines the distance.

sailboat NEAR/10 racing

Any document where the keywords “sailboat” and “racing” are within 10 words of each other.

ONEAR

Use this when you’d like a document to have two words in close proximity to one another and in the same order.

sailboat ONEAR racing

Any document where “sailboat” is followed by “racing” within 4 words.

ONEAR/N

Use this when keywords need to be within a specific distance of one another and in the same order

sailboat ONEAR/10 racing

Any document where “sailboat” is followed by “racing” within 10 words.

WORD FREQUENCY

Use this when you need a keyword to occur a number of times.

Note: This can be used for these three document fields: title, content, or ingress.

Sailboat {5} OR race {4,10} OR ocean {3, } OR cup {,2}

content:("microsoft" OR "google" OR "amazon"){3}

title:("AI" OR "machine learning"){2,5}

INGRESS

Matches documents containing the specified keyword/phrase in the first paragraph

Ingress:"yacht race"

Any document that contains “yacht race” in the first paragraph.

sourceId:adhoc*

Matches any manually added content.

sourceId:adhoc*

Returns any document that has been added in manually.

IMAGE CAPTIONS

Capture news hits based on image captions.

body.captions:"Rivian"

Returns any mention of Rivian in an image caption from a news source type.

Search

Action

Example

Result

HASHTAG

Matches documents that contain a hashtag.

hashtag:"sailing"

Returns documents that contain #sailing.

EMOJI

Matches documents that contain an emoji in title, content and ingress.

emojis:"😉"

Returns documents that contain the 😉 emoji.

X (formerly Twitter) HANDLE

Matches documents where a X handle was mentioned.

@sailmagazine

Returns X documents that mention @sailmagazine.

TWEET ID

Matches the ID of tweets stored within Meltwater. No quotation marks around tweet id.

tweetId:1271689604677025792

​

Returns the Tweet with the matching ID 1271689604677025792

("No quotation marks around tweet ID.")

X THREAD

Matches replies, retweets, and quoted tweets from a specific tweet. Add in the tweet ID to return this data.

twitterThread:437331053657980928

Returns content from the
thread of the tweet ID
437331053657980928.

("No quotation marks around tweet ID.")

FACEBOOK PAGE

Matches documents from a specific Facebook page using the page’s ID and asterisks. To find a page ID:

site:"www.facebook.com/73471073870*"

Page ID = 73471073870

Returns documents from the Facebook page “Sailing World”.

TO

Matches documents with social media handles/usernames that were mentioned. This operator must be used in lowercase.

to:"americascup"

Any document mentioning the handle/username “AmericasCup”.

FROM

Matches documents that were posted by social media handles/usernames. This operator is case sensitive.

from:"worldsailing"

Any document that is published from the handle/username “worldsailing”

HANDLE

Matches documents that were posted by social media handles/usernames.

handle:"worldsailing"

Any document that is published from the handle/username “worldSailing”

MENTION

Matches documents with social media handles/usernames that were mentioned in the document.

mention:"yachtracinglife"

Any document mentioning the handle/username “YachtRacingLife”.

VERIFIED X HANDLES

Matches documents from authors with a verified X handle.

verified:true

Returns X documents from verified handles.

VERIFIED BUSINESS X HANDLE

Matches documents from authors with verified X business handle (gold tick).

authorVerifiedType:business

Returns X documents from verified business handles.

VERIFIED INDIVIDUAL X HANDLE

Matches documents from authors with verified X individual handle (blue tick).

authorVerifiedType:individual

Returns X documents from verified individual handles.

VERIFIED GOVERNMENT X HANDLE

Matches documents from authors with verified X government handle (grey tick).

authorVerifiedType:government

Returns X documents from verified government handles.

UNVERIFIED X HANDLES

Matches documents from authors with an unverified X handle.

verified:false

Returns X documents from unverified handles.

HUMAN X AUTHOR

Matches documents from authors that are human (not brand/company handles).

authorHuman:true

Returns X documents from human authors.

NON-HUMAN X AUTHOR

Matches documents from authors that are brand/company handles (non-humans).

authorHuman:false

Returns X documents from non-human authors (brands/companies).

AUTHOR AGE

Matches documents based on the author's age.

metaData.authors.birthYear>=1997

Returns posts from people born in or after 1997.

ORIGINAL POST/TWEET

Matches documents that are original posts on X, Facebook, Reddit, and Instagram.

postType: og

Returns documents from X, Facebook, Reddit, and Instagram that are original posts.

REPLY TO POST/TWEET

Matches documents that reply on X, and Reddit.

postType:re

Returns documents from X and Reddit that are replies.

QUOTED TWEET

Matches documents that are quoted tweets on X.

postType:qt

Returns documents from X that are quoted tweets.

RETWEET

Matches documents that are retweets on X.

postType:rp

Returns documents from X that are retweets.

RETWEET

Matches documents from users who have retweeted the specific handle.

"RT @handel"

Returns all users who have retweeted content from that handle.

FACEBOOK COMMENTS

Matches documents that are comments on a Facebook page. (The comment operator is applicable to other sources. To see Facebook only, filter by Facebook).

author:Comment AND author:"Sailing World" (and Facebook source filter applied).

Returns comments on the Facebook page, "Sailing World".

Note: the Facebook page URL operator does not work in combination with the comment operator as comments do not contain the Facebook page ID.

FACEBOOK COMMENTS FOR A SPECIFIC POST

Matches documents that are comments on a Facebook post. To find the information you need:

1. Click on the specific post that you want to monitor

(e.g. https://www.facebook.com/346937065399354/posts/3700677913358569)

2. Replace /posts/ with an underscore:

(e.g. https://www.facebook.com/346937065399354_3700677913358569)

3. Remove the 's' in https: (e.g. http://www.facebook.com/346937065399354_3700677913358569)

metaData.inReplyTo.url:“http://www.facebook.com/346937065399354_3700677913358569”

*please note this may not work in all cases as Facebook is more frequently using Pseudonymized Facebook Identifiers (PFBIDs) in their URLs.

Returns comments from that specific Facebook post.

FACEBOOK VISITOR POSTS

Matches documents on a Facebook page that come from a visitor.

author:"visitor post" AND sailing

Returns posts on Facebook pages from visitors that mention "sailing".

AUTHORITY

Matches documents that have an authority score for the author that is equal, greater, or smaller than provided value. Uses inequality operators (see appendix).

authority >= 5

Returns documents from sources with an authority score of 5.

X BIO

Matches X documents that have a specified term in the author’s bio information.

bio:"yacht enthusiast"

Matches documents from authors that have “yacht enthusiast” in their bio information.

X FOLLOWERS

Matches X documents from handles that have a number of followers greater, less than, or equal to the value provided. Uses >, >+, <, (<=).
​Note use colon (:) for exact number of followers, not equal sign.

followers: 100000

Ex: "Boat Life" AND followers >100000

Matches documents from X handles with exactly 100,000 followers

For the example: matches documents mentioning "Boat Life" AND X handles with more than 100,000 followers.

FACEBOOK LIKES

Matches Facebook documents from pages that have a number of followers greater, less than, or equal to the value provided. Uses inequality operators (see appendix).

Sailing AND enrichments.socialScores.fb_likes>2000

Matches documents from Facebook pages that have over 2,000 likes. Can use >, >+, <, <=.

SUBREDDIT

Matches Reddit documents from a specific Subreddit.

SourceName: /r/Boating

Returns Reddit documents from the Subreddit “r/Boating”.

REDDIT, FORUM or FACEBOOK THREAD BY TITLE

Matches Reddit, Forum or Facebook documents under threads with matching title.

ThreadTitle: "Perfect evening for a little Spanish mackerel fishing"

Returns Reddit, forums and facebook documents from the thread "Perfect evening for a little Spanish mackerel fishing".

REDDIT, FORUM or FACEBOOK THREAD BY URL

Matches Reddit, Forum or Facebook documents from a specific URL.

ThreadUrl:

"https://www.reddit.com/

r/boating/comments/cmkchi/aww/"

Returns Reddit, forums and Facebook documents from the thread URL "https://www.reddit.com/r/boating/

comments/cmkchi/aww/"

YOUTUBE CHANNEL

Matches Youtube documents from a specific Youtube channel. This operator uses the channel ID, not the channel username. To find a channel's ID, open up a video on the channel and click on the channel name underneath the video. This will bring you to the channel's home page, but instead of the URL displaying the username it will display the ID. Or, generate the channel ID using this site.

channelid:"UCF45qzioJ_0FVdZVG2NJTWg"

Returns Youtube documents from the channel ID UCF45qzioJ_0FVdZVG2NJTWg.

YOUTUBE VIDEO

Matches Youtube documents from a specific Youtube video.

replyUrl:”https://www.youtube.com/watch?v=zyzHVjzRUV4”

Returns YouTube video comments for the video https://www.youtube.com/watch?v=zyzHVjzRUV4

SHARES

Matches news documents and Tweets when the number of Facebook shares or X retweets is equal, greater or smaller than the provided value. Uses inequality operators (see appendix).

sailing AND shares > 5000

Returns news documents and Tweets with the term "sailing" that have over 5,000 Facebook shares or X retweets.

FACEBOOK SHARES

Matches news documents when number of Facebook shares is equal, greater or smaller than the provided value. Uses inequality operators (see appendix).

Sailing AND enrichments.socialScores.fb_shares>200

Returns news documents with the term "sailing" that have over 200 Facebook shares.

X SHARES

Matches news documents when number of X retweets is equal, greater or smaller than the provided value. Uses inequality operators (see appendix).

Sailing AND enrichments.socialScores.tw_shares>200

Returns news documents with the term "sailing" that have over 200 X retweets.

POSTS WITH IMAGES

Matches X, Reddit, blogs, and comment documents that include an image.

attachmentType:image

Matches X, Reddit, blogs, and comment documents that include an image.

POSTS WITH VIDEO

Matches X, Reddit, blogs, and comment that include a video.

attachmentType:video

Matches X, Reddit, blogs, and comment that include a video.

LIKES

Matches Tweets and Facebook posts when the number of likes on the posts is equal, greater, or smaller than the provided value. Uses inequality operators (see appendix).

sailing AND likes > 5000

Returns Tweets and Facebooks posts with the term "sailing" which have over 5,000 likes.

SOCIAL CHANNEL

Matches documents from a specific social channel: X, Facebook, Instagram, YouTube, and Reddit. Must be lower case.

Use instead of source filters if search terms vary per source and user wants multiple sources returned in results.

(socialType:" twitter" AND to:sailingworldmag) OR (socialType:"facebook" AND author:"Sailing World" AND author:Comment)

Matches tweets that are to @SailingWorldMag and Facebook comments on the Facebook page “Sailing World”.

CHINESE SOCIAL MONITORING

Use instead of source filters for identifying these two sources as RSS feeds within Explore

(SourceName: "___")

Matches results within explore from these sources specifically provided via RSS feeds.

BROADCAST TYPE

Returns broadcast results a specified type: radio/audio or tv/video (see appendix).

broadcastType:”au”

Includes only Radio/audio content from broadcast.

PRIVATE CONTENT

Includes privately collected data (Owned social connections, social monitored connections, Dow Jones, etc.) in results.

Value is true or false.

private:true

Includes privately collected content, including from social channels connected under Owned Connections (FB, IG, and TW included), social monitored connects, and more.

ENGAGE CONTENT FROM A SPECIFIC PAGE OR HANDLE

Locate Engage owned data in Explore or Search

pageId:"17841446611975651"

Isolates content from specific Facebook or Instagram pages.

For FB: simply use the tools you already know to find a FB ID e.g. https://lookup-id.com/

For IG:

1) You can use the following URL and replace <username> with the IG profile you are looking for - https://www.instagram.com/web/search/topsearch/?query=<username>

2) For example - https://www.instagram.com/web/search/topsearch/?query=nordicsocialbeachclub

3) Then, simply copy the ID number next to"fbid_v2":

DM’s

Isolate DM’s for Engage

postType:"dm"

Isolate/remove DMs from Engage content in Explore

AD ACCOUNT

Matches Instagram & Facebook ad documents from Meltwater Engage using your ad ID

adAccountId:"act_358816525849351"

Returns all ad posts and comments associated with a particular ad account. A single ad account can have ads on multiple Facebook and Instagram accounts. There is the potential for ads associated with a FB/IG page that has NOT been connected on social connections page will be returned by this boolean. In those instances, the identifying information about the commenter will be hidden.

Your ad account will show up on the Social Connections > Paid tab once the facebook/Instagram account is connected.

CAMPAIGN

Matches Instagram & Facebook campaign documents from Meltwater Engage using your ad ID

campaignId: "111111111"

Returns all ad posts and comments associated with a particular ad campaign. A single campaign can have multiple ad accounts and ads on multiple Facebook and Instagram accounts. There is the potential for ads associated with a FB/IG page that has NOT been connected on social connections page will be returned by this boolean. In those instances, the identifying information about the commenter will be hidden.

Your ad account will show up on the Social Connections > Paid tab once the facebook/Instagram account is connected.

FACEBOOK POSTS WITH COMMENTS

Returns Facebook posts with comments equal, greater or smaller than the provided value. Uses inequality operators (see appendix).

Sailing AND enrichments.socialScores.fb_post_comments>20

Returns Facebook posts that mention sailing and have more than 20 comments

FACEBOOK POSTS WITH REACTIONS

Returns Facebook posts with reactions equal, greater or smaller than the provided value. Uses inequality operators (see appendix).

Sailing AND enrichments.socialScores.fb_post_reactions>20

Returns Facebook posts that mention sailing and have more than 20 reactions

FACEBOOK POSTS WITH SHARES

Returns Facebook posts with shares equal, greater or smaller than the provided value. Uses inequality operators (see appendix).

Sailing AND enrichments.socialScores.fb_post_shares>20

Returns Facebook posts that mention sailing and have more than 20 shares

TWEETS WITH LIKES

Returns X posts with likes equal, greater or smaller than the provided value. Uses inequality operators (see appendix).

Sailing AND enrichments.socialScores.tw_likes>20

Returns tweets that mention sailing and have more than 20 likes

TWEETS WITH REPLIES

Returns X posts with replies equal, greater or smaller than the provided value. Uses inequality operators (see appendix).

Sailing AND enrichments.socialScores.tw_replies>20

Returns tweets that mention sailing and have more than 20 replies

TWEETS WITH RETWEETS

Returns X posts with retweets equal, greater or smaller than the provided value. Uses inequality operators (see appendix).

Sailing AND enrichments.socialScores.tw_retweets>20

Returns tweets that mention sailing and have more than 20 retweets

SOCIAL CONNECTIONS

Returns privately collected content, including from social channels connected under Owned Connections (FB, IG, and TW included), social monitored connects, and more.

metaData.provider.type:"socialconnections"

Returns from a specific private social connection within your account.

FACEBOOK REELS

Returns documents that are Facebook Reels.

Available for: Facebook

attachmentType:reel

Matches documents that are Facebook Reels.

Only available for accounts with a connected Facebook account.

INSTAGRAM REELS

Returns documents that are Instagram Reels.

Available for Instagram.

site:"instagram.com/reel/"

Matches documents that are Instagram Reels.

Only available for accounts with a connected Instagram account.

Search

Action

Example

Result

REACH

Matches documents with a number of unique visitors that are equal, greater, or smaller than provided value. Uses inequality operators (see appendix).

sailing AND reach>=10000

Any document that contains the word “sailing” and that has reach greater than or equal to 10,000.

NEWS FOCUS

Matches documents based on national or local publications.

newsFocus:national AND sailboat

newsFocus:local AND sailboat

Returns any mention of sailboat from a national publication.

Returns any mention of sailboat from a local publication.

PRODUCT REVIEW RATING

Matches Product Review
documents with a specific
rating. Reviews are normalized on a percentage scale from
0-100. For example, 80 would represent 80% positive or 4/5 stars.

ratings>80 AND sailboat

Returns Product Review
documents that mention
“sailboat” and have a review
higher than 80%.

ESTIMATED VIEWS

Matches documents with more or less than a certain number of views.

metrics.views.origin.estimated<1000

metrics.views.origin.estimated>1000

Returns documents that have less than 1000 views.

Returns documents that have more than 1000 views.

TAG

Matches documents that have been assigned a specific Meltwater tag. Tag name is case sensitive.

tag:Event

Returns documents that have
been assigned the tag named
"Event".

CATEGORY

Classifies a document according to a taxonomy of topics (e.g. business, sports, etc.) that belong to the source. Category searching can be used to increase the relevance of search results and only return documents that fall into the specified category.

See a full list of categories here.

Category:"Sports"

Any document from a source whose topic is classified as “Sports”.

CONCEPT

Classifies documents into “concepts” based off key phrases and themes in Wikipedia.

Meltwater has analyzed Wikipedia pages using a proprietary algorithm that finds unique keywords, phrases, and themes. These are then attributed to the Wiki page’s topic and the topic becomes a “concept”.

Any document in Meltwater that contains those unique keywords, phrases, and themes will be categorized as that concept.

Use this to help refine searches by concept (topic) instead of by keyword. This is helpful when your keywords aren’t unique to a specific topic, but you want to return results from a specific topic without limiting your scope with exact qualifying keywords.

concept:Sailing

The “Sailing” article in Wikipedia is about the physical act of sailing (e.g. wind velocity, tacking, sail structure, etc.). This example would return documents that also mention those key themes as it relates to sailboats.
​
It would not return returns about yachting races or events unless sailing themes were a key part of the article. For that, we would want to use the concept “Yachting” and documents returned would reflect the key themes in the “Yachting” Wikipedia page.

PREFERENCE

Boost or reduce the score of a word, phrase or sub-expression and decide what is more likely to appear in the hit sentence. The default score is 1, so greater numbers can be used to boost the score, while decimal numbers between 0 and 1 can be used to reduce the score.

You must use the ^ in conjunction with numbers (ideally, multiples of 10). Depending on the number given to a keyword, the precedence will be given there. So the higher the number, the more the search is catered to that particular keyword.

Race AND (yacht ^2 or sailing ^0.5 )

Any document that contains the word “race” and either “yacht” or “sailing”. This does not affect the number of results, but affects what keywords are highlighted in the hit sentence of the results.

An example of when to use: for email reports when you want a specific keyword from your Boolean to show in the hit sentence.

QUESTION MARK

Use this when you are

looking for one or more different keywords in a document.

"sen ?"

Any document that contains keywords such as “sent” or “send”.

BACKSLASH

Use this to ignore the Boolean function of asterisks and quotes. The backslash must be placed before the asterisk or quotation.

E\*trade

"There was more name-calling than at a \"real housewives\" reunion"

First search returns all results for "E*trade" instead of "EndWildlifeTrade" or "EUTrade".

Second search returns results with specific keywords. Without the backslash, the query would read, "there was more name-calling than at a" OR "real housewives" OR "reunion".

XNOT

Use this when you want to ignore a keyword in special combination with other words or phrases.

bill XNOT "bill gates"

Any document where “bill” is present unless it only contains “bill gates”.
E.g. a document with content “Bill Murray met Bill Gates” is returned but not one with “Bill Gates makes billions”.

AUSTRALIAN "NOT AVAILABLE" CONTENT

Use this in conjunction with the NOT operator when you want to exclude Australian that is not available.

NOT SourceName:“Licensed by Copyright Agency”
​

Does not return documents from Australian content that is not available.

TOPIC

Classifies a document according to a taxonomy of topics (e.g. business, sports, etc.) that match the content of the document. Topic searching can be used to increase the relevance of search results and only return documents that fall into the specified topic.

topic: "computer_and_video_games" or topic: "air_travel"

Matches documents that have content related to computer and video games or content related to air travel

CURRENCY

Use currency symbols in the search engine such as: ƒ, ℳ, 元, 円, 圆, 圓, ḯ, ₺, , ₼, ₽, ₾,₿.

₿

Searching for the bitcoin symbol, ₿, will produce results referencing bitcoin.

EVENTS

Use this for finding documents of a specific event.

Also, supports wildcards.

See Appendix for Event Types supported.

event:award

Searching for the presence of the specific event type.

*We recommend using with eventcompany: to pull in a company event which labels the article with the company involved and the type of the event.

COMPANY EVENTS

Use this to search for events from a specific company.

eventcompany:Apple

Searching for the presence of a company event and labels the article with the company involved.

CONTINENT

Use this to search for content from a specific Continent.

metaData.source.location.geonames.continent:ID#

Learn more about Refining Your Search by Continent.

Searching for content from a specific continent.

COUNTRY

Use this to search for content from a specific Country.

metaData.source.location.geonames.country:ID#

Learn more about Country Codes.

Searching for content from a specific country.

PLACE

Use this to search for content from a specific place.

metaData.source.location.geonames.place:ID#

Id#'s can be found HERE.

Searching for content from a specific place.

REGION

Use this to search for content from a specific region.

metaData.source.location.geonames.adm1:ID#

Id#'s can be found HERE.

Searching for content from a specific region.

Search

Action

Example

Result

CONTAINMENT BOOLEAN

Use this boolean to contain the queries below. They will not operate correctly if not contained within this Entities string.

Must include brackets!

enrichments.namedEntities[query]

CANONICAL NAME

Canonical name of entity as disambiguated against an external ontology.

A Canonical Name is the actual/proper name of something, rather than an alias, nickname, or abbreviation.

canonicalName:”Smithfield Foods”

Ex. enrichments.namedEntities[canonicalName:”Smithfield Foods”]

Any document that contains the canonical name Smithfield Foods, as it relates to the entity Smithfield Foods as an organization.

NAME

Name of entity as written in the document.

enrichments.namedEntities[name:“ ”]

Ex. enrichments.namedEntities[name:”Smithfield”]

Any document that contains the name Smithfield, as it relates to the entity Smithfield as an organization.

SENTIMENT

The sentiment of the entity as written in the document.

Use in conjunction with operators above.

sentiment.discrete:v = negative
​

sentiment.discrete:p = positive
​

sentiment.discrete:n = neutral

Ex.

enrichments.namedEntities[Name:"Smithfield" AND sentiment.discrete:v]

Any document that

matches the sentiment provided (negative, in this example) and relates to the entity name Smithfield as an organization.

TYPE

The type of an entity. Use in conjunction with the operators above to further optimize your results.

enrichments.namedEntities[name:“ ” AND type:“ ”]
​

Ex. enrichments.namedEntities[name:”Smithfield”AND type:”organization”]

Matches any document talking about Smithfield the organization.

Search

Action

Example

Result

imageText

applies Optical Character Recognition on images enabling you to match text inside an image. Note: text must be specified all lowercase

imageText: stop

(any word is supported)

Matches documents where the word stop appears inside the image, e.g., on a stop sign.

imageEntity

search for known entities in images, e.g., logos or celebrities

imageEntity: "Elon Musk"

imageEntity: BMW

matches articles/posts with photos of Elon Musk

matches articles/post with BMW logos in the image

imageAgeGroup

applies age detection on images of the article or post

supported values are

children (<13 yrs old), teenagers (13-22 yrs old), young_adults (22-31 yrs old), adults (31-61 yrs old), and seniors (>61 yrs old)

imageAgeGroup: seniors

articles/posts with an image depicting people estimated to be over 60 years old

imageGender

applies gender detection on images inside the article or post

supported values are m (male), f (female), or u (unknown)

imageGender: f

articles/posts where a female person appears in the image

imagePeopleDensity

counts the detected faces in the image to estimate the number of people in it

supported values are: solo (1 person), duo (2 persons), group (3-10 persons), crowd (11+ persons)

imagePeopleDensity: duo

articles/posts containing an image depicting two people

imageEmotion

applies emotion recognition on images of an article/post

supported values are: a (anger), j (joy), or u (unknown)

imageEmotion: a

articles/posts containing an image where at least one face shows anger

imageMeme

applies the memes detection model to classify images as likely memes

supported value are true / false

imageMeme: true

articles / posts containing an image that looks like a meme

imageObject

applies object recognition on the images inside articles/posts

imageObject: dog

articles / posts with images depicting a dog

imageScene

applies scene recognition on the images inside articles/posts

imageScene: beach

articles / posts with images depicting a beach scene / situation

imageContent

a convenience alias that will search on OCR, objects, and scenes

imageContent: baseball

articles/posts with an image depicting a baseball or a baseball match scene or the word baseball appears in the image, e.g., on a t-shirt or billboard

NSFW (Not Safe for Work)

a convenience alias combining NLP and image recognition models for explicit content detection. text, Reddit, blogs, news content, & X can be covered with the NSFW filter.

supported value are true / false

nsfw: false

articles/posts where the content has been deemed safe on both text and images

spam

a convenience alias combining nsfw and promotional to remove/include potential spam content

supported value are true / false

spam: false

articles/posts that are both safe for work and do not appear to be promotional content, e.g., sales, discounts, coupons

Crisis Example

Boolean Query

Anger

(hate OR hated OR hateful OR anger OR angry OR disgust OR disgusted OR disgusting OR emojis:"😠" OR emojis:"😡" OR emojis:"🖕" OR emojis:"😷") NOT ("don't hate" OR "not angry")

Boycotts

boycott OR boycotts OR boycotted OR boycotting

Conspiracies

conspiracy OR conspiracies OR conspire OR conspired

Corruption

corrupt OR corrupted OR corruptions

Customer Complaints

"can someone get back to me" OR "please reply" OR "please call me" OR "never answered" OR "need help" OR "awful service" OR "waited forever" OR "the worst" OR "can't get in touch" OR "charged me" OR "refund" OR "where do i" OR "who can i" OR "what is the number" OR "customer service" OR "so bad" OR "help me" OR "brand rep" OR "on hold"

Cyber Attack

hack OR hacking OR hacker OR hackers OR hacked OR malicious OR malware OR virus OR viruses OR “cyber attack” OR cyberattack OR “cyber attacks” OR cyberattacks OR “cyber attacker” OR cyberattacker OR “cyber attackers” OR cyberattackers OR “cyber attacks” OR cyberattacks OR “cyber attacking” OR cyberattacking OR “cyber attacked” OR cyberattacked OR “cyber army” OR cyberarmy OR “cyber security” OR “cyber securities” OR cybersecurity OR cybersecurities OR “cyber command” OR cybercommand OR “cyber threat” OR cyberthreat OR “cyber threats” OR cyberthreats OR spyware OR spywares OR cyberwarfare OR “cyber warfare” OR “cyber terrorism” OR cyberterrorism OR “cyber terror” OR cyberterror OR “cyber terrors” OR cyberterrors OR “cyber campaign” OR stuxnet OR cyberterrorist OR “cyber terrorist” OR cyberterrorists OR “cyber terrorists” OR worms OR “Trojan horse” OR Trojanhorse OR “Trojan horses” OR Trojanhorses OR phreaking OR scammers OR scamming OR scam OR phishing OR phished OR spammer OR rootkit OR “brute forcing” OR bruteforcing

Cyber Breach

"data breach" OR databreach OR "cyber breach" OR cyberbreach OR "data leak" OR "data leaks" OR dataleak OR dataleaks OR "data hack"

Cyber Security

"cyber attack" OR cyberattack OR "cyber attacks" OR cyberattacks OR "cyber attacker" OR cyberattacker OR "cyber attackers" OR cyberattackers OR "cyber attacking" OR cyberattacking OR "cyber attacked" OR cyberattacked OR "cyber army" OR cyberarmy OR "cyber security" OR "cyber securities" OR cybersecurity OR cybersecurities OR cyberwarfare OR "cyber warfare" OR "cyber terrorism" OR cyberterrorism OR "cyber terror" OR cyberterror OR "cyber terrors" OR cyberterrors OR cyberterrorist OR "cyber terrorist" OR cyberterrorists OR "cyber terrorists"

DE&I

diversity OR diverse OR equality OR equalities OR "equal rights" OR equalrights OR "equal right" OR equalright OR “equal pay” OR equalpay OR "equal salary" OR equalsalary OR "equal salaries" OR equalsalaries OR "gender equality" OR genderequality OR "gender bias" OR genderbias OR "race bias" OR "racial bias" OR inclusion OR inclusions OR inclusive OR inclusivity OR "de&i"

Discrimination

discrimination OR discriminate OR discriminated OR discriminating

Diversity

diversity OR equality OR equalities OR "equal rights" OR equalrights OR "equal right" OR equalright OR “equal pay” OR equalpay OR "equal salary" OR equalsalary OR "equal salaries" OR equalsalaries OR "gender equality" OR genderequality OR "gender bias" OR genderbias OR "de&i" OR "age bias" OR ageism OR ageist OR "race bias" OR "racial bias"

Fear

(afraid OR terrifying OR nervous OR stressed OR anxiety OR anxious OR scary OR emojis:"😧" OR emojis:"😨" OR emojis:"😰") NOT ("not nervous" OR "not stressed" OR "not be anxious" OR "not scary" OR "not afraid" OR "not be afraid")

Harassment

harassment OR workplaceharassment OR sexualharassment OR assault OR sexualassalt OR derogatory OR "racial slur" OR racialslur OR "racial slurs" OR racialslurs OR "ethnic slur" OR ethnicslur OR "ethnic slurs" OR ethnicslurs OR racist OR racists OR racism OR "micro aggression" OR "microaggression" OR "micro aggressions" OR "microaggressions" OR homophobic OR homophobics OR homophobes OR homophobe OR homophobia OR transphobic OR transphobics OR transphobe OR transphobes OR transphobia

Intent Threats

(threat OR threaten OR threatened OR threatening OR threats OR vandalize OR vandalizes OR vandalized OR vandalizing OR "shooting spree" OR "shooting sprees" OR "bomb threat" OR "bomb threats" OR "going to kill" OR "going to shoot" OR "going to stab" OR "going to destroy" OR "going to murder" OR "going to hurt" OR "want to shoot" OR "want to hurt" OR "want to kill" OR "want to stab" OR "want to destroy" OR "want to murder" OR "blow up" OR kidnap OR kidnapping OR weapon OR weapons OR attacked OR attacking OR attacker OR "burn down" OR burndown OR bombing OR bombed OR bomb OR riots OR riot OR "suspicious package" OR "suspicious device" OR assassinate) NEAR/6 ("going to" OR gonna OR planning OR "planning to" OR plotting OR "plotting to")

Lawsuits

lawsuit OR lawsuits OR "legal proceeding" OR legalproceeding OR "legal proceedings" OR legalproceedings OR sueing OR sued

Misinformation

misinformation OR "mis information"

Protests

protest OR protests OR protesting OR protestor OR protestors OR protester OR protesters OR protested

Regulatory Sanctions

"regulatory sanction" OR regulatorysanction OR "regulatory sanctions" OR regulatorysanctions

Threats

threat OR threaten OR threatened OR threatening OR threats OR vandalize OR vandalizes OR vandalized OR vandalizing OR "shooting spree" OR "shooting sprees" OR "bomb threat" OR "bomb threats" OR "going to kill" OR "going to shoot" OR "going to stab" OR "going to destroy" OR "going to murder" OR "going to hurt" OR "want to shoot" OR "want to hurt" OR "want to kill" OR "want to stab" OR "want to destroy" OR "want to murder" OR "blow up" OR kidnap OR kidnapping OR weapon OR weapons OR attacked OR attacking OR attacker OR "burn down" OR burndown OR bombing OR bombed OR bomb OR riots OR riot OR "suspicious package" OR "suspicious device"

Positive

sentiment:"positive"

Negative

sentiment:"negative"

Neutral

sentiment:"neutral"

Not Rated

sentiment:"u"

level_1

level_2

level_3

adult

arts_and_entertainment

celebrities_and_entertainment_news

comics_and_animation

anime_and_manga

cartoons

comics

entertainment_industry

film_and_tv_industry

recording_industry

events_and_listings

bars_clubs_and_nightlife

concerts_and_music_festivals

event_ticket_sales

expos_and_conventions

film_festivals

food_and_beverage_events

live_sporting_events

movie_listings_and_theater_showtimes

fun_and_trivia

flash-based_entertainment

fun_tests_and_silly_surveys

humor

funny_pictures_and_videos

live_comedy

political_humor

spoofs_and_satire

movies

action_and_adventure_films

animated_films

bollywood_and_south_asian_film

classic_films

comedy_films

cult_and_indie_films

dvd_and_video_shopping

documentary_films

drama_films

family_films

horror_films

movie_memorabilia

movie_reference

musical_films

romance_films

science_fiction_and_fantasy_films

thriller_crime_and_mystery_films

music_and_audio

cd_and_audio_shopping

classical_music

country_music

dance_and_electronic_music

experimental_and_industrial_music

folk_and_traditional_music

jazz_and_blues

music_art_and_memorabilia

music_education_and_instruction

music_equipment_and_technology

music_reference

music_streams_and_downloads

music_videos

podcasts

pop_music

radio

religious_music

rock_music

soundtracks

urban_and_hip-hop

vocals_and_show_tunes

world_music

offbeat

occult_and_paranormal

online_media

online_image_galleries

virtual_tours

performing_arts

acting_and_theater

broadway_and_musical_theater

circus

dance

magic

opera

tv_and_video

online_video

tv_commercials

tv_guides_and_reference

tv_networks_and_stations

tv_shows_and_programs

visual_art_and_design

architecture

art_museums_and_galleries

design

painting

photographic_and_digital_arts

sculpture

visual_arts_and_design_education

autos_and_vehicles

bicycles_and_accessories

bmx_bikes

bike_accessories

bike_frames

bike_helmets_and_protective_gear

bike_parts_and_repair

electric_bicycles

kids'_bikes

mountain_bikes

road_bikes

boats_and_watercraft

campers_and_rvs

classic_vehicles

commercial_vehicles

cargo_trucks_and_trailers

custom_and_performance_vehicles

motor_vehicles_(by_brand)

audi

bmw

bentley

buick

cadillac

chevrolet

chrysler

citroën

dodge

ferrari

fiat

ford

gmc

honda

hyundai

jaguar

jeep

kia

lamborghini

land_rover

lincoln

mazda

mercedes-benz

mercury

mini

mitsubishi

nissan

pontiac

porsche

ram_trucks

renault

rolls-royce

skoda

subaru

suzuki

tesla_motors

toyota

vauxhall-opel

volkswagen

volvo

motor_vehicles_(by_type)

autonomous_vehicles

compact_cars

convertibles

coupes

diesel_vehicles

hatchbacks

hybrid_and_alternative_vehicles

luxury_vehicles

microcars_and_subcompacts

motorcycles

off-road_vehicles

scooters_and_mopeds

sedans

sports_cars

trucks_vans_and_suvs

personal_aircraft

vehicle_codes_and_driving_laws

drunk_driving_law

vehicle_licensing_and_registration

vehicle_parts_and_services

gas_prices_and_vehicle_fueling

towing_and_roadside_assistance

vehicle_modification_and_tuning

vehicle_parts_and_accessories

vehicle_repair_and_maintenance

vehicle_shopping

used_vehicles

vehicle_dealers_and_retailers

vehicle_specs_reviews_and_comparisons

vehicle_shows

beauty_and_fitness

beauty_pageants

cosmetic_procedures

cosmetic_surgery

spas_and_beauty_services

manicures_and_pedicures

massage_therapy

body_art

cosmetology_and_beauty_professionals

face_and_body_care

clean_beauty

hygiene_and_toiletries

make-up_and_cosmetics

perfumes_and_fragrances

skin_and_nail_care

sun_care_and_tanning_products

unwanted_body_and_facial_hair_removal

fashion_and_style

fashion_designers_and_collections

fitness

bodybuilding

fitness_equipment_and_accessories

fitness_instruction_and_personal_training

gyms_and_health_clubs

high_intensity_interval_training

yoga_and_pilates

hair_care

hair_loss

shampoos_and_conditioners

weight_loss

books_and_literature

audiobooks

book_retailers

children's_literature

e-books

fan_fiction

literary_classics

poetry

writers_resources

business_and_industrial

advertising_and_marketing

brand_management

marketing

public_relations

sales

telemarketing

aerospace_and_defense

aviation_industry

space_technology

agriculture_and_forestry

agricultural_equipment

aquaculture

crops_and_seed

farms_and_ranches

forestry

livestock

automotive_industry

business_education

business_finance

commercial_lending

investment_banking

risk_management

venture_capital

business_operations

business_plans_and_presentations

flexible_work_arrangements

human_resources

management

business_services

commercial_distribution

consulting

corporate_events

e-commerce_services

fire_and_security_services

knowledge_management

office_services

office_supplies

outsourcing

physical_asset_management

quality_control_and_tracking

shared_workspaces

signage

warehousing

writing_and_editing_services

chemicals_industry

agrochemicals

cleaning_agents

coatings_and_adhesives

dyes_and_pigments

plastics_and_polymers

construction_and_maintenance

building_materials_and_supplies

civil_engineering

energy_and_utilities

electricity

nuclear_energy

oil_and_gas

renewable_and_alternative_energy

waste_management

hospitality_industry

event_planning

event_venue_rentals

food_service

industrial_materials_and_equipment

fluid_handling

generators

heavy_machinery

industrial_handling_and_processing_equipment

manufacturing

factory_automation

metals_and_mining

precious_metals

pharmaceuticals_and_biotech

printing_and_publishing

document_and_printing_services

retail_trade

retail_equipment_and_technology

transportation_and_logistics

import_and_export

mail_and_package_delivery

maritime_freight_transport

moving_and_relocation

other_freight_transport

packaging

rail_freight_transport

self_storage

small_business

business_formation

home_office

mlm_and_business_opportunities

textiles_and_nonwovens

computers_and_electronics

cad_and_cam

computer_hardware

computer_components

computer_drives_and_storage

computer_peripherals

computer_servers

desktop_computers

hardware_modding_and_tuning

laptops_and_notebooks

computer_security

antivirus_and_malware

hacking_and_cracking

network_security

consumer_electronics

audio_equipment

camera_and_photo_equipment

car_electronics

drones_and_rc_aircraft

electronic_accessories

gps_and_navigation

gadgets_and_portable_electronics

game_systems_and_consoles

home_automation

media_streaming_devices

tv_and_video_equipment

virtual_reality_devices

electronics_and_electrical

data_sheets_and_electronics_reference

electrical_test_and_measurement

electromechanical_devices

electronic_components

optoelectronics_and_fiber

power_supplies

enterprise_technology

customer_relationship_management_(crm)

data_management

enterprise_resource_planning_(erp)

helpdesk_and_customer_support_systems

networking

data_formats_and_protocols

distributed_and_cloud_computing

network_monitoring_and_management

networking_equipment

vpn_and_remote_access

programming

c_and_c++

development_tools

java_(programming_language)

scripting_languages

windows_and_.net

software

business_and_productivity_software

device_drivers

educational_software

freeware_and_shareware

intelligent_personal_assistants

internet_software

monitoring_software

multimedia_software

open_source

operating_systems

software_utilities

finance

accounting_and_auditing

billing_and_invoicing

bookkeeping

tax_preparation_and_planning

banking

atms_and_branch_locations

debit_and_checking_services

mobile_payments_and_digital_wallets

money_transfer_and_wire_services

savings_accounts

credit_and_lending

credit_cards

credit_reporting_and_monitoring

debt_collection_and_repossession

debt_management

loans

crowdfunding

financial_planning_and_management

asset_and_portfolio_management

inheritance_and_estate_planning

retirement_and_pension

grants_scholarships_and_financial_aid

government_grants

study_grants_and_scholarships

insurance

health_insurance

home_insurance

life_insurance

travel_insurance

vehicle_insurance

investing

brokerages_and_day_trading

commodities_and_futures_trading

currencies_and_foreign_exchange

derivatives

funds

real_estate_investment_trusts

socially_responsible_investing

stocks_and_bonds

food_and_drink

beverages

alcohol-free_beverages

alcoholic_beverages

bottled_water

coffee_and_tea

energy_drinks

juice

nutrition_drinks_and_shakes

soft_drinks

cooking_and_recipes

bbq_and_grilling

cuisines

culinary_training

desserts

healthy_eating

salads

soups_and_stews

food

food_and_grocery_delivery

grocery_delivery_services

meal_kits

restaurant_delivery_services

food_and_grocery_retailers

bakeries

butchers

convenience_stores

delicatessens

farmers'_markets

food

baked_goods

breakfast_foods

candy_and_sweets

condiments_and_dressings

cooking_fats_and_oils

dairy_and_egg_substitutes

dairy_and_eggs

fruits_and_vegetables