Tweets

When Tweets is selected as the search type in the General tab, the input for the activity is as follows.

Input Item Data Type Description
query string A UTF-8, URL-encoded search query of 1,000 characters maximum, including operators. Queries may additionally be limited by complexity.

For example, @noradio.

geocode complex The location parameters that are used to locate the user. The location is preferentially taking from the Geotagging API, but falls back to their Twitter profile.

This parameter consists of latitude, longitude, and radius, where radius units must be specified as either "mi" (miles) or "km" (kilometers). For example, 37.781157, -122.398720,1mi.

Note: You cannot use the near operator via the API to geocode arbitrary locations; however, you can use this geocode parameter to directly search near geocode. A maximum of 1,000 distinct "sub-regions" is considered when using the radius modifier.
language string The list of languages supported by Twitter along with their ISO 639-1 code.
locale string The language of the query you are sending (only ja is currently effective). This is intended for language-specific clients and the default works in the majority of cases.
resultType string The type of search results you want to receive. Select from one of the following options:
  • mixed: includes both popular and real-time results in the response.
  • recent: returns only the most recent results in the response.
  • popular: returns only the most popular results in the response.
count integer The number of tweets to return per page.

By default, 100 tweets are returned. The maximum number of tweets to return is 800.

until date The date that the tweet was generated. The date is in the format of YYYY-MM-DD.

For example, 2010-03-28.

sinceId long The ID greater than (that is, more recent than) the specified ID is returned.

There are limits to the number of Tweets which are accessed through the API. If the limit of Tweets has occurred since the since_id, the since_id is forced to the oldest ID available.

maxId long The ID less than (that is, older than) or equal to the specified ID is returned.

For example: 54321.