API Reference/Users/List all comments

List all comments

GEThttps://api.postpress.ai/v1/users/{identifier}/comments

Returns a paginated list of comments written by a user.

Authorization

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

Path parameters

identifierstringrequired
The user's provider internal id.

Query parameters

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. Between 1 and 100. Defaults to 100.
account_idstringrequired
The linked account to perform the request from.

Response 200 OK

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

objectstringCommentListrequired
itemsarray of objectsrequired
Comments in the current page.
items array
LinkedIn comment variantobject
LinkedIn comment variant object
objectstringCommentrequired
idstringrequired
post_idstringrequired
post_urnstringrequired
thread_idstring
authorstringrequired
Author display name.
author_detailsobjectrequired
author_details object
idstringrequired
headlinestringrequired
profile_urlstringrequired
profile_picture_urlstringrequired
network_distancestringrequired
FIRST_DEGREESECOND_DEGREETHIRD_DEGREEOUT_OF_NETWORK
datestringrequired
textstringrequired
picture_urlstring
reaction_counternumberrequired
reply_counternumberrequired
impressions_counternumber
user_reactedstring
LIKEPRAISEAPPRECIATIONEMPATHYINTERESTENTERTAINMENT
Instagram comment variantobject
Instagram comment variant object
objectstringCommentrequired
provider_idstringrequired
authorobjectrequired
author object
provider_idstringrequired
messaging_idstringrequired
public_identifierstringrequired
pkstringrequired
profile_pic_urlstringrequired
is_verifiedbooleanrequired
textstringrequired
created_atnumberrequired
is_coveredbooleanrequired
child_comment_countnumberrequired
restricted_statusstringrequired
has_liked_commentbooleanrequired
giphy_media_infostringrequired
parent_comment_idstringrequired
comment_like_countnumberrequired
cursorstringrequired
Cursor for the next page, or `null` if this is the last page.
pagingobjectrequired
paging object
page_countnumberrequired

Example request

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

Example response

{
  "object": "CommentList",
  "items": [
    {
      "object": "Comment",
      "id": "7180000000000000000",
      "post_id": "7180000000000000001",
      "post_urn": "urn:li:activity:7180000000000000001",
      "thread_id": "urn:li:comment:(activity:7180000000000000001,7180000000000000000)",
      "author": "Jordan Walke",
      "author_details": {
        "id": "ACoAACr-1eYBl...",
        "headline": "Engineer at Acme",
        "profile_url": "https://www.linkedin.com/in/jordan-walke",
        "profile_picture_url": "https://media.licdn.com/.../profile.jpg",
        "network_distance": "SECOND_DEGREE"
      },
      "date": "2 days ago",
      "text": "Great write-up - thanks for sharing.",
      "reaction_counter": 12,
      "reply_counter": 2,
      "impressions_counter": 540,
      "user_reacted": "LIKE"
    }
  ],
  "cursor": "eyJvIjoxMDB9",
  "paging": { "page_count": 1 }
}

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.
422 Unprocessable Entity6 types

The request is well-formed but cannot be fulfilled as-is.

  • errors/invalid_account - The provided account is not designed for this feature.
  • errors/invalid_recipient - The target user is not valid.
  • errors/user_unreachable - The target user cannot be reached on the provider.
  • errors/unprocessable_entity - The request cannot be processed in its current form.
  • errors/account_configuration_error - The account configuration prevents this request.
  • errors/provider_unreachable - The provider is currently unreachable.
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.
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