AND, OR, and NOT are the most common query operators, PeakMetrics supports other advanced ones.
Below is a complete list of all the search operators that you can use when building queries in PeakMetrics.
- Start by creating a Workspace
- Select your channels
- Toggle to Advanced Query to create your Boolean query
- Compose your query using any of the following operators
| Operator | Action | Example | Result |
|---|---|---|---|
| AND | Narrows your search by retrieving mentions where both terms are present. AND must be capitalized. | "agriculture" AND "regenerative" | Any document where “agriculture” and “regenerative” are both included. |
| OR | Retrieve mentions to contain at least one search term. OR must be capitalized. | "agriculture" OR "regenerative" | Either “agriculture” or “regenerative” must appear in the document. |
| NOT | Excludes mentions of unwanted terms. Must be capitalized. | "agriculture" NOT "regenerative" | Any document that mentions “agriculture” and does not mention “regenerative”. |
| GROUPING | Multiple terms or clauses can be grouped together with parentheses, to form sub-queries. | ("agriculture" OR "farming") AND "regenerative" | Either agriculture or farming are present and regenerative is always present. |
| LANGUAGE | Matches documents without specified language. | AND (language:"english" OR language:"en")) | Any document that was created in English, or not in English. |
| PROXIMITY | We use proximity as a replacement for the AND function. The proximity helps increase likelihood that the two terms are being spoken in context of each other. | "Regenerative agriculture"~10 | Returns results with Regenerative and Agriculture within at most 10 words apart from each other. The phrase “regenerative agriculture” would be considered more relevant than “regenerative farming, grassland, and agriculture”. Pro Tip - try ~5, ~7, and ~10 on your query and see how the volume and relevance of results change! |
| FUZZINESS | Matches words that are similar to the word that you are looking to track. | Agriculture~ | Returns documents that mention Agriculture spelled incorrectly, or in different languages. |
| SENTIMENT | Matches documents with provided sentiment. Supported values: between -1 and 1 on a decimal scale. | "agriculture" AND sentiment.polarity:[* TO -.1] | Returns any document mentioning agriculture that has a negative sentiment. |
| SOCIAL ENGAGEMENT | Matches the number of Twitter Likes (previous called Favorites) + the number of retweets. | "agriculture" AND socialcount_last:[10 TO 999] | Returns any news document about agriculture that has been liked or retweeted between 10 and 999 times over Twitter or Reddit. |
| CASE SENSITIVITY | Pulls content based on case sensitivity. | text.case_sensitive:AGRICULTURE | Returns documents where agriculture returns in only capital letters. |
| TWITTER LIST | Pulls content based on specified Twitter list | AND twitter_list: 34179516 | Returns tweets from specified twitter lists only. Input the Twitter URL to the query to generate your results. |
| AUTHOR | Matches documents by a specific author or username. | AND author: "RegenerativeAg" | Returns documents from the social handle @RegenerativeAg |
| TITLE | Matches documents that have the specified word / phrase in the title. | AND title:"*Regenerative Agriculture*" | Any document that has “Regenerative Agriculture” in its title. |
| TWITTER FOLLOWERS | Matches Twitter documents from handles that have a number of followers within a given range. | AND user.followers:[1000 TO 10,000] | Matches documents from Twitter handles with between 1,000 and 10,000 followers. |
| SUBREDDIT | Matches Reddit documents from a specific Subreddit. | AND subreddit:sustainability | Returns Reddit documents from the Subreddit “r/sustainability” |
| DE - DUPLICATION | Removes duplicated news sites | AND (is_original_title:true OR NOT canonical:*) | Returns the original article / link |
| NOT NSFW | Matches non-NSFW content | AND NOT nsfw: true | Removes content not tagged as NSFW by its source |
| MENTION TYPE | Excludes mentions that are a reply/comment, a repost/share/retweet, or quoted another mention. | AND NOT references.type: ("retweeted" OR "replied_to" OR "quoted") | Limits your results to only original posts |