Skip to main content

Median Views: XCROP API Documentation

Median Views

Eligibility gate against bot-like reach: takes the median views of an account's last 20, 40 or 60 posts of its own and compares it with a minimum you set. Replies, reposts, the pinned post and posts under 12 hours old are left out. A post with 0 views counts, a post with no view count is skipped. At least 5 usable posts are needed to qualify

GET/v2/users/:username/check-median-viewsCheck if the median views of an account's recent posts reach a minimum
ParameterTypeRequiredDefaultDescription
usernamestringrequired—Username, with or without @ (path parameter)
postsintegeroptional—How many recent posts to read: 20 (default), 40 or 60
max_medianintegeroptional—Median views must be above this value to qualify. Default 10, minimum 0
max_age_daysintegeroptional—Count only posts from the last N days (1 to 3650). Default: no limit, so an account that stopped posting is judged on its old posts
BASH
curl "https://xcrop.io/api/v2/users/elonmusk/check-median-views?posts=20&max_median=10&max_age_days=30" \
  -H "Authorization: Bearer $XCROP_API_KEY"
ResponseJSON
{
  "data": {
    "username": "elonmusk",
    "posts_requested": 20,
    "posts_used": 20,
    "median_views": 4122230.5,
    "max_median": 10,
    "max_age_days": 30,
    "min_posts": 5,
    "newest_post_at": "2026-11-10T10:34:24.000Z",
    "oldest_post_at": "2026-11-08T13:41:28.000Z",
    "qualified": true,
    "reason": null
  },
  "meta": { "latency_ms": 4200, "credits": 200 }
}

newest_post_at and oldest_post_at are the dates of the newest and oldest post counted, so you can see whether the median comes from recent or old posts. reason is null when qualified, low_median when the median is not above max_median, inactive when fewer than 5 posts fall inside max_age_days while older ones exist, and few_posts when the account has fewer than 5 usable posts at all

Price: 200 credits for 20 posts, 300 for 40, 400 for 60, charged once the posts were read, whatever the answer. An unknown, suspended or protected account returns 404 USER_NOT_FOUND and is free. If X returns no posts at all for the account, the answer is 422 POSTS_UNREADABLE, also free, and the same account answers that way for 5 minutes without a new read

‹ Qualified NameShadowban Check ›