curl -G https://xquik.com/api/v1/x/tweets/search \
--data-urlencode "q=from:xquikcom giveaway" \
-H "x-api-key: xq_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2" | jq
Query parameters
Search query. Supports X search operators such as from:username, to:username, #hashtag, and boolean operators.
Your API key. Session cookie authentication is also supported.
Response
Array of matching tweets.
ISO 8601 creation timestamp. Omitted if unavailable.
Like count. Omitted if unavailable.
Retweet count. Omitted if unavailable.
Reply count. Omitted if unavailable.
Tweet author. Omitted if author data is unavailable.
Whether the author is verified. Omitted if unavailable.
Number of tweets returned in this response.
{
"tweets": [
{
"id": "1893456789012345678",
"text": "Tweet content here",
"createdAt": "2026-02-24T10:00:00.000Z",
"likeCount": 150,
"retweetCount": 42,
"replyCount": 10,
"author": {
"id": "987654321",
"username": "xquikcom",
"name": "Xquik",
"verified": true
}
}
],
"total": 1
}
{ "error": "missing_query" }
The q query parameter is empty or missing.{ "error": "unauthenticated" }
Missing or invalid API key. Check the x-api-key header value.{ "error": "no_subscription" }
No active subscription or usage cap reached. Possible error values: no_subscription, subscription_inactive, usage_limit_reached.{ "error": "x_api_unavailable" }
The upstream X API returned an error. Retry after a short delay.
Next steps: Get Tweet to fetch full details for a specific tweet, or Get User to look up an author profile.