Sign in
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. The endpoint returns 402 insufficient_credits when none are affordable.

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 2 of the 19 revisions of this API.721

  • 5d4938bb7de354See the full diff
    • ●

      added the new closed enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new closed enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new closed enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new closed enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new closed enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new closed enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

    • ●

      added the new expired enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new expired enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new expired enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new expired enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new expired enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new expired enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

    • ●

      added the new invalid_complete_replies_request enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new invalid_complete_replies_request enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_request enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_request enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

    • ●

      added the new invalid_output_options enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new invalid_output_options enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new invalid_output_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new invalid_output_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new invalid_output_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new invalid_output_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

    • ●

      added the new invalid_reply_options enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new invalid_reply_options enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new invalid_reply_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new invalid_reply_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new invalid_reply_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new invalid_reply_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

    • ●

      added the new login_service_unavailable enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new login_service_unavailable enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new login_service_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new login_service_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new login_service_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new login_service_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

    • ●

      added the new missing_url enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new missing_url enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new missing_url enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new missing_url enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new missing_url enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new missing_url enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

    • ●

      added the new too_many_tweets enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new too_many_tweets enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new too_many_tweets enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new too_many_tweets enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new too_many_tweets enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new too_many_tweets enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

  • 4da209b29df8181See the full diff
    • ●

      added the new coverage_cursor_gone enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_gone enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_gone enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_gone enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_gone enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_gone enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_unavailable enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_unavailable enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_cursor enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_cursor enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

    • ○

      added the new optional query request parameter keywordMonitorId

      new-optional-request-parameter