Advanced Boolean Reference Guide

Last Modified on 10/12/2022 3:11 pm CDT

Advanced Boolean Filters

tk_location:"Region"
The tk_location:"Region" filter targets articles that are tagged with a specific region, via their
domains. For example, to search for content from North America, we would need to add "North
America" after the tk_location: filter. Click here for a targeted list of supported regions.

Example 1 (One Region)

tk_location:"North America" AND "Amazon" AND "electronics"

This tells the platform to return only those articles from "North America" that include the words
“Amazon” AND “electronics”.

Example 2 (Multiple Regions)

((tk_location:"North America" OR tk_location:"APAC" OR tk_location:"EMEA") AND "Amazon" AND "electronics")

This tells the platform to only return articles from either North America, APAC or EMEA that
include both “Amazon” AND “electronics”.

tk_location:"Country"
The tk_location:"Country" filter targets articles that are tagged with a specific country, via their
domains. For example, to search for content from United States, we would need to add "United
States" after the tk_location: filter.

Example 1 (One Country)

tk_location:"United States" AND "Amazon" AND "electronics"

This tells the platform to return only those articles from "United States" that include the words
“Amazon” AND “electronics”.

Example 2 (Multiple Countries)

 ((tk_location:"United States" OR tk_location:"France" OR tk_location:"Canada") AND "Amazon" AND "electronics"
)

This tells the platform to only return articles from either United States, France or Canada that
include both “Amazon” AND “electronics”.

state:
The state: filter targets articles that are tagged with a specific state, via their domains. For example,
to search for content from Illinois, we would need to add "Illinois" after the state: filter.

Example 1 (One State)

state:"Illinois" AND "Amazon" AND "electronics"

This tells the platform to return only those articles from "Illinois" that include the words “Amazon”
AND “electronics”.

Example 2 (Multiple Countries)

((state:"Illinois" OR state:"Wisconsin" OR state:"Iowa") AND "Amazon" AND "electronics"

)

This tells the platform to only return articles from either Illinois, Wisconsin or Iowa that include
both “Amazon” AND “electronics”.

city:
The city: filter targets articles that are tagged with a specific city, via their domains. For example, to
search for content from Chicago, we would need to add "Chicago" after the city: filter.

Example 1 (One City)

city:"Chicago" AND "Amazon" AND "electronics"

This tells the platform to return only those articles from "Chicago" that include the words
“Amazon” AND “electronics”.

Example 2 (Multiple Cities)

((city:"Chicago" OR city:"Milwaukee" OR city:"Iowa City") AND "Amazon" AND "electronics"

)
This tells the platform to only return articles from either Chicago, Milwaukee or Iowa City that
include both “Amazon” AND “electronics”.

tk_language:
The tk_language: filter targets articles that are tagged with a specific language, via their domains.
For example, to search for content in English, we would need to add "English" after the
tk_language: filter.

Example 1 (One Language)

tk_language:"English" AND "Amazon" AND "Kindle"

This tells the platform to return only those articles in "English" that include the words “Amazon”
AND “Kindle”.

Example 2 (Multiple Languages)

((tk_language:"English" OR tk_language:"French" OR tk_language:"German") AND "Amazon" AND "Kindle"

)

This tells the platform to only return articles in either English, French or German that include both
“Amazon” AND “Kindle”.

site_urls_ll:
The site_urls_ll: operator targets articles that are tagged as a specified media outlet, via their
domains. For example, to search within the Wall Steet Journal, we would need to write wsj.com
after the site_urls_ll: operator, not “Wall Street Journal”.

Example 1

site_urls_ll:"nytimes.com" AND "Amazon" AND "electronics"

This tells the platform to return only those articles from the “nytimes.com” that include the words
“Amazon” AND “electronics”

Example 2 (multiple publications)

site_urls_ll:("nytimes.com" OR "wsj.com" OR "financialpost.com") AND "Amazon" AND "electronics

"

This tells the platform to only return articles from either the nytimes.com, wsj.com or
financialpost.com that include both “Amazon” AND “electronics”.
IMPORTANT: Any base URL will include all subdomains. For example, wsj.com pulls content from
wsj.com and blogs.wsj.com. Conversely, if you only listed blogs.wsj.com it would pull from the blog
but not the rest of the site.

~ The Near Operator

The near operator requires that your terms appear within a specified proximity of each other, in any
order. In the platform, you must use quotation marks around the search terms.

"Amazon Prime Now"~

5

This tells the platform to return only those articles that mention the words “Amazon”, “Prime” and
“Now” within 5 words of each other, in any order, regardless of capitalization.

text:"Amazon" AND ("Amazon Prime"~5 OR "Amazon orginals"~5 )

This tells the platform to return only articles that mention the word Amazon (capitalized) and also
either “Amazon” AND “prime” within 5 words of each other, OR “Amazon” AND “originals” within 5
words of each other.

IMPORTANT: There must be a space between a near operator

and a closed parenthesis: (~x ).

tag:
Using the "tag" operator allows you to pull articles from a tag into your search results. For example,
you can use tagging to credit a member of your organization for pitching a story that got picked
up.

tag:"Cindy" AND ("Target Target Target"~600 OR title:"Target")

This tells the platform to return any articles tagged "Cindy" and that either mention target thrice
or in the headline.

author:
The "author" operator targets articles tagged with the specified author, is case sensitive and must
appear exactly as it does in the platform.
 author:"Emily Glazer" AND ("Amazon" AND "Prime Now")

This tells the platform to only return articles that are tagged with the author “Emily Glazer” and
also include the keyword, “Amazon” AND the phrase, “Prime Now”.

mediatype:
The "mediatype" operator targets a specific type of media (values are "broadcast", "News", and
"Blogs")

In order to see “broadcast” media, you must be subscribed to our broadcast service. If you are not
yet subscribed and are interested in the service, contact your Account Manager for details.

mediatype:"broadcast" AND ("Dove" AND "Soap")

This tells the platform to return only broadcast clips that mention the words “Dove” AND “Soap”.