Xquik Search

Xquik Search

Certified

Search tweets

Searches public X/Twitter posts with Xquik and returns a structured response for downstream Kestra tasks.

yaml
type: io.kestra.plugin.xquik.tweets.Search

Search recent posts about an incident.

yaml
id: xquik_tweet_search
namespace: company.research

tasks:
  - id: search_posts
    type: io.kestra.plugin.xquik.tweets.Search
    apiKey: "{{ secret('XQUIK_API_KEY') }}"
    query: "from:kestra_io orchestration"
    queryType: Latest
    limit: 20

Store a larger search response.

yaml
id: xquik_tweet_search_store
namespace: company.research

tasks:
  - id: search_posts
    type: io.kestra.plugin.xquik.tweets.Search
    apiKey: "{{ secret('XQUIK_API_KEY') }}"
    query: "agent framework"
    limit: 100
    fetchType: STORE
Properties

Xquik API key

API key used to authenticate Xquik API requests.

Search query

X search query, including standard operators such as from: , to: , or hashtags.

Additional query parameters

Optional Xquik tweet-search filters, such as language, hashtags, mediaType, or minFaves.

Defaulthttps://xquik.com/api/v1

Xquik API base URL

Base URL for Xquik API requests.

Pagination cursor

Cursor from a previous response.

DefaultFETCH
Possible Values
STOREFETCHFETCH_ONENONE

Result handling mode

Controls how the response is exposed. FETCH returns the response body, STORE writes it to Kestra internal storage, and NONE omits the body.

Default20

Result limit

Maximum tweets to request from Xquik.

HTTP request options

Options used to customize the HTTP client.

Definitions
connectTimeoutstring

Connection timeout

Time allowed to establish a server connection before failing.

defaultCharsetstring
DefaultUTF-8

Default charset

Charset used for requests when none is specified. Defaults to UTF-8.

headersobject

HTTP headers

HTTP headers to include in the request.

readIdleTimeoutstring
DefaultPT5M

Read idle timeout

How long a read connection may stay idle before closing. Defaults to 5 minutes.

Reference (ref) of the pluginDefaults to apply to this task.

DefaultLatest
Possible Values
LatestTop

Query type

Sort order. Latest returns chronological results, while Top returns engagement-ranked results.

Since time

ISO 8601 timestamp. Only returns tweets after this time.

Until time

ISO 8601 timestamp. Only returns tweets before this time.

Response body

Response payload. Available when fetchType is FETCH or FETCH_ONE.

Has next page

Whether Xquik reported another page when present.

Next cursor

Pagination cursor returned by Xquik when present.

Response item count

Best-effort count inferred from the first array in the response body.

Formaturi

Stored response URI

Kestra internal storage URI. Available when fetchType is STORE.