API Reference/Posts/List all comments from a post

List all comments from a post

GEThttps://api.postpress.ai/v1/posts/{post_id}/comments

Returns a list of either comments on a given post or replies on a given comment.

Authorization

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

Path parameters

post_idstringrequired
The id of the post. LinkedIn: use the `social_id` from the post object (the id visible in the post URL won't work in every case). Instagram: use the `provider_id`; the shortcode from `www.instagram.com/p/SHORTCODE` is not accepted here.

Query parameters

account_idstringrequired
The linked account to perform the request from.
cursorstringoptional
Pagination cursor returned by a previous response. Repeat until all entries are retrieved.
limitintegeroptional
Number of items returned. Range 1-100.
sort_bystringoptional
Sort method. Defaults to `MOST_RECENT`. Allowed: `MOST_RECENT`, `MOST_RELEVANT`.
comment_idstringoptional
When set, returns replies to this comment instead of top-level comments. LinkedIn: use the comment `id` returned by the comments list.

Response 200 OK

Each item in items is either a LinkedIn comment or an Instagram comment, depending on the linked account.

objectstringCommentListrequired
itemsarray of objectsrequired
items array
LinkedIn commentobject
LinkedIn comment object
objectstringCommentrequired
idstringrequired
Unique identifier for the comment.
post_idstringrequired
post_urnstringrequired
thread_idstring
authorstringrequired
The author's provider id.
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 commentobject
Instagram comment 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; null when there are no more pages.
total_itemsnumberrequired
pagingobjectrequired
paging object
startnumberrequired
page_countnumberrequired
total_countnumberrequired

Example request

curl --request GET \
  --url 'https://api.postpress.ai/api/v1/posts/urn:li:activity:7332661864792854528/comments?account_id=acc_linkedin_01HXYZ4QK3WJ8FN3M6QH7TZ8GR&limit=100&sort_by=MOST_RECENT' \
  --header 'X-API-KEY: pp_live_...' \
  --header 'accept: application/json'

Example response

{
  "object": "CommentList",
  "items": [
    {
      "object": "Comment",
      "id": "7332661864792854528_7332661900000000000",
      "post_id": "7332661864792854528",
      "post_urn": "urn:li:activity:7332661864792854528",
      "thread_id": "7332661864792854528_7332661900000000000",
      "author": "ACoAACr-1eYBl...",
      "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": "1 day ago",
      "text": "Love this, congrats to the whole team!",
      "reaction_counter": 14,
      "reply_counter": 2,
      "impressions_counter": 420,
      "user_reacted": "LIKE"
    }
  ],
  "cursor": "eyJwYWdlIjoyfQ==",
  "total_items": 31,
  "paging": { "start": 0, "page_count": 10, "total_count": 31 }
}

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/wrong_account - The provided credentials do not match the correct account.
  • errors/invalid_credentials - The provided credentials are invalid.
  • errors/invalid_proxy_credentials - The provided proxy credentials are invalid.
  • errors/invalid_checkpoint_solution - The checkpoint resolution did not pass successfully. Retry.
  • errors/checkpoint_error - The checkpoint does not appear to be resolvable.
  • errors/expired_credentials - Credentials have expired. Reconnect the account.
  • errors/expired_link - This link has expired. Generate a new one.
  • 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.
403 Forbidden9 types

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

  • errors/insufficient_permissions - Valid authentication but insufficient permissions to perform the request.
  • errors/account_restricted - The account has been restricted by the provider.
  • errors/account_mismatch - This action cannot be done with your account.
  • errors/unknown_authentication_context - An additional step seems necessary to complete login.
  • 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/resource_access_restricted - You don't have access to this resource.
  • errors/action_required - An additional step is required.
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