Twitter mentions timeline API & profile alerts

# Username mentions timeline
curl "https://xquik.com/api/v1/x/users/username/mentions" \
  -H "x-api-key: xq_your_api_key_here" | jq

# Numeric user ID mentions timeline
curl "https://xquik.com/api/v1/x/users/44196397/mentions" \
  -H "x-api-key: xq_your_api_key_here" | jq

# Time-bounded mentions window
curl -G "https://xquik.com/api/v1/x/users/username/mentions" \
  --data-urlencode "sinceTime=1777392000" \
  --data-urlencode "untilTime=1777478400" \
  -H "x-api-key: xq_your_api_key_here" | jq

const userIdOrUsername = "username";
let pageCursor = "";

for (let pageIndex = 0; pageIndex < 3; pageIndex += 1) {
  const params =
    pageCursor === "" ? "" : `?${new URLSearchParams({ cursor: pageCursor })}`;
  const response = await fetch(
    `https://xquik.com/api/v1/x/users/${userIdOrUsername}/mentions${params}`,
    { headers: { "x-api-key": "xq_your_api_key_here" } },
  );
  const page = await response.json();
  if (!response.ok) throw new Error(JSON.stringify(page));

  const mentionRows = page.tweets.map((tweet) => ({
    mentioned_user_id_or_username: userIdOrUsername,
    tweet_id: tweet.id,
    text: tweet.text,
    tweet_url: tweet.url ?? null,
    author_id: tweet.author?.id ?? null,
    author_username: tweet.author?.username ?? null,
    author_name: tweet.author?.name ?? null,
    author_followers: tweet.author?.followers ?? null,
    author_verified: tweet.author?.verified ?? null,
    author_profile_picture: tweet.author?.profilePicture ?? null,
    created_at: tweet.createdAt ?? null,
    conversation_id: tweet.conversationId ?? null,
    is_reply: tweet.isReply ?? false,
    in_reply_to_id: tweet.inReplyToId ?? null,
    like_count: tweet.likeCount ?? null,
    reply_count: tweet.replyCount ?? null,
    retweet_count: tweet.retweetCount ?? null,
    quote_count: tweet.quoteCount ?? null,
    media_urls: (tweet.media ?? []).map((item) => item.mediaUrl).filter(Boolean),
    page_index: pageIndex,
    page_cursor: pageCursor,
    next_cursor: page.next_cursor,
    has_next_page: page.has_next_page,
  }));

  for (const row of mentionRows) process.stdout.write(`${JSON.stringify(row)}\n`);

  if (!page.has_next_page || page.next_cursor === "") break;
  pageCursor = page.next_cursor;
}

import json
import requests

user_id_or_username = "44196397"
page_cursor = ""

for page_index in range(3):
    params = {"cursor": page_cursor} if page_cursor else {}
    response = requests.get(
        f"https://xquik.com/api/v1/x/users/{user_id_or_username}/mentions",
        params=params,
        headers={"x-api-key": "xq_your_api_key_here"},
    )
    page = response.json()
    if not response.ok:
        raise RuntimeError(page)

    for tweet in page["tweets"]:
        mention_row = {
            "mentioned_user_id_or_username": user_id_or_username,
            "tweet_id": tweet["id"],
            "text": tweet["text"],
            "tweet_url": tweet.get("url"),
            "author_id": (tweet.get("author") or {}).get("id"),
            "author_username": (tweet.get("author") or {}).get("username"),
            "author_name": (tweet.get("author") or {}).get("name"),
            "author_followers": (tweet.get("author") or {}).get("followers"),
            "author_verified": (tweet.get("author") or {}).get("verified"),
            "author_profile_picture": (tweet.get("author") or {}).get("profilePicture"),
            "created_at": tweet.get("createdAt"),
            "conversation_id": tweet.get("conversationId"),
            "is_reply": tweet.get("isReply", False),
            "in_reply_to_id": tweet.get("inReplyToId"),
            "like_count": tweet.get("likeCount"),
            "reply_count": tweet.get("replyCount"),
            "retweet_count": tweet.get("retweetCount"),
            "quote_count": tweet.get("quoteCount"),
            "media_urls": [
                item["mediaUrl"]
                for item in tweet.get("media", [])
                if item.get("mediaUrl")
            ],
            "page_index": page_index,
            "page_cursor": page_cursor,
            "next_cursor": page["next_cursor"],
            "has_next_page": page["has_next_page"],
        }
        print(json.dumps(mention_row, separators=(",", ":")))

    if not page["has_next_page"] or not page["next_cursor"]:
        break
    page_cursor = page["next_cursor"]