List all followers

GEThttps://api.postpress.ai/v1/users/followers

Returns a paginated list of all followers of the current user. Implement carefully and respect provider limits and restrictions.

Authorization

X-API-KEYstringrequired

API key from your postpress dashboard. Sent as a request header.

Query parameters

user_idstringoptional

Instagram: user to get the followers from (`provider_id` or `username`). LinkedIn: user or company to get the followers from (`provider_id` only).

cursorstringoptional

Pagination cursor. Pass the `cursor` from the previous response to fetch the next page. Repeat until `cursor` is `null`. Minimum length 1.

limitintegeroptional

Maximum number of items to return. LinkedIn maximum 100, Instagram maximum 200. Defaults to 100.

account_idstringrequired

The linked account to get the followers from. Required when `user_id` is not provided.

Response 200 OK

Each item is one of the following variants, depending on the provider.

objectstringUserFollowersListrequired

itemsarray of objectsrequired

Followers in the current page.

items array

LinkedIn follower variantobject

LinkedIn follower variant object

objectstringUserFollowerrequired

idstringrequired

urnstringrequired

namestringrequired

headlinestringrequired

profile_urlstringrequired

profile_picture_urlstringrequired

profile_picture_url_largestringrequired

Instagram follower variantobject

Instagram follower variant object

objectstringUserFollowerrequired

idstringrequired

messaging_idstringrequired

usernamestringrequired

namestringrequired

profile_picture_urlstring

is_privatebooleanrequired

is_verifiedbooleanrequired

cursorstringrequired

Cursor for the next page, or `null` if this is the last page.

Example request

curl --request GET \
  --url 'https://api.postpress.ai/api/v1/users/followers?limit=100&account_id=acc_linkedin_01HXYZ4QK3WJ8FN3M6QH7TZ8GR' \
  --header 'X-API-KEY: pp_live_...' \
  --header 'accept: application/json'

Example response

{
  "object": "UserFollowersList",
  "items": [
    {
      "object": "UserFollower",
      "id": "ACoAACr-1eYBl...",
      "urn": "urn:li:fsd_profile:ACoAACr-1eYBl...",
      "name": "Jordan Walke",
      "headline": "Engineer at Acme",
      "profile_url": "https://www.linkedin.com/in/jordan-walke",
      "profile_picture_url": "https://media.licdn.com/.../profile.jpg",
      "profile_picture_url_large": "https://media.licdn.com/.../profile-large.jpg"
    }
  ],
  "cursor": "eyJvIjoxMDB9"
}

Errors

Every error response follows the same envelope:

titlestringrequired

Short error title.

detailstringoptional

Human-readable explanation.

instancestringoptional

Request identifier for support.

typestringrequired

Error type identifier.

statusnumberrequired

HTTP status code.

401 Unauthorized13 types

Credentials are missing, expired, or otherwise invalid.

errors/missing_credentials - Some credentials are necessary to perform the request.
errors/multiple_sessions - LinkedIn limits multiple sessions on certain Recruiter accounts. Use the cookie connection method.
errors/invalid_checkpoint_solution - The checkpoint resolution did not pass successfully. Retry.
errors/invalid_proxy_credentials - The provided proxy credentials are invalid.
errors/checkpoint_error - The checkpoint does not appear to be resolvable.
errors/invalid_credentials - The provided credentials are invalid.
errors/expired_credentials - Credentials have expired. Reconnect the account.
errors/insufficient_privileges - This resource is out of your API-key scopes.
errors/disconnected_account - The account is disconnected from the provider service.
errors/disconnected_feature - The service you're trying to reach is disconnected.
errors/invalid_credentials_but_valid_account_imap - IMAP/SMTP credentials are invalid but the account is otherwise valid.
errors/expired_link - This link has expired. Generate a new one.
errors/wrong_account - The provided credentials do not match the correct account.

403 Forbidden9 types

Authenticated but the account is restricted or the action is not allowed.

errors/account_restricted - The account has been restricted by the provider.
errors/account_mismatch - This action cannot be done with your account.
errors/insufficient_permissions - Valid authentication but insufficient permissions to perform the request.
errors/session_mismatch - Token user id does not match client session id.
errors/feature_not_subscribed - The requested feature has not been subscribed or authenticated properly.
errors/subscription_required - A subscription is required to use this feature.
errors/unknown_authentication_context - An additional step seems necessary to complete login.
errors/action_required - An additional step is required.
errors/resource_access_restricted - You don't have access to this resource.

404 Not Found2 types

The account or user could not be found.

errors/resource_not_found - The requested resource was not found.
errors/invalid_resource_identifier - The provided identifier is not valid.

500 Internal Server Error3 types

Something went wrong on our side or with the upstream provider.

errors/unexpected_error - Something went wrong.
errors/provider_error - The provider is experiencing operational problems. Retry later.
errors/authentication_intent_error - The current authentication intent was killed after failure.

501 Not Implemented1 types

The requested feature is planned but not yet available.

errors/feature_not_implemented - This feature has not been implemented yet.

503 Service Unavailable5 types

postpress is temporarily unable to handle the request.

errors/no_client_session - No client session is currently running.
errors/no_channel - No channel to client session.
errors/no_handler - Handler missing for that request.
errors/network_down - Network is down on the server side. Retry shortly.
errors/service_unavailable - Service temporarily unavailable. Retry later.

504 Gateway Timeout1 types

The upstream provider did not respond in time.

errors/request_timeout - Request timed out. Retry, and contact support if it persists.

Updated May 2026