You are here: Tools > All Tools > Twitter Search

Twitter Search Tool

The Twitter Search tool allows you to search tweets by given search terms, with location as an optional property. The search will only retrieve tweets from the previous seven days.

Beginning with Alteryx 10.6, this tool is not automatically installed with Alteryx Designer. To use this tool, download it from the Alteryx Analytics Gallery.

IMPORTANT!  Before you can you use this tool, you must register an application with Twitter. Log in to your Twitter account at, click “Create a new application”, and complete the form (a placeholder website may be used and there is no need for a Callback URL). Once you have submitted the application form, you will be provided with a Consumer Key and Consumer Secret that you can use to configure the tool.

Configuration Properties

Configuration Tab

  1. Specify the Authentication parameters:

  2. Record Limit: Specify the number of records to request, up to a maximum of 100,000 records.

  3. The API returns approximately 500-1000 records per minute so the tool may take a long time to return the data if you set a high record limit. During execution, a counter in the Results window lets you know how many records have been downloaded so far.

Search Tab

  1. Standard Search: The Standard Search option gives you the ability to search for Tweets without requiring any knowledge of the Twitter API syntax. Except as indicated below, there is no need to include any special punctuation (no commas, quotes, or parentheses) in the Standard Search text boxes.

    If you choose Standard Search, you’ll see eight text boxes in which to enter search criteria. You can enter criteria into one or all text boxes. The tool takes all the criteria you enter and configures it into one combined query.

  2. ‘Any’, ‘Hashtags’, ‘From’, ‘To’, and ‘Mentions’ are each treated like “OR” searches (i.e., each word in the text boxes is implicitly separated by the word “OR”).  Do not include the word “OR” in any of the text boxes.

  3. Custom Search: The Custom Search option allows users to do a more advanced search than the Standard Search. However, unlike the Standard Search, using Custom Search requires utilizing the proper Twitter API syntax.

Location Tab

  1. Enable geocoded search: Returns tweets by users located within a radius of a given latitude/longitude.

  2. Set query centroid: Specifies the latitude and longitude coordinates for the center of the search radius.

  3. Set query radius (mi): Sets the size of the search radius for the geo search. Defaults to five, with a max size of 1000.

Related Topics Link IconRelated Topics