Xquik

Xquik

Certified

Xquik X/Twitter public data plugin for Kestra

Xquik tasks let Kestra flows retrieve public X/Twitter data for scheduled research, monitoring, and reporting workflows.

The plugin includes read-only tasks for:

  • Searching public posts.
  • Fetching one public post by ID.
  • Searching public users.
  • Fetching one public user by username or ID.
  • Fetching recent public posts from a user.
  • Listing regional trends.

Use {{ secret('XQUIK_API_KEY') }} for the apiKey property. Search and list tasks support fetchType so larger responses can be stored in Kestra internal storage.

How to use the Xquik plugin

Retrieve public X/Twitter posts, users, and trends via the Xquik API from Kestra flows.

Authentication

All tasks require apiKey (your Xquik API key, required). Optionally set baseUrl (default https://xquik.com/api/v1) and options for HTTP client configuration (connect timeout, read idle timeout, custom headers). Store the API key in secrets and apply connection properties globally with plugin defaults.

Tasks

All tasks share a fetchType property (default FETCH): FETCH returns results inline as body; FETCH_ONE returns the first result; STORE writes results to Kestra internal storage and outputs a uri. Paginated tasks also output nextCursor and hasNextPage.

tweets.Search searches public posts — set query (required, supports X search operators). Optionally set queryType (Latest or Top, default Latest), limit (default 20), cursor (pagination), sinceTime and untilTime (ISO 8601 timestamps), and additionalQueryParameters for Xquik-specific filters.

tweets.Get fetches a single post by ID — set tweetId (required).

users.Search searches public user accounts — set query (required). Optionally set cursor for pagination.

users.Get fetches a single user profile — set user (required; accepts either a username or a numeric user ID).

users.Tweets fetches recent posts from a user — set user (required). Optionally set includeReplies (default false), includeParentTweet (default false), cursor, and additionalQueryParameters.

trends.List returns trending topics for a region — set woeid (Yahoo Where On Earth ID, default 1 for worldwide) and count (default 30).