Twitter follower checker API for X accounts

{
  "isFollowing": false,
  "isFollowedBy": true,
  "sourceId": "11348282",
  "sourceUsername": "nasa",
  "targetId": "34743251",
  "targetUsername": "spacex"
}

{
  "error": "missing_params"
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

GET

followers

check

Twitter follower checker API for X accounts

curl --request GET \
  --url https://xquik.com/api/v1/x/followers/check

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/followers/check"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "sourceId": "<string>",
  "sourceUsername": "<string>",
  "targetId": "<string>",
  "targetUsername": "<string>",
  "isFollowing": true,
  "isFollowedBy": true
}

This route checks one follow relationship in both directions. Supply 2 accounts, each by user ID or username, and store both boolean results.

5 credits per call · All plans from $0.00012/credit · Direct MPP: USD 0.00075 per call

Check follower verifies one known relationship without exporting a follower list. Pass the participant as source and the required brand, creator, or partner account as target. Each input accepts a user ID, a username, @username, or supported X or Twitter profile URL. Xquik resolves profile URLs and converts both usernames to lowercase before lookup. The response returns both directions: isFollowing for source-to-target proof and isFollowedBy for target-to-source context.

curl -G https://xquik.com/api/v1/x/followers/check \
  --data-urlencode "source=participant_handle" \
  --data-urlencode "target=brand_handle" \
  -H "x-api-key: xq_your_api_key_here" | jq

async function buildFollowCheckAudit() {
  const campaignId = "spring-launch-2026";
  const participantHandle = "participant_handle";
  const requiredFollowHandle = "brand_handle";
  const params = new URLSearchParams({
    source: participantHandle,
    target: requiredFollowHandle,
  });

  const response = await fetch(`https://xquik.com/api/v1/x/followers/check?${params}`, {
    headers: { "x-api-key": "xq_your_api_key_here" },
  });

  if (!response.ok) {
    throw new Error(`Follow check failed with status ${response.status}`);
  }

  const data = await response.json();
  return {
    campaign_id: campaignId,
    participant_handle: data.sourceUsername,
    required_follow_handle: data.targetUsername,
    proof_endpoint: "GET /api/v1/x/followers/check",
    participant_follows_required_account: data.isFollowing,
    required_account_follows_participant: data.isFollowedBy,
    verification_state: data.isFollowing ? "matched" : "not_matched",
  };
}

const auditEvent = await buildFollowCheckAudit();
// Replace this with your DB, queue, or warehouse write.
await saveAuditEvent(auditEvent);

import requests

def build_follow_check_audit():
    campaign_id = "spring-launch-2026"
    participant_handle = "participant_handle"
    required_follow_handle = "brand_handle"
    response = requests.get(
        "https://xquik.com/api/v1/x/followers/check",
        params={
            "source": participant_handle,
            "target": required_follow_handle,
        },
        headers={"x-api-key": "xq_your_api_key_here"},
    )
    response.raise_for_status()
    data = response.json()
    return {
        "campaign_id": campaign_id,
        "participant_handle": data["sourceUsername"],
        "required_follow_handle": data["targetUsername"],
        "proof_endpoint": "GET /api/v1/x/followers/check",
        "participant_follows_required_account": data["isFollowing"],
        "required_account_follows_participant": data["isFollowedBy"],
        "verification_state": "matched" if data["isFollowing"] else "not_matched",
    }

audit_event = build_follow_check_audit()
# Replace this with your DB, queue, or warehouse write.
save_audit_event(audit_event)

The Node.js and Python snippets build a campaign audit event. They do not print the raw response page. Store the event with your campaign, entrant, or CRM row. Reviewers can then see the proof endpoint, the 2 handles checked, and the matched or not-matched state.

Campaign follow-check handoff

Use GET /api/v1/x/followers/check when a workflow already has both usernames, @usernames, user IDs, or supported profile URLs. It returns one proof for a follow task. Use it for campaign entry validation, giveaway eligibility, creator partnerships, CRM qualification, and agent review queues.

Single proof

Store one audit event per participant and required account pair.

Both directions

Store isFollowing as the required proof and isFollowedBy as reciprocal context.

Accepted inputs

Pass a user ID, a username, @username, or supported X or Twitter profile URL. A number is a user ID. An x.com/i/user/<id> link names an account by ID too.

Audit row

Store the campaign ID, participant handle, required follow handle, endpoint, result booleans, and verification state.

Draw handoff

Use Create draw when winner selection also needs reply, repost, keyword, or unique-author filters.

Stopped audit

After 402 insufficient_credits, stop the audit. Resume after you add credits.

Query parameters

string

required

Source user ID, username, @username, or supported X or Twitter profile URL, such as x.com/i/user/11348282. A number is a user ID. Xquik resolves profile URLs and converts the username to lowercase. In campaign verification, this is usually the participant or entrant.

string

required

Target user ID, username, @username, or supported X or Twitter profile URL, such as x.com/i/user/11348282. A number is a user ID. Xquik resolves profile URLs and converts the username to lowercase. In campaign verification, this is usually the required brand, creator, or partner account.

Which verification endpoint?

Follow task

Use GET /x/followers/check for one participant-account follow proof.

Retweet task

Use GET /x/tweets/{id}/retweeters to page accounts that reposted one source tweet.

Reply task

Use GET /x/tweets/{id}/replies to check public replies under the source tweet.

Quote task

Use GET /x/tweets/{id}/quotes to inspect quote-tweet entries.

Follower export

Use GET /x/users/{id}/followers or a saved follower export when you need many followers for one profile.

Giveaway draw

Use POST /draws when Xquik should apply follow, repost, reply, keyword, and winner rules together.

Headers

string

Full account key. Sessions and OAuth also work.

string

Bearer xq_your_guest_key_here authenticates paid_reads guest keys. Direct MPP uses the Payment ... credential. Get it from the WWW-Authenticate: Payment challenge.

Response

200 OK

string

The source account’s user ID, as X gives it. Omitted when X names no account.

string

The source account’s username, in lowercase.

string

The target account’s user ID, as X gives it. Omitted when X names no account.

string

The target account’s username, in lowercase.

boolean

true if the source user follows the target user.

boolean

true if the target user follows the source user.

{
  "sourceId": "11348282",
  "sourceUsername": "nasa",
  "targetId": "34743251",
  "targetUsername": "spacex",
  "isFollowing": false,
  "isFollowedBy": true
}

400 Invalid params

{
  "error": "missing_params",
  "message": "Send both source and target, each a user ID or username.",
  "required": ["source", "target"]
}

One or both query parameters are missing. Provide both source and target.

{
  "error": "invalid_username",
  "message": "Invalid source. Use a user ID, username, @username or X profile URL.",
  "parameter": "source"
}

The named parameter is invalid. Use a user ID, a username, @username, or supported X or Twitter profile URL. The API rejects foreign hosts, profile status URLs, credentials, and custom ports.

401 Unauthenticated

{ "error": "unauthenticated" }

Missing or invalid API key. Check the x-api-key header value.

402 Payment required

Account keys get account options. Guest keys get guest top-up only. Anonymous calls receive a direct MPP WWW-Authenticate: Payment challenge plus a guest wallet creation action. No checkout starts automatically. Confirm any payment action.

502 X API unavailable

{ "error": "x_api_unavailable" }

The read service returned an error. Retry after a short delay.

429 Rate limit exceeded

{ "error": "rate_limit_exceeded", "retryAfter": 60 }

You exceeded your tier rate limit. Wait for the Retry-After header before retrying.

424 Dependency failed

{ "error": "x_api_unavailable" }

The normalized v1 response contract can return 424 when the read service is unavailable.

Next steps. Campaign verification workflow for audit rows and draw handoffs, Get User to resolve profile details before checking, or Get Account to check remaining credits.

{
  "isFollowing": false,
  "isFollowedBy": true,
  "sourceId": "11348282",
  "sourceUsername": "nasa",
  "targetId": "34743251",
  "targetUsername": "spacex"
}

{
  "error": "missing_params"
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

Twitter follower checker API for X accounts

curl --request GET \
  --url https://xquik.com/api/v1/x/followers/check

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/followers/check"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "sourceId": "<string>",
  "sourceUsername": "<string>",
  "targetId": "<string>",
  "targetUsername": "<string>",
  "isFollowing": true,
  "isFollowedBy": true
}

​Campaign follow-check handoff

Single proof

Both directions

Accepted inputs

Audit row

Draw handoff

Stopped audit

​Query parameters

​Which verification endpoint?

Follow task

Retweet task

Reply task

Quote task

Follower export

Giveaway draw

​Headers

​Response

​200 OK

​400 Invalid params

​401 Unauthenticated

​402 Payment required

​502 X API unavailable

​429 Rate limit exceeded

​424 Dependency failed

Campaign follow-check handoff

Query parameters

Which verification endpoint?

Headers

Response

200 OK

400 Invalid params

401 Unauthenticated

402 Payment required

502 X API unavailable

429 Rate limit exceeded

424 Dependency failed