add st.searchPosts action

Author: LordOfTheVillage

linkedapi/__init__.py

@@ -68,6 +68,7 @@
     SearchCompanies,
     SearchJobs,
     SearchPeople,
+    SearchPosts,
     SendConnectionRequest,
     SendMessage,
     SyncConversation,
@@ -79,7 +80,7 @@
 from linkedapi.types import __all__ as _types_all
 from linkedapi.webhooks import parse_webhook_event
 
-__version__ = "1.3.9"
+__version__ = "1.3.11"
 PredefinedOperation = Operation
 
 __all__ = [
@@ -146,6 +147,7 @@
     "SearchCompanies",
     "SearchJobs",
     "SearchPeople",
+    "SearchPosts",
     "SendConnectionRequest",
     "SendMessage",
     "SimpleWorkflowMapper",

linkedapi/client.py

@@ -41,6 +41,7 @@
     SearchCompanies,
     SearchJobs,
     SearchPeople,
+    SearchPosts,
     SendConnectionRequest,
     SendMessage,
     SyncConversation,
@@ -87,6 +88,7 @@ def __init__(self, config: LinkedApiConfig | HttpClient[Any]) -> None:
         self.search_companies = SearchCompanies(self.http_client)
         self.search_people = SearchPeople(self.http_client)
         self.search_jobs = SearchJobs(self.http_client)
+        self.search_posts = SearchPosts(self.http_client)
         self.fetch_company = FetchCompany(self.http_client)
         self.fetch_person = FetchPerson(self.http_client)
         self.fetch_post = FetchPost(self.http_client)
@@ -128,6 +130,7 @@ def __init__(self, config: LinkedApiConfig | HttpClient[Any]) -> None:
             self.search_companies,
             self.search_people,
             self.search_jobs,
+            self.search_posts,
             self.fetch_company,
             self.fetch_person,
             self.fetch_post,

linkedapi/errors.py

@@ -17,6 +17,7 @@
     "connectionNotFound",
     "searchingNotAllowed",
     "searchInterfaceMismatch",
+    "filterIdentityMismatch",
     "companyNotFound",
     "postNotFound",
     "jobNotFound",
@@ -43,6 +44,7 @@
     "connectionNotFound",
     "searchingNotAllowed",
     "searchInterfaceMismatch",
+    "filterIdentityMismatch",
     "companyNotFound",
     "postNotFound",
     "jobNotFound",

linkedapi/operations/__init__.py

@@ -31,6 +31,7 @@
 from linkedapi.operations.search_companies import SearchCompanies
 from linkedapi.operations.search_jobs import SearchJobs
 from linkedapi.operations.search_people import SearchPeople
+from linkedapi.operations.search_posts import SearchPosts
 from linkedapi.operations.send_connection_request import SendConnectionRequest
 from linkedapi.operations.send_message import SendMessage
 from linkedapi.operations.sync_conversation import SyncConversation
@@ -78,6 +79,7 @@
     "SearchCompanies",
     "SearchJobs",
     "SearchPeople",
+    "SearchPosts",
     "SendConnectionRequest",
     "SendMessage",
     "SyncConversation",

linkedapi/operations/search_posts.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from linkedapi.core import Operation
+from linkedapi.mappers import ArrayWorkflowMapper
+from linkedapi.types import SearchPostResult, SearchPostsParams
+
+
+class SearchPosts(Operation[SearchPostsParams, list[SearchPostResult]]):
+    """Search posts on standard LinkedIn."""
+
+    operation_name = "searchPosts"
+    mapper = ArrayWorkflowMapper[SearchPostsParams, SearchPostResult](
+        "st.searchPosts",
+        SearchPostResult,
+    )

linkedapi/types/__init__.py

@@ -206,6 +206,20 @@
     SearchPeopleParams,
     SearchPeopleResult,
 )
+from linkedapi.types.search_posts import (
+    PostSearchContentType,
+    PostSearchDatePosted,
+    PostSearchPostedBy,
+    PostSearchSort,
+    SearchPostActor,
+    SearchPostResult,
+    SearchPostsCompanyFilter,
+    SearchPostsCompanyFilterEntry,
+    SearchPostsFilter,
+    SearchPostsParams,
+    SearchPostsPersonFilter,
+    SearchPostsPersonFilterEntry,
+)
 from linkedapi.types.statistics import (
     ApiUsageAction,
     ApiUsageParams,
@@ -392,6 +406,10 @@
     "PostReaction",
     "PostReactionsRetrievalConfig",
     "PostReposter",
+    "PostSearchContentType",
+    "PostSearchDatePosted",
+    "PostSearchPostedBy",
+    "PostSearchSort",
     "PostType",
     "ProfileViewer",
     "ProfileViewerType",
@@ -428,6 +446,14 @@
     "SearchPeopleFilter",
     "SearchPeopleParams",
     "SearchPeopleResult",
+    "SearchPostActor",
+    "SearchPostResult",
+    "SearchPostsCompanyFilter",
+    "SearchPostsCompanyFilterEntry",
+    "SearchPostsFilter",
+    "SearchPostsParams",
+    "SearchPostsPersonFilter",
+    "SearchPostsPersonFilterEntry",
     "SeatType",
     "SendConnectionRequestParams",
     "SendMessageManageConversation",

linkedapi/types/search_posts.py

@@ -0,0 +1,103 @@
+from __future__ import annotations
+
+from typing import Literal, TypeAlias
+
+from linkedapi.types.base import LinkedApiModel
+from linkedapi.types.params import BaseActionParams, LimitParams
+from linkedapi.types.post import PostActorType, PostType
+
+PostSearchSort = Literal["topMatch", "latest"]
+PostSearchDatePosted = Literal["past24Hours", "pastWeek", "pastMonth"]
+PostSearchContentType = Literal["videos", "images", "jobPosts", "liveVideos", "documents"]
+PostSearchPostedBy = Literal["me", "firstConnections", "peopleYouFollow"]
+
+
+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.
+    """
+
+    name: str
+    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."""
+
+    name: str
+    urn: str | None = None
+    company_hashed_url: str | None = None
+
+
+# A plain string is shorthand for the name alone: "Bill Gates" means {"name": "Bill Gates"}.
+# Both forms may be mixed in one list.
+SearchPostsPersonFilterEntry: TypeAlias = SearchPostsPersonFilter | str
+SearchPostsCompanyFilterEntry: TypeAlias = SearchPostsCompanyFilter | str
+
+
+class SearchPostsFilter(LinkedApiModel):
+    """Filtering criteria for the LinkedIn content search.
+
+    Every specified field is applied, or the action fails. Ignored entirely when
+    "custom_search_url" is specified.
+    """
+
+    sort: PostSearchSort | None = None
+    date_posted: PostSearchDatePosted | None = None
+    content_type: PostSearchContentType | None = None
+    posted_by: list[PostSearchPostedBy] | None = None
+    from_members: list[SearchPostsPersonFilterEntry] | None = None
+    from_companies: list[SearchPostsCompanyFilterEntry] | None = None
+    mentioning_members: list[SearchPostsPersonFilterEntry] | None = None
+    mentioning_companies: list[SearchPostsCompanyFilterEntry] | None = None
+    author_companies: list[SearchPostsCompanyFilterEntry] | None = None
+    author_industries: list[str] | None = None
+
+
+class SearchPostsParams(BaseActionParams, LimitParams):
+    # Either "term" or "custom_search_url" must be provided. "limit" defaults to 10 and may go up
+    # to 100, or up to 20 when child actions are attached.
+    term: str | None = None
+    filter: SearchPostsFilter | None = None
+    custom_search_url: str | None = None
+
+
+class SearchPostActor(LinkedApiModel):
+    """Whoever a search result attributes content to: its author, or the actor that reshared it.
+
+    Unlike the actors of a post returned by fetch_post, these carry no "urn": the URN is read from
+    identity anchors on the post's own page, and a search result list has none of them.
+    """
+
+    type: PostActorType | None = None
+    name: str | None = None
+    profile_url: str | None = None
+    headline: str | None = None
+    company_url: str | None = None
+
+
+class SearchPostResult(LinkedApiModel):
+    url: str | None = None
+    activity_urn: str | None = None
+    time: str | None = None
+    type: PostType | None = None
+    author: SearchPostActor | None = None
+    # Non-null only when "type" is "repost".
+    reposter: SearchPostActor | None = None
+    text: str | None = None
+    repost_text: str | None = None
+    hashtags: list[str] | None = None
+    mentions: list[str] | None = None
+    external_links: list[str] | None = None
+    images: list[str] | None = None
+    document_slides: list[str] | None = None
+    has_video: bool | None = None
+    video_thumbnail: str | None = None
+    has_poll: bool | None = None
+    reactions_count: int | None = None
+    comments_count: int | None = None
+    reposts_count: int | None = None

pyproject.toml

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

tests/test_errors.py

@@ -46,6 +46,7 @@ def test_error_type_sets_match_node_contract() -> None:
         "connectionNotFound",
         "searchingNotAllowed",
         "searchInterfaceMismatch",
+        "filterIdentityMismatch",
         "companyNotFound",
         "postNotFound",
         "jobNotFound",