Build Advanced Queries

If the query you have built in the Query Builder returns a lot of noise, you now have the option to add additional parameters and create even more complex queries, using grouping and advanced filters.

Fine-tune your query

  1. After using the Query Builder, select Advanced.
  2. Under Advanced you can build your query using a range of parameters and filtering options (see below). Refer to the Cheatsheet for further information.
  3. The system will automatically validate your query and produce estimated results in the Live Preview.
  4. Click Save. 

Boolean operators

Use these to connect your keywords together, and to define their relationship.

And
Enter a space between words or groups to retrieve results where all the words/groups appear. For example, listening to apples oranges will return only mentions where both apples and oranges are found. The space replaces the need to type AND between words or groups.
OR
Use this parameter to retrieve results for at least one word. For example, listening to apples OR oranges will return mentions where either apples or oranges are found. Placing a negation - after an OR, such as pepsi OR -fanta is discouraged as that would match results mentioning “pepsi”, and anything not mentioning “fanta”. However, negations can be added later in the query, such as soda (pepsi OR -fanta).
-terms

Place a negation - in front of a word or group to exclude results containing that word, group or phrase. For example, inputting falcon -(bird OR nest) will return results with the word falcon in it and exclude results with the words bird or nest.

Note:

A negation cannot stand alone, as that would match almost everything. So for instance -(bird OR nest) is not valid, but falcon -(bird OR nest) is valid.

(Grouping)
Using parentheses, it is possible to group together combinations of queries. For example, listening to (apple OR orange) -(juice OR smoothie) will return results where either apple or orange appear while filtering out any mention where apple or orange appear with either juice or smoothie.
"Text"
Adding quote marks around words to return results of exactly that phrase. For example, the input of "orange juice" in any input field, will return results containing the phrase "orange juice" - not "juice orange". For Instagram, we recommend you use single words to discover content as we can only listen to hash-tags at this time.
"Proximity clause"~5

To search for a combination of words that appear close together in a sentence, add a tilde (or squiggle) symbol, ~.

Example: "FalconIO social"~5 could return a result that contains 'Fun quiz to determine your social media persona. I'm the Social Siren! via @FalconIO'.

Wildcard

To listen to various versions of a word without using multiple OR operators. Example: (customi?e) will return results that contain 'customize' and 'customise'.

Note:

The ? operator returns results that differ by a single character. For zero or multiple characters, you can use the * operator.

Example: (comput*) will return results such as compute, computer, computing etc.

Filters

Refine your keywords search with filters.

Note:

Please keep in mind that when using the data filters you will only get mentions that contain the specified data, significantly reducing the number of results. For instance, if you try to filter by language or country it will by default filter out results that do not have a language or a country associated with it.

Language

We offer filtering by ISO 639, a standardized way of classifying all known languages. Over 180 languages are catered for. Filtering for a specific language will by default filter out results that do not have a language associated with it. If you expect irrelevant results in other languages, consider excluding them.

Example: language:eng

Country

Where possible, we can filter results by the country from which the mention came from. Filtering for a country will by default filter out results that do not have a country associated with it. If you expect irrelevant results from other countries, consider excluding specific countries instead.

Example: country:usa

Place

Matches only mentions where the location name contains the value. This is mostly used for Tweets, as location data does not generally include a name from other sources. The value can potentially be a phrase if there is a need for spaces, such as in New York. However, if you want to match a phrase, the terms must be inside quotation marks as in the example below.

Example: place:copenhagen or place:"New York"

Sentiment

When sentiment is assigned, you can filter by Positive, Neutral, Negative or Unknown.

Example: sentiment:positive

url

Enabling this filter returns or excludes results that mention a specified url. Please note the difference between url and site:  site is used to find results from the specified website and url is used to find results that mention the specified website.

Example: url:falcon.io

Site

Use this filter to only return results from a specified website.

Example: site:falcon.io

Media

You can define the types of results you receive by the rich media they contain, e.g. image or video.

Example: media:image

From

Matches only mentions that are written by the specified Twitter user, from filters value is interpreted as the handle of the user.

Example: from:falcon.io

twitterfollowers

You can limit Twitter results to users with a specified range of followers. To listen to users with more than 100 twitter followers, for example, use the filter twitterfollowers: 100.

You can also specify a range of followers, for example twitterfollowers:50..100 will filter out profiles with fewer than 50 followers and those with more than 100.

Has

Use this filter to find mentions that have the given field. Supported values are: sentiment, media, hashtags, urls, language, country.

Example: has:sentiment or has:media or has:language

Gender

Use this filter to return results that we have assigned a gender to the author. Allowed values are: undetermined, female, male.

Example: gender:female or gender:male or gender:undetermined

Examples

Word

The most basic query is a one-word query. Case sensitivity is not considered.

Example: Falcon

Phrase

To listen to an exact phrase, quotation marks need to be used.

Example: "Meet your customers"

hashtag

To listen to a hash-tag, just add a # symbol in front of the keyword.

Example: #FalconIO

User mention

To locate a mention of a Twitter user, add an @ sign.

Example: @FalconIO

Proximity

To search for a combination of words that appear close together in a sentence, add a tilde (or squiggle) symbol, ~.

Example: "FalconIO social"~5 would return a result that contains 'Fun quiz to determine your social media persona. I'm the Social Siren! via @FalconIO'.

Parentheses

Use parentheses to combine multiple words within a query.

Example: "orange juice" organic -(strawberry smoothie) will exclude any mentions of strawberry and smoothie where the phrases orange juice and organic are also mentioned.

Group

If you have multiple combinations of phrases and keywords to include or exclude, it is possible to group queries using parentheses.

Example: (Pandora OR tiffany) (jewelry OR charms OR rings OR diamonds) -(radio music) will return results of Pandora or tiffany with either jewelry or charms or rings or diamonds while excluding those results that contain the words radio and music.

Note:

If you change your query in the Advanced Builder you will not be able to use the more basic Query Builder.

Was this article helpful?
1 out of 1 found this helpful