---
title: "Export the followers or following of an X account, cursor-paginated and metered per page."
method: POST
path: "/v1/x/audience"
---

# Export the followers or following of an X account, cursor-paginated and metered per page.

`POST /v1/x/audience`

## Request body

- object
  - `handle` string
  - `user_id` string
  - `direction` 'followers' | 'following'
  - `cursor` string
  - `max_pages` integer

## Response `200`

Successful response

- object
  - `user_id` string
  - `direction` string
  - `count` integer
  - `users` object[]
  - `next_cursor` string, nullable
  - `pages_fetched` integer
  - `credits_charged` integer

## Other responses

- `400` — Invalid request
- `401` — Invalid or missing API key
- `402` — Payment required or insufficient credits
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/webclaw/apis/webclaw-api.md) · [All operations](https://skmtc.dev/webclaw/apis/webclaw-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/webclaw/webclaw-api/revisions/bd14a9c72a3b/schema)