Skip to main content
GET
/
x
/
tweets
/
search
Search tweets
curl --request GET \
  --url https://api.example.com/x/tweets/search \
  --header 'x-api-key: <x-api-key>'
1 credit per tweet returned · All plans from $0.00012/credit
curl -G https://xquik.com/api/v1/x/tweets/search \
  --data-urlencode "q=from:xquikcom giveaway" \
  --data-urlencode "queryType=Latest" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

# Page 2 — pass next_cursor from the previous response
curl -G https://xquik.com/api/v1/x/tweets/search \
  --data-urlencode "q=from:xquikcom giveaway" \
  --data-urlencode "cursor=abc123" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

​
Query parameters

​
q
string
required
Search query. Supports X search operators such as from:username, to:username, #hashtag, and boolean operators.
​
queryType
string
Sort order for search results. Top returns most relevant tweets, Latest returns most recent. Defaults to Latest.
​
cursor
string
Pagination cursor. Pass the next_cursor value from the previous response to fetch the next page.
​
sinceTime
string
Filter tweets published after this date. Uses X search since: operator format (e.g. 2026-03-01).
​
untilTime
string
Filter tweets published before this date. Uses X search until: operator format (e.g. 2026-03-27).
​
limit
integer
Maximum number of tweets to return per page (1-200, default 20). Use with cursor-based pagination to control page size.

​
Headers

​
x-api-key
string
required
Your API key. Session cookie authentication is also supported.

​
Response

​
tweets
object[]
Array of matching tweets.
​
has_next_page
boolean
Whether more results are available. Pass next_cursor to fetch the next page.
​
next_cursor
string
Opaque cursor for the next page. Empty string when no more results.
{
  "tweets": [
    {
      "id": "1893456789012345678",
      "text": "Tweet content here",
      "createdAt": "2026-02-24T10:00:00.000Z",
      "likeCount": 150,
      "retweetCount": 42,
      "replyCount": 10,
      "quoteCount": 5,
      "viewCount": 12400,
      "bookmarkCount": 8,
      "url": "https://x.com/xquikcom/status/1893456789012345678",
      "lang": "en",
      "author": {
        "id": "987654321",
        "username": "xquikcom",
        "name": "Xquik",
        "followers": 10000,
        "verified": true,
        "profilePicture": "https://pbs.twimg.com/profile_images/xquik/photo.jpg"
      },
      "media": [
        {
          "mediaUrl": "https://pbs.twimg.com/media/example.jpg",
          "type": "photo",
          "url": "https://t.co/abc123"
        }
      ]
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAADDAABCgABF..."
}
Next steps: Get Tweet to fetch full details for a specific tweet, or Get User to look up an author profile.