Users

Audit a user's newest followers

Changed on

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.

get/api/v1/x/users/{id}/follower-audit

Request

  • Base URL
    https://xquik.com
  • Auth
    • API key in header x-api-key
    • or HTTP bearer
    • or none

Path parameters

idstring required

User ID, username with or without @, or URL-encoded profile URL, such as x.com/nasa or x.com/i/user/11348282. A number is a user ID. Writes look up a username's ID before sending. Anything else gets 400 invalid_user_id.

Query parameters

limitinteger

Most followers to read, newest first. Left out, a read takes up to 200 and a low balance reads fewer. A very long read returns what it finished, & coverage shows how many. Its aliases are pageSize, count, max_results, maxItems, max_items & per_page.

fieldsstring
Example:id,text,author.username

Fields to keep in each row, comma-separated. Use dots for nested fields, such as author.username. A list keeps the field in each item. Case & underscores do not matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics always stay. An unknown name answers 400 unknown_field with the valid names, before any read. The price stays the same. SDK row types then hold only the named fields. A longer URL fails at the edge before Xquik reads it. Pick only the fields you need with fields & omit.

omitstring
Example:entities,media

Fields to drop from each row, comma-separated. It takes the same names as fields. With fields, it drops from the kept fields. A longer URL fails at the edge before Xquik reads it.

Response

Follower audit

Example response

{
  "audit": {
    "account": {
      "userId": "11348282",
      "userName": "NASA",
      "followers": 92376187,
      "following": 115,
      "posts": 74336,
      "accountAgeDays": 6858,
      "postsPrivate": false,
      "sample": {
        "posts": 10,
        "read": 19,
        "oldestAt": "2026-09-23T13:15:28.000Z",
        "newestAt": "2026-09-28T22:12:05.000Z"
      },
      "averages": {
        "likes": 3684.2,
        "replies": 142.7,
        "reposts": 459.8,
        "quotes": 45,
        "bookmarks": 209.7,
        "views": 785247.8,
        "engagements": 4331.7
      },
      "medianViews": 800791.5,
      "engagementRate": 0.0047,
      "engagementPerView": 0.5516,
      "postsPerDay": 1.6814,
      "topPostId": "2102761519985332442"
    }
  }
}

Changes