1. Knowledge Base
  2. Creating a Search

Create a Search from a Twitter List

Create an alert to capture mentions directly from your Twitter Lists

Using this feature, you can:

1. Track keywords over Twitter Lists that already exist, and
2. Curate your own Twitter Lists.

This guide will walk you through the steps to setting both up successfully.

Setting up this feature

Firstly, PeakMetrics must be able to access your personal Twitter Lists, so check that your Tweets are not protected (i.e. only visible to your followers).  

Check this setting by clicking More > Settings and Support > Settings and Privacy > Privacy and Safety > Audience and Tagging - the Protect your Tweets box should be unchecked.

Creating a New List

Log in to your Twitter account.

Navigate to the Lists section of the website and create a new list.

Search for and add as many Twitter users to your list as you like.


Set Up an Alert Query using a List ID

1. To get your list ID, navigate to the Twitter list you wish to use and find the list URL.

The Twitter list URL has the format https://twitter.com/i/lists/[LIST ID]:

You will use this list ID to set up your alert query.

2. Under a PeakMetrics advanced search query constructor, use the twitter_list: "[list id]" syntax to find Tweets associated with your Twitter list:

3. Ensure that you have the Twitter V2 button checked under Where do you want to track?

Note: This Twitter list syntax will not translate to alerts set for other platforms.

Example Alerts

Here are a few example alert queries that demonstrate different ways to generate results from Twitter lists.


Get all tweets:

  • From a specified Twitter list:

  • From one or another Twitter list:

  • That appear on both Twitter lists:

  • From the specified Twitter list that contain the text "climate change":


For more tips and tricks, check out our advanced Boolean operator guide!


Feel free to reach out if you'd like some help with getting set up with your Twitter List alerts.