Twitter follower checker API for X accounts

{
  "isFollowing": true,
  "isFollowedBy": false,
  "sourceUsername": "elonmusk",
  "targetUsername": "jack"
}

{
  "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."
}

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))

}

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

Use this Twitter follower checker API to verify one relationship in either direction. Supply 2 usernames 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 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 instead of printing the raw response page. Store the event with your campaign, entrant, or CRM row so reviewers can see the proof endpoint, the two 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, or supported profile URLs and needs 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 username, @username, or supported X or Twitter profile URL. Numeric user IDs are not accepted. Use Get user first when you only have a numeric ID.

Audit row

Persist 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

Treat 402 insufficient_credits as a stopped audit and resume after credits are available.

Query parameters

string

required

Source username, @username, or supported X or Twitter profile URL. Xquik resolves profile URLs and converts the username to lowercase. In campaign verification, this is usually the participant or entrant.

string

required

Target username, @username, or supported X or Twitter profile URL. 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

Canonical lowercase username resolved from source.

string

Canonical lowercase username resolved from target.

boolean

true if the source user follows the target user.

boolean

true if the target user follows the source user.

{
  "sourceUsername": "participant_handle",
  "targetUsername": "brand_handle",
  "isFollowing": true,
  "isFollowedBy": false
}

400 Invalid params

{
  "error": "missing_params",
  "message": "Both source and target usernames are required.",
  "required": ["source", "target"]
}

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

{
  "error": "invalid_username",
  "message": "Invalid source username. Use username, @username, or an X or Twitter profile URL.",
  "parameter": "source"
}

The named parameter is invalid. Use a username, @username, or supported X or Twitter profile URL. Numeric IDs, foreign hosts, profile status URLs, credentials, and custom ports are rejected.

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 }

Your tier rate limit was exceeded. 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": true,
  "isFollowedBy": false,
  "sourceUsername": "elonmusk",
  "targetUsername": "jack"
}

{
  "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."
}

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))

}

{
  "sourceUsername": "<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