---
title: "Follower ids of a user"
method: GET
path: "/v1/users/{user}/followers/ids"
tags: ["users"]
---

# Follower ids of a user

`GET /v1/users/{user}/followers/ids`

## Request

- Base URL: `https://api.xdataapi.io`
- URL: `https://api.xdataapi.io/v1/users/{user}/followers/ids`
- Auth: one of:
  - API key in header `x-api-key`
  - OAuth 2 (authorization code, authorization URL `https://xdataapi.io/oauth/authorize`, token URL `https://xdataapi.io/api/oauth/token`, scopes: `read`)

Numeric user ids only, no profiles. 0.02 credit per id. Up to 200 per page.
It is the same page `/followers` reads, so a page fetched through either endpoint is a cache
hit for the other, at half price. Same availability note as followers.

## Path parameters

- `user` string, required

## Query parameters

- `count` integer
- `cursor` string
- `fresh` boolean

## Response `200`

OK

- IdPage
  - `items` integer, required: Objects returned.
  - `credits_charged` number, required
  - `balance_remaining` number, required
  - `cache` 'miss' | 'hit' | 'bypass', required
  - `request_id` string, uuid, required
  - `next_cursor` string
  - `data` string[]: Numeric user ids as strings.

## Other responses

- `401`: Missing or invalid key. Free.
- `402`: Balance is zero. Buy a pack. Free.
- `403`: X denied this read to the current session (error 37). Free.
- `404`: No such object, or it is private. Free.
- `429`: Per-account rate limit. Free. Retry after `Retry-After` seconds.
- `500`: A fault on our side. Free. Quote `request_id` if it persists.
- `503`: Upstream failure. Free. Retry after `Retry-After` seconds.

---

[API](https://skmtc.dev/xdataapi/apis/xdataapi-io-api.md) · [All operations](https://skmtc.dev/xdataapi/apis/xdataapi-io-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xdataapi/apis/xdataapi-io-api/revisions/90cd2c0db55a?raw)