add comment interaction API

LordOfTheVillage · LordOfTheVillage · commit b9dbe503814f · 2026-07-23T11:25:32.000+03:00
diff --git a/linkedapi/__init__.py b/linkedapi/__init__.py
@@ -54,8 +54,10 @@
     NvSendMessage,
     NvSyncConversation,
     NvSyncInbox,
+    ReactToComment,
     ReactToPost,
     RemoveConnection,
+    ReplyToComment,
     RetrieveConnections,
     RetrieveFeed,
     RetrieveInvitations,
@@ -76,7 +78,7 @@
 from linkedapi.types import __all__ as _types_all
 from linkedapi.webhooks import parse_webhook_event
 
-__version__ = "1.3.4"
+__version__ = "1.3.5"
 PredefinedOperation = Operation
 
 __all__ = [
@@ -128,8 +130,10 @@
     "NvSyncInbox",
     "Operation",
     "PredefinedOperation",
+    "ReactToComment",
     "ReactToPost",
     "RemoveConnection",
+    "ReplyToComment",
     "ResponseMapping",
     "RetrieveInvitations",
     "RetrieveConnections",
diff --git a/linkedapi/client.py b/linkedapi/client.py
@@ -27,8 +27,10 @@
     NvSendMessage,
     NvSyncConversation,
     NvSyncInbox,
+    ReactToComment,
     ReactToPost,
     RemoveConnection,
+    ReplyToComment,
     RetrieveConnections,
     RetrieveFeed,
     RetrieveInvitations,
@@ -90,6 +92,8 @@ def __init__(self, config: LinkedApiConfig | HttpClient[Any]) -> None:
         self.fetch_job = FetchJob(self.http_client)
         self.react_to_post = ReactToPost(self.http_client)
         self.comment_on_post = CommentOnPost(self.http_client)
+        self.react_to_comment = ReactToComment(self.http_client)
+        self.reply_to_comment = ReplyToComment(self.http_client)
         self.create_post = CreatePost(self.http_client)
         self.retrieve_feed = RetrieveFeed(self.http_client)
         self.retrieve_ssi = RetrieveSSI(self.http_client)
@@ -128,6 +132,8 @@ def __init__(self, config: LinkedApiConfig | HttpClient[Any]) -> None:
             self.fetch_job,
             self.react_to_post,
             self.comment_on_post,
+            self.react_to_comment,
+            self.reply_to_comment,
             self.create_post,
             self.retrieve_feed,
             self.retrieve_ssi,
diff --git a/linkedapi/errors.py b/linkedapi/errors.py
@@ -20,6 +20,8 @@
     "postNotFound",
     "jobNotFound",
     "commentingNotAllowed",
+    "commentNotFound",
+    "replyingNotAllowed",
     "noPostingPermission",
     "noSalesNavigator",
     "conversationsNotSynced",
@@ -43,6 +45,8 @@
     "postNotFound",
     "jobNotFound",
     "commentingNotAllowed",
+    "commentNotFound",
+    "replyingNotAllowed",
     "noPostingPermission",
     "noSalesNavigator",
     "conversationsNotSynced",
diff --git a/linkedapi/operations/__init__.py b/linkedapi/operations/__init__.py
@@ -17,8 +17,10 @@
 from linkedapi.operations.nv_send_message import NvSendMessage
 from linkedapi.operations.nv_sync_conversation import NvSyncConversation
 from linkedapi.operations.nv_sync_inbox import NvSyncInbox
+from linkedapi.operations.react_to_comment import ReactToComment
 from linkedapi.operations.react_to_post import ReactToPost
 from linkedapi.operations.remove_connection import RemoveConnection
+from linkedapi.operations.reply_to_comment import ReplyToComment
 from linkedapi.operations.retrieve_connections import RetrieveConnections
 from linkedapi.operations.retrieve_feed import RetrieveFeed
 from linkedapi.operations.retrieve_invitations import RetrieveInvitations
@@ -61,8 +63,10 @@
     "NvSendMessage",
     "NvSyncConversation",
     "NvSyncInbox",
+    "ReactToComment",
     "ReactToPost",
     "RemoveConnection",
+    "ReplyToComment",
     "RetrieveConnections",
     "RetrieveFeed",
     "RetrieveInvitations",
diff --git a/linkedapi/operations/comment_on_post.py b/linkedapi/operations/comment_on_post.py
@@ -1,12 +1,15 @@
 from __future__ import annotations
 
 from linkedapi.core import Operation
-from linkedapi.mappers import VoidWorkflowMapper
-from linkedapi.types import CommentOnPostParams
+from linkedapi.mappers import SimpleWorkflowMapper
+from linkedapi.types import CommentOnPostParams, CommentResult
 
 
-class CommentOnPost(Operation[CommentOnPostParams, None]):
+class CommentOnPost(Operation[CommentOnPostParams, CommentResult]):
     """Comment on a LinkedIn post."""
 
     operation_name = "commentOnPost"
-    mapper = VoidWorkflowMapper[CommentOnPostParams]("st.commentOnPost")
+    mapper = SimpleWorkflowMapper[CommentOnPostParams, CommentResult](
+        "st.commentOnPost",
+        result_model=CommentResult,
+    )
diff --git a/linkedapi/operations/react_to_comment.py b/linkedapi/operations/react_to_comment.py
@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+from linkedapi.core import Operation
+from linkedapi.mappers import VoidWorkflowMapper
+from linkedapi.types import ReactToCommentParams
+
+
+class ReactToComment(Operation[ReactToCommentParams, None]):
+    """React to a LinkedIn comment."""
+
+    operation_name = "reactToComment"
+    mapper = VoidWorkflowMapper[ReactToCommentParams]("st.reactToComment")
diff --git a/linkedapi/operations/reply_to_comment.py b/linkedapi/operations/reply_to_comment.py
@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from linkedapi.core import Operation
+from linkedapi.mappers import SimpleWorkflowMapper
+from linkedapi.types import CommentResult, ReplyToCommentParams
+
+
+class ReplyToComment(Operation[ReplyToCommentParams, CommentResult]):
+    """Reply to a LinkedIn comment."""
+
+    operation_name = "replyToComment"
+    mapper = SimpleWorkflowMapper[ReplyToCommentParams, CommentResult](
+        "st.replyToComment",
+        result_model=CommentResult,
+    )
diff --git a/linkedapi/types/__init__.py b/linkedapi/types/__init__.py
@@ -149,6 +149,8 @@
     BaseFetchPostParamsWide,
     Comment,
     CommentOnPostParams,
+    CommentOnPostResult,
+    CommentResult,
     CreatePostAttachment,
     CreatePostParams,
     CreatePostResult,
@@ -168,7 +170,10 @@
     PostType,
     Reaction,
     ReactionType,
+    ReactToCommentParams,
     ReactToPostParams,
+    ReplyToCommentParams,
+    ReplyToCommentResult,
 )
 from linkedapi.types.responses import LinkedApiRequestError, LinkedApiResponse
 from linkedapi.types.search_companies import (
@@ -262,6 +267,8 @@
     "CheckConnectionStatusResult",
     "Comment",
     "CommentOnPostParams",
+    "CommentOnPostResult",
+    "CommentResult",
     "Company",
     "ConnectionPerson",
     "ConnectionSession",
@@ -372,6 +379,7 @@
     "PostReactionsRetrievalConfig",
     "PostReposter",
     "PostType",
+    "ReactToCommentParams",
     "ReactToPostParams",
     "Reaction",
     "ReactionType",
@@ -381,6 +389,8 @@
     "ReparseAccountInfoParams",
     "ReparseAccountInfoResult",
     "ReplayWebhookDeliveryParams",
+    "ReplyToCommentParams",
+    "ReplyToCommentResult",
     "ResetLimitsParams",
     "RetrieveConnectionsFilter",
     "RetrieveConnectionsParams",
diff --git a/linkedapi/types/post.py b/linkedapi/types/post.py
@@ -40,7 +40,30 @@ class CommentOnPostParams(BaseActionParams):
     company_url: str | None = None
 
 
+class CommentResult(LinkedApiModel):
+    comment_urn: str | None = None
+    comment_url: str | None = None
+
+
+CommentOnPostResult: TypeAlias = CommentResult
+
+
+class ReactToCommentParams(BaseActionParams):
+    comment_url: str
+    type: ReactionType = "like"
+
+
+class ReplyToCommentParams(BaseActionParams):
+    comment_url: str
+    text: str
+
+
+ReplyToCommentResult: TypeAlias = CommentResult
+
+
 class PostComment(LinkedApiModel):
+    comment_urn: str | None = None
+    comment_url: str | None = None
     commenter_url: str | None = None
     commenter_name: str | None = None
     commenter_headline: str | None = None
diff --git a/pyproject.toml b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "linkedapi"
-version = "1.3.4"
+version = "1.3.5"
 description = "Official synchronous Python SDK for Linked API."
 readme = "README.md"
 requires-python = ">=3.10"
diff --git a/tests/test_errors.py b/tests/test_errors.py
@@ -47,6 +47,8 @@ def test_error_type_sets_match_node_contract() -> None:
         "postNotFound",
         "jobNotFound",
         "commentingNotAllowed",
+        "commentNotFound",
+        "replyingNotAllowed",
         "noPostingPermission",
         "noSalesNavigator",
         "conversationsNotSynced",
diff --git a/tests/test_operations.py b/tests/test_operations.py
@@ -13,6 +13,7 @@
     LinkedApi,
     LinkedApiConfig,
     RetrieveFeedParams,
+    SimpleWorkflowMapper,
     VoidWorkflowMapper,
 )
 
@@ -53,6 +54,8 @@ def test_linked_api_exposes_all_predefined_operations() -> None:
         "nv_manage_conversation",
         "react_to_post",
         "comment_on_post",
+        "react_to_comment",
+        "reply_to_comment",
         "create_post",
         "retrieve_ssi",
         "retrieve_performance",
@@ -63,7 +66,7 @@ def test_linked_api_exposes_all_predefined_operations() -> None:
         assert hasattr(operation, "execute")
         assert hasattr(operation, "result")
         assert hasattr(operation, "cancel")
-    assert len(linkedapi.operations) == 36
+    assert len(linkedapi.operations) == 38
 
 
 def test_operation_mappers_match_node_contract() -> None:
@@ -95,6 +98,12 @@ def test_operation_mappers_match_node_contract() -> None:
     assert linkedapi.manage_conversation.mapper.action_type == "st.manageConversation"
     assert isinstance(linkedapi.nv_manage_conversation.mapper, VoidWorkflowMapper)
     assert linkedapi.nv_manage_conversation.mapper.action_type == "nv.manageConversation"
+    assert isinstance(linkedapi.react_to_comment.mapper, VoidWorkflowMapper)
+    assert linkedapi.react_to_comment.mapper.action_type == "st.reactToComment"
+    assert isinstance(linkedapi.comment_on_post.mapper, SimpleWorkflowMapper)
+    assert linkedapi.comment_on_post.mapper.action_type == "st.commentOnPost"
+    assert isinstance(linkedapi.reply_to_comment.mapper, SimpleWorkflowMapper)
+    assert linkedapi.reply_to_comment.mapper.action_type == "st.replyToComment"
 
 
 def test_retrieve_feed_maps_params_and_feed_context() -> None:
