Advanced Boolean Reference Guide

Modified on: Mon, 21 Nov, 2022 at 9:36 PM

Advanced Boolean Filters:


tk_location:"Region"

The tk_location:"Region" filter targets articles 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 tagged with a specific country via their domains. For example, to search for content from the 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 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 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 tagged as a specified media outlet via their domains. For example, to search within the Wall Street Journal, we 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 “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 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 seems to 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" 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")

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.”

Note: This is only applicable for certain users

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select atleast one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article