---
title: "Audit a user's newest followers"
method: GET
path: "/api/v1/x/users/{id}/follower-audit"
tags: ["Users"]
---

# Audit a user's newest followers

`GET /api/v1/x/users/{id}/follower-audit`

## Request

- Base URL: `https://xquik.com`
- URL: `https://xquik.com/api/v1/x/users/{id}/follower-audit`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
  - none

Reads the newest followers of a public account & returns a follower audit. It gives each follower 1 class with its score & signals, then adds coverage, a quality score, signal counts, arrival bands, join cohorts, countries, top followers & the account's engagement. Each follower read costs 1 credit, and the engagement adds 1 credit. Signals come from public profiles, so a real person can match. Older followers may differ from the newest ones.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer
- `fields` string
- `omit` string

## Response `200`

Follower audit

- object
  - `audit` FollowerAudit, required: Report on the followers read. Classes rest on public profile signals, so they say what a profile looks like, never who runs it.
    - `account` UserInsights, required: Engagement insights of 1 profile. Engagements are likes, replies, reposts and quotes. A rate is null when nothing divides it, such as a profile without posts of its own.
      - `userId` string, required: ID of the profile the insights describe.
      - `userName` string, required: Username of that profile.
      - `followers` number, required: Followers.
      - `following` number, required: Accounts the user follows.
      - `posts` number, required: Posts the user has made.
      - `accountAgeDays` number, nullable, required: Whole days since the account joined X.
      - `postsPrivate` boolean, required: True when only the account's followers see its posts. The report then has its counts only.
      - `sample` object, required: The recent posts the read covered.
        - `posts` number, required: Posts the averages used. Reposts and the pinned post stay out, so this can be lower than `read`.
        - `read` number, required: Posts read, reposts and the pinned post included.
        - `oldestAt` string, date-time, nullable, required: When the oldest post the averages used went up.
        - `newestAt` string, date-time, nullable, required: When the newest post the averages used went up.
      - `averages` object, nullable, required: The public counts of 1 tweet.
        - `likes` number, required: Likes.
        - `replies` number, required: Replies.
        - `reposts` number, required: Reposts.
        - `quotes` number, required: Quotes.
        - `bookmarks` number, required: Bookmarks.
        - `views` number, required: Views.
        - `engagements` number, required: Likes, replies, reposts and quotes per post.
      - `medianViews` number, nullable, required: Middle view count of the sample, so 1 viral post moves it less than the average. Null without posts.
      - `engagementRate` number, nullable, required: Average engagements per post, as a percent of followers.
      - `engagementPerView` number, nullable, required: Engagements as a percent of views across the sample.
      - `postsPerDay` number, nullable, required: Sampled posts per day, from the oldest one until now.
      - `topPostId` string, nullable, required: The sampled post with the most engagements.
    - `coverage` object, required
      - `percent` number, required
      - `read` integer, required
      - `total` integer, required
    - `quality` object, required
      - `grade` 'A' | 'B' | 'C' | 'D' | 'F', required
      - `score` integer, required
    - `classes` object[], required
      - `class` 'automated' | 'inactive' | 'likelyFake' | 'likelyReal' | 'tooNew', required: What 1 follower looks like from its public profile.
      - `count` integer, required
      - `percent` number, required
    - `signals` object[], required
      - `count` integer, required
      - `id` string, required
      - `percent` number, required
      - `points` integer, required
    - `arrivalBands` object[], required: Likely fake share by position in the newest-first list.
      - `count` integer, required
      - `from` integer, required
      - `percent` number, required
      - `read` integer, required
      - `to` integer, required
    - `cohorts` object[], required: Followers who joined X in the same UTC week.
      - `count` integer, required
      - `likelyFake` integer, required
      - `percent` number, required
      - `weekStartMs` integer, required
    - `languages` FollowerValueCount[], required
      - `count` integer, required
      - `percent` number, required
      - `value` string, required
    - `places` FollowerValueCount[], required
      - `count` integer, required
      - `percent` number, required
      - `value` string, required
    - `verified` object, required
      - `count` integer, required
      - `percent` number, required
    - `followers` AuditedFollower[], required
      - `class` 'automated' | 'inactive' | 'likelyFake' | 'likelyReal' | 'tooNew', required: What 1 follower looks like from its public profile.
      - `followers` integer, required
      - `following` integer, required
      - `id` string, required
      - `joinedAtMs` integer
      - `likes` integer, required
      - `name` string, required
      - `owner` string: Account that runs an automated follower, when X names it.
      - `pictureUrl` string
      - `position` integer, required
      - `posts` integer, required
      - `score` integer, required
      - `signals` string[], required
      - `userName` string, required
    - `topFollowers` AuditedFollower[], required
      - `class` 'automated' | 'inactive' | 'likelyFake' | 'likelyReal' | 'tooNew', required: What 1 follower looks like from its public profile.
      - `followers` integer, required
      - `following` integer, required
      - `id` string, required
      - `joinedAtMs` integer
      - `likes` integer, required
      - `name` string, required
      - `owner` string: Account that runs an automated follower, when X names it.
      - `pictureUrl` string
      - `position` integer, required
      - `posts` integer, required
      - `score` integer, required
      - `signals` string[], required
      - `userName` string, required

## Other responses

- `400`: Invalid input. A value past its maxLength gets this answer, & the message names the field & its limit. Bad input costs nothing, since it's refused before any read.
- `401`: Non-MPP paid reads require Bearer authentication. Without credentials, the answer offers a guest checkout but does not create it. Invalid credentials return a plain error. Confirm before using any offered action.
- `402`: Payment required. MPP reads include `WWW-Authenticate`. Authenticated reads include balances, plus checkout when the key can open it. A key that reads only gets the account page instead. A failed request never creates checkout. A caller on a plan gets top-up only, plus `credits_renew_at` when the plan renews. Guest keys offer top-up.
- `403`: X keeps a protected account's follower list private. Xquik charges nothing. A paused API key gets `api_key_paused`, so resume it on the dashboard.
- `404`: X shows no profile for the account. `reason` says why. It is `not_found` for a handle or ID no account holds, which X answers for a deactivated account too. It is `suspended` when X suspended the account, with the message "X suspended this account. Choose another account."
- `424`: Dependency unavailable, unauthorized, or limited. Default v1 uses 502. Best-practice responses use 424 for transparent dependency failures. Search answers 424 `search_unavailable` when X fails the query itself, or when a filtered search goes far back without a match. The message says how far back the search looked. "X can't run this search" appears only when it's true. Searches X can't run fail at once, with the fix. When X fails a read, Xquik answers 502 `x_api_unavailable` with `X-Xquik-Cause` & `Retry-After`. Retry after that many seconds.
- `429`: Too many requests right now. Each user gets 500 reads a second, 6,000 changes to Xquik resources a minute & 120 X actions a minute. X actions post, like, follow, message or edit through a connected X account. `x_api_rate_limited` means X limits this read for now. Neither answer costs anything. Wait for the seconds in `Retry-After`, then retry.
- `500`: Unexpected error.
- `502`: Dependency unavailable, unauthorized, or limited. Default v1 uses 502. Best-practice responses use 424 for transparent dependency failures. Search answers 424 `search_unavailable` when X fails the query itself, or when a filtered search goes far back without a match. The message says how far back the search looked. "X can't run this search" appears only when it's true. Searches X can't run fail at once, with the fix. When X fails a read, Xquik answers 502 `x_api_unavailable` with `X-Xquik-Cause` & `Retry-After`. Retry after that many seconds.
- `503`: Retry x_api_unavailable after Retry-After. With X-Xquik-Busy, retry until your deadline. Overload is announced with 503, `Retry-After` & a reason.
- `default`: Unexpected error.

## Changes

- **2026-11-18** `fe9dc4f8a127`: 1 info
  - endpoint added
- **2026-11-18** `2284c0998114`: 1 breaking
  - api path removed without deprecation
- **2026-11-18** `a291f0b82030`: 1 info
  - endpoint added
- **2026-11-17** `e1e106c83615`: 1 breaking
  - api path removed without deprecation
- **2026-11-17** `d40150ef20b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/xquik-dev/apis/xquik-api/changes/api/v1/x/users/:id/follower-audit/get.md)

---

[API](https://skmtc.dev/xquik-dev/apis/xquik-api.md) - [All operations](https://skmtc.dev/xquik-dev/apis/xquik-api/llms.txt) - [OpenAPI document](https://skmtc.dev/xquik-dev/apis/xquik-api/revisions/fe9dc4f8a127?raw)
