Docs / Network

list_followers

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

This action only reads. It changes nothing, so it is safe to try.

What you give it

InputWhat it isWhere to get it
of
optional
A member id or a company id. A member id or a company's numeric id. Omit for your own followers.Run get_profile_details and use providerId from its answer.
26 more places to get it
limit
optional
A number, 1 to 100. How many to return (1–100 for your own followers, 1–50 for someone else's; default 50).You write it.
cursor
optional
A cursor. nextCursor from the previous call, to get the next page. Keep the other arguments the same.The nextCursor from the last answer of list_followers.
connectionId
optional
A connection id. Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one.Run list_linkedin_accounts and use accounts[].id from its answer.
15 more places to get it

Call it

curl -X POST https://api.heyreagent.com/v1/actions/list_followers \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "content-type: application/json" \
  -d '{}'
The same call in JavaScript
const response = await fetch("https://api.heyreagent.com/v1/actions/list_followers", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_KEY",
    "content-type": "application/json",
  },
  body: JSON.stringify({}),
});
const answer = await response.json();
console.log(answer);
The same call in Python
import requests

response = requests.post(
    "https://api.heyreagent.com/v1/actions/list_followers",
    headers={"Authorization": "Bearer YOUR_KEY"},
    json={},
)
print(response.json())
The same call in n8n

Add an HTTP Request node and fill it in like this:

MethodPOST
URLhttps://api.heyreagent.com/v1/actions/list_followers
Send HeadersOn. Name Authorization, Value Bearer YOUR_KEY
Send BodyOn. Body Content Type JSON, Specify Body Using JSON, then paste the body below
{}

Put your own key where it says YOUR_KEY. New here? Start with your first call.

What you get back

When it worked, the answer is { "ok": true, "result": { … } }. Inside result:

returnednumber
nextCursorA cursor. Other actions take it.
followers[].idA member id. Other actions take it.
followers[].urnstring
followers[].namestring
followers[].headlinestring
followers[].profileUrlA profile link. Other actions take it.
followers[].profilePictureUrlstring or null
followers[].profilePictureUrlLargestring or null

A field that does not apply to an answer is left out, or is null.

When it did not work, the answer is { "ok": false, "error": "…", "message": "…" }. What each error means.

Good to know

What its answer goes into

Guides that use it

In Claude or ChatGPT

Once connected, ask in your own words. The assistant sees this action as a tool with the same name, list_followers, and the same inputs.

More in Network