Skip to main content

Qualified Account

Qualified Account

Eligibility gate for giveaways/airdrops: check whether an account meets a minimum follower count and a minimum account age (in days). Reads the public profile; no connected X account needed.

GET/v2/users/:username/check-qualified-accountCheck if an account meets min followers + min account age.
ParameterTypeRequiredDefaultDescription
usernamestringrequired—Username, with or without @ (path parameter)
min_followersnumberoptional—Minimum followers required (default 0)
min_age_daysnumberoptional—Minimum account age in days (default 0)
BASH
curl "https://xcrop.io/api/v2/users/elonmusk/check-qualified-account?min_followers=100&min_age_days=30" \
  -H "Authorization: Bearer $XCROP_API_KEY"
ResponseJSON
{
  "data": {
    "username": "elonmusk",
    "qualified": true,
    "followers": 240674901,
    "accountAgeDays": 6240,
    "minFollowers": 100,
    "minAgeDays": 30,
    "createdAt": "Tue Jun 02 20:12:29 +0000 2009"
  },
  "meta": { "latency_ms": 210 }
}

More in Interaction Check

Full documentation with search: xcrop.io/docs