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
| Input | What it is | Where to get it |
|---|---|---|
ofoptional | 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
|
limitoptional | 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. |
cursoroptional | 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. |
connectionIdoptional | 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:
| Method | POST |
| URL | https://api.heyreagent.com/v1/actions/list_followers |
| Send Headers | On. Name Authorization, Value Bearer YOUR_KEY |
| Send Body | On. 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:
returned | number |
nextCursor | A cursor. Other actions take it. |
followers[].id | A member id. Other actions take it. |
followers[].urn | string |
followers[].name | string |
followers[].headline | string |
followers[].profileUrl | A profile link. Other actions take it. |
followers[].profilePictureUrl | string or null |
followers[].profilePictureUrlLarge | string 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
- 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.
What its answer goes into
get_profileGet a profileget_profile_detailsGet a profile in depthendorse_skillEndorse a skillsend_invitationSend an invitationget_conversationGet a conversationsend_messageSend a messagesync_inboxRefresh the inboxstart_conversationStart a conversation (InMail, group, company)list_inmailList InMail conversationsget_recent_postsGet someone's recent postscreate_postPublish a postcomment_on_postComment on a postlist_posts_by_authorList a person's or company's postslist_comments_by_personList the comments a person wrotelist_reactions_by_personList what a person reacted to
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
list_connectionsList my connectionssend_invitationSend an invitationlist_sent_invitationsList sent invitationspreview_withdraw_invitationsPreview withdrawing invitationswithdraw_invitationsWithdraw sent invitationswithdraw_invitationWithdraw one sent invitation, nowlist_received_invitationsList received invitationsrespond_to_invitationAccept or decline an invitation