Build Your Query

Within Listen you are able to monitor your brand presence, see what your competitors are doing, assess how your campaigns are performing and hear what influential people are talking about.

Our Query Builder helps you discover more relevant content on social media and from around the wider web.

Below is a quick guide to the Query Builder. For help with the Advanced builder, please click here.

Build your first query

  1. Within Listen, create your Project and add a new Topic.
  2. Name your Topic. You will now see the Query Builder.
  3. Input keywords that your results must contain in the 1st text box.
  4. To add context to your query, you can add terms in the 2nd text box.
  5. If there are terms you want to exclude, enter these in the 3rd text box.
  6. Pick which sources to listen to from the dropdown.
  7. Under Filters, you're able to select a range of filters, as detailed below.
  8. Click Save.

As you enter your query, live results will be displayed under the builder. Note, these are based on previously sourced data and are only an estimate of what your query will pick up.

Query builder

Construct the core of your project by adding the keywords you want to search for.

All of these
This field is for retrieving ALL of the words or phrases inputted. Separate words or phrases using spaces. For example, the input of apples oranges will return results where both the words apples and oranges are found.
One of these
This field is used to help contextualize your query. Separate words or phrases using spaces. For example, the input of vehicle plane here will return results where either the words vehicle or plane are found.
Exclude these
This field is used to disregard words from queries. Separate words or phrases using spaces. For example, the input of pencil desk here will exclude results where either the words pencil or desk are found.

Note:

This field cannot be used alone, you must also use `All of these` or `One of these` in combination with it.

Searching for a phrase
Add 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 hashtags at this time.
Twitter
Use an @ sign to listen to or exclude mentions of specific Twitter profiles. For example, @username.
Advanced
This option is for more experienced users. You can either begin writing your query in the Advanced builder, or edit the query you created under the Query option to make it more complex.

Filters

Refine your keywords search with filters.

Note:

Please keep in mind that when using filters you will only get mentions that contain the specified field and therefore it will significantly reduce 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.
Country
Where possible, we will filter results by the country from which they came from. Filtering by 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 them.
Sentiment
When sentiment is assigned, you can filter by Positive, Neutral or Negative. Results with no sentiment rating will be excluded.
url
Enabling this filter returns or excludes results that mention a specified url.
Media
You can define the types of results you receive by the rich media they contain, e.g. image or video.
twitterfollowers
You can limit Twitter results to users with a specified range of followers.

An easy example

Let's say you want to curate user-generated social media content based on the experience of attending a sports event at Yankee Stadium in New York.

In the 1st box of the Query Builder, you can enter the word Yankee. In the 2nd box, to add context, enter terms such as stadium, #Mlb and "New York" (note, you do not need to enter any operators here, just use a space). To exclude irrelevant mentions, you could add Rangers in the 3rd box for example.

To group a combination of words together or to include punctuation, use double quote marks, such as "New York's finest".

Next, to narrow down the results to Instagram and Twitter, use the Sources drop-down menu. To further filter by media type, you can select the Media filter in the Filters drop-down menu and select is followed by image.

Using the above example, your final query will read: 

Yankee (Stadium OR #Mlb OR "New York") -(Rangers) (Media:image)

For help with the Advanced builder, please click here.

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