pin post search filters by id & add reaction actor

Author: LordOfTheVillage

linkedapi/__init__.py

@@ -87,7 +87,7 @@
     verify_webhook_signature,
 )
 
-__version__ = "1.4.3"
+__version__ = "1.4.4"
 PredefinedOperation = Operation
 
 __all__ = [

linkedapi/types/post.py

@@ -112,6 +112,15 @@ class PostComment(LinkedApiModel):
 
 
 class PostReaction(LinkedApiModel):
+    """One reaction on a post.
+
+    "actor" is whoever reacted, in the same shape a post's author has.
+
+    Deprecated: the engager_* fields are still returned; use "actor" instead.
+    """
+
+    actor: PostAuthor | None = None
+    # Deprecated: use "actor" instead of the five engager_* fields.
     engager_urn: str | None = None
     engager_url: str | None = None
     engager_name: str | None = None

linkedapi/types/search_posts.py

@@ -16,20 +16,30 @@
 class SearchPostsPersonFilter(LinkedApiModel):
     """One person to narrow a post search by.
 
-    "name" is always required because LinkedIn's filter panel accepts nothing but typed text. The
-    optional identifier decides which of the offered namesakes is taken; with "name" alone the pick
-    is whichever suggestion LinkedIn ranked first.
+    With "name" alone the filter may match a namesake. "id" is any identifier of the person - its
+    URN, or its public or hashed LinkedIn URL - and pins the filter to exactly that person; when it
+    cannot be applied, the action fails with "filterNotApplied" rather than filtering by somebody
+    else.
+
+    Deprecated: "urn" and "person_hashed_url" are still accepted; use "id" instead.
     """
 
     name: str
+    id: str | None = None
     urn: str | None = None
     person_hashed_url: str | None = None
 
 
 class SearchPostsCompanyFilter(LinkedApiModel):
-    """One company to narrow a post search by. Same contract as SearchPostsPersonFilter."""
+    """One company to narrow a post search by. Same contract as SearchPostsPersonFilter.
+
+    "id" is the company's URN, its public or hashed LinkedIn URL, or its numeric ID.
+
+    Deprecated: "urn" and "company_hashed_url" are still accepted; use "id" instead.
+    """
 
     name: str
+    id: str | None = None
     urn: str | None = None
     company_hashed_url: str | None = None
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "linkedapi"
-version = "1.4.3"
+version = "1.4.4"
 description = "Official synchronous Python SDK for Linked API."
 readme = "README.md"
 requires-python = ">=3.10"