Skip to content
Docs

List a post's comments

GETdirect.lempile.com/api/v1/posts/{post_id}/comments

A post's comments, or with comment_id that comment's replies: newest first by default (MOST_RECENT, as Unipile), or in LinkedIn's relevance order (MOST_RELEVANT; replies oldest first, as LinkedIn's apps read them).

Authentication

X-API-KEY header·A Lempile Direct key, one per workspace, made in Lempile's dashboard.

Path parameters

  • post_idstringrequired

    The post: its id (digits), urn:li:activity:… (or a ugcPost/share urn) or its URL.

Query parameters

  • account_idstringrequired

    The account that reads: a Lempile LinkedIn account id (GET /accounts lists them).

  • limitinteger

    Items per page: 1 to 100 (default 10).

    Default10≥ 1 · ≤ 100
  • cursorstring

    A cursor a previous page gave.

  • sort_bystring

    MOST_RECENT (the default, as Unipile's): newest first, page after page. MOST_RELEVANT: LinkedIn's relevance order (a comment's replies oldest first).

    One ofMOST_RELEVANTMOST_RECENTDefaultMOST_RECENT
  • comment_idstring

    List this comment's replies instead (its id, digits).

Responses

200

OK

›

application/json

  • objectstringrequired
    AlwaysCommentList
  • itemsarray of Commentrequired
    ›Show fields
    • objectstringrequired
      AlwaysComment
    • idstringrequired

      The comment's id (digits): what comment_id takes.

    • post_idstringrequired
    • post_urnstringrequired
    • authorstring | nullrequired
    • author_detailsCommentAuthorrequired

      Unipile's comment author: the name is the comment's author; no public identifier.

      ›Show fields
      • idstring | nullrequired
      • headlinestring | nullrequired
      • profile_urlstring | nullrequired
      • profile_picture_urlstring | nullrequired
      • network_distancestringrequired

        The author's degree as Unipile answers it on comments: LinkedIn's own word for the account itself and its 1st and 2nd degree (DISTANCE_2, not SECOND_DEGREE), DISTANCE_3 for anyone further, out of network, or a page.

        One ofSELFDISTANCE_1DISTANCE_2DISTANCE_3
      • is_companybooleanrequired
    • datestringrequired
    • textstringrequired
    • reaction_counterintegerrequired
    • reply_counterintegerrequired
    • thread_idstring

      A reply's parent comment id (in a comment_id list); absent on a post's own comments, as Unipile.

    • user_reactedstring
  • cursorstring | nullrequired

    The next page's cursor, or null on the last page. Opaque: send it back as cursor.

  • total_itemsinteger | nullrequired

    LinkedIn's total of a post's comments; null for a comment's replies, as Unipile.

  • pagingobjectrequired
    ›Show fields
    • startintegerrequired
    • page_countintegerrequired
    • total_countinteger | nullrequired
400

A required parameter missing (errors/missing_parameters), or one that isn't valid (errors/invalid_parameters, errors/invalid_url, errors/content_too_large).

›

application/json

  • titlestringrequired

    A short title, e.g. Too many requests.

  • detailstringrequired

    What happened, in plain words. Never an account's data.

  • typestringrequired

    Unipile's error type: errors/<kind>. Branch on this, not on detail.

  • statusintegerrequired

    The HTTP status again.

  • retry_afterinteger

    Seconds to wait before trying this account again. Only on 429; the Retry-After header carries the same value.

401

errors/missing_credentials: the X-API-KEY header is missing, wrong or revoked. errors/disconnected_account: LinkedIn signed the account out (or asks it for a security check); reconnect it.

›

application/json

  • titlestringrequired

    A short title, e.g. Too many requests.

  • detailstringrequired

    What happened, in plain words. Never an account's data.

  • typestringrequired

    Unipile's error type: errors/<kind>. Branch on this, not on detail.

  • statusintegerrequired

    The HTTP status again.

  • retry_afterinteger

    Seconds to wait before trying this account again. Only on 429; the Retry-After header carries the same value.

404

errors/resource_not_found: an unknown or removed account, an account of another workspace (answered exactly the same), or nothing on LinkedIn with this id.

›

application/json

  • titlestringrequired

    A short title, e.g. Too many requests.

  • detailstringrequired

    What happened, in plain words. Never an account's data.

  • typestringrequired

    Unipile's error type: errors/<kind>. Branch on this, not on detail.

  • statusintegerrequired

    The HTTP status again.

  • retry_afterinteger

    Seconds to wait before trying this account again. Only on 429; the Retry-After header carries the same value.

429

errors/too_many_requests: LinkedIn asked the account to slow down (it rests 15 minutes), its daily calls or writes are used up, or it's busy with other calls. Wait retry_after seconds.

›

application/json

  • titlestringrequired

    A short title, e.g. Too many requests.

  • detailstringrequired

    What happened, in plain words. Never an account's data.

  • typestringrequired

    Unipile's error type: errors/<kind>. Branch on this, not on detail.

  • statusintegerrequired

    The HTTP status again.

  • retry_afterinteger

    Seconds to wait before trying this account again. Only on 429; the Retry-After header carries the same value.

500

errors/provider_error: LinkedIn answered something Direct couldn't read (nothing was written). errors/unexpected_error: Direct failed.

›

application/json

  • titlestringrequired

    A short title, e.g. Too many requests.

  • detailstringrequired

    What happened, in plain words. Never an account's data.

  • typestringrequired

    Unipile's error type: errors/<kind>. Branch on this, not on detail.

  • statusintegerrequired

    The HTTP status again.

  • retry_afterinteger

    Seconds to wait before trying this account again. Only on 429; the Retry-After header carries the same value.

503

errors/network_down: the account's proxy or browser server didn't answer. Nothing was sent.

›

application/json

  • titlestringrequired

    A short title, e.g. Too many requests.

  • detailstringrequired

    What happened, in plain words. Never an account's data.

  • typestringrequired

    Unipile's error type: errors/<kind>. Branch on this, not on detail.

  • statusintegerrequired

    The HTTP status again.

  • retry_afterinteger

    Seconds to wait before trying this account again. Only on 429; the Retry-After header carries the same value.

504

errors/request_timeout: LinkedIn didn't answer in time. On a write: an unknown outcome (it may have been sent); it's never retried and its Idempotency-Key never writes again.

›

application/json

  • titlestringrequired

    A short title, e.g. Too many requests.

  • detailstringrequired

    What happened, in plain words. Never an account's data.

  • typestringrequired

    Unipile's error type: errors/<kind>. Branch on this, not on detail.

  • statusintegerrequired

    The HTTP status again.

  • retry_afterinteger

    Seconds to wait before trying this account again. Only on 429; the Retry-After header carries the same value.

Was this page helpful?