---
title: "List followers"
method: POST
path: "/v1/actions/list_followers"
tags: ["Network"]
---

# List followers

`POST /v1/actions/list_followers`

## Request

- Base URL: `https://api.heyreagent.com`
- URL: `https://api.heyreagent.com/v1/actions/list_followers`
- Auth: HTTP bearer

List who follows you, or who follows another person or a company page.

It works on LinkedIn: your own followers came back on a real account, each with a member id and a profile link. (The provider's feature summary lists followers under Instagram only; this operation's own definition, 100 a page for your own followers and 50 for someone else's, is the one that holds.)

of takes an id only, never a link.

Docs: https://heyreagent.com/docs/actions/list_followers

## Request body

- object
  - `of` string: A member id or a company's numeric id. Omit for your own followers.
  - `limit` number: How many to return (1–100 for your own followers, 1–50 for someone else's; default 50).
  - `cursor` string: nextCursor from the previous call, to get the next page. Keep the other arguments the same.
  - `connectionId` string: Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one.

## Response `200`

It worked. Inside result: returned, nextCursor, followers[].id, followers[].urn, followers[].name, followers[].headline, followers[].profileUrl, followers[].profilePictureUrl, followers[].profilePictureUrlLarge.

- Worked
  - `ok` true, required
  - `result` object, required: What was asked for. A field that does not apply is left out, or is null.

## Other responses

- `default`: It did not work. The message says why, in plain English.

---

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