Events

List events

Returns monitor events with cursor pagination and filters.

get/api/v1/events

Query parameters

limitinteger

Maximum items per page: 1 to 100, default 50. Credits can reduce paid results. With none affordable, it returns 402 insufficient_credits.

cursorstring

Previous nextCursor. Offset pagination is not supported.

monitorIdstring

Account monitor ID.

keywordMonitorIdstring

Keyword monitor ID.

eventType'tweet.new' | 'tweet.reply' | 'tweet.retweet' | 'tweet.quote' | 'tweet.media' | 'tweet.link' | 'tweet.poll' | 'tweet.mention' | 'tweet.hashtag' | 'tweet.longform' | 'profile.avatar.changed' | 'profile.banner.changed' | 'profile.name.changed' | 'profile.username.changed' | 'profile.bio.changed' | 'profile.location.changed' | 'profile.url.changed' | 'profile.verified.changed' | 'profile.protected.changed' | 'profile.pinned_tweet.changed' | 'profile.unavailable.changed'

Type of monitor event fired when account activity occurs.

Example:tweet.new

Filter events by type

Response

Event list

hasMoreboolean required
nextCursorstring

Example response

{
  "events": [],
  "nextCursor": "abc123"
}

Changes

Changed in 11 of the 41 revisions of this API.11244

  • b998ecc8aaa611See the full diff
    • ▲

      for the query request parameter limit, the format changed from no format to int64

      request-parameter-type-changed

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ●

      added the new draw_too_large enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ●

      added the new draw_too_large enum value to the ////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new draw_too_large enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new draw_too_large enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new draw_too_large enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new draw_too_large enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new draw_too_large enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new draw_too_large enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new retweeters_incomplete enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ●

      added the new retweeters_incomplete enum value to the ////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new retweeters_incomplete enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new retweeters_incomplete enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new retweeters_incomplete enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new retweeters_incomplete enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new retweeters_incomplete enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new retweeters_incomplete enum value to the // response property for the response status

      response-property-enum-value-added

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 9ae77b3e4fdc61See the full diff
    • ●

      added the new bookmark_folders_unavailable enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ●

      added the new bookmark_folders_unavailable enum value to the ////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new bookmark_folders_unavailable enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new bookmark_folders_unavailable enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new bookmark_folders_unavailable enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new bookmark_folders_unavailable enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ●

      added the new search_unavailable enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ●

      added the new search_unavailable enum value to the ////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new search_unavailable enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new search_unavailable enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new search_unavailable enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new search_unavailable enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new idempotency_in_progress enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ●

      added the new idempotency_in_progress enum value to the ////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new idempotency_in_progress enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new idempotency_in_progress enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new idempotency_in_progress enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new idempotency_in_progress enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    • ●

      added the new likes_unavailable enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ●

      added the new likes_unavailable enum value to the ////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new likes_unavailable enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new likes_unavailable enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new likes_unavailable enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new likes_unavailable enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new pagination_stalled enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ●

      added the new pagination_stalled enum value to the ////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new pagination_stalled enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new pagination_stalled enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new pagination_stalled enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new pagination_stalled enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new x_reply_not_allowed enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ●

      added the new x_reply_not_allowed enum value to the ////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new x_reply_not_allowed enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new x_reply_not_allowed enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new x_reply_not_allowed enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new x_reply_not_allowed enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new closed enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ●

      added the new closed enum value to the ////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new closed enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new closed enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new closed enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new closed enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new expired enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ●

      added the new expired enum value to the ////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new expired enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new expired enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new expired enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new expired enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_complete_replies_request enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_complete_replies_request enum value to the ////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_complete_replies_request enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_complete_replies_request enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_complete_replies_request enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_complete_replies_request enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_request enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_request enum value to the ////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_request enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_request enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_request enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_request enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_output_options enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_output_options enum value to the ////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_output_options enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_output_options enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_output_options enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_output_options enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_reply_options enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_reply_options enum value to the ////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_reply_options enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_reply_options enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_reply_options enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_reply_options enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new login_service_unavailable enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ●

      added the new login_service_unavailable enum value to the ////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new login_service_unavailable enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new login_service_unavailable enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new login_service_unavailable enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new login_service_unavailable enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new missing_url enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ●

      added the new missing_url enum value to the ////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new missing_url enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new missing_url enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new missing_url enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new missing_url enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new too_many_tweets enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ●

      added the new too_many_tweets enum value to the ////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new too_many_tweets enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new too_many_tweets enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new too_many_tweets enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new too_many_tweets enum value to the // response property for the response status

      response-property-enum-value-added