linkedapi 1.3.8__tar.gz → 1.3.11__tar.gz

{linkedapi-1.3.8 → linkedapi-1.3.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: linkedapi
-Version: 1.3.8
+Version: 1.3.11
 Summary: Official synchronous Python SDK for Linked API.
 Project-URL: Homepage, https://linkedapi.io
 Project-URL: Repository, https://github.com/Linked-API/linkedapi-python

{linkedapi-1.3.8 → linkedapi-1.3.11}/linkedapi/__init__.py

@@ -63,10 +63,12 @@ from linkedapi.operations import (
     RetrieveInvitations,
     RetrievePendingRequests,
     RetrievePerformance,
+    RetrieveProfileViewers,
     RetrieveSSI,
     SearchCompanies,
     SearchJobs,
     SearchPeople,
+    SearchPosts,
     SendConnectionRequest,
     SendMessage,
     SyncConversation,
@@ -78,7 +80,7 @@ from linkedapi.types import *  # noqa: F403
 from linkedapi.types import __all__ as _types_all
 from linkedapi.webhooks import parse_webhook_event
 
-__version__ = "1.3.8"
+__version__ = "1.3.11"
 PredefinedOperation = Operation
 
 __all__ = [
@@ -140,10 +142,12 @@ __all__ = [
     "RetrieveFeed",
     "RetrievePendingRequests",
     "RetrievePerformance",
+    "RetrieveProfileViewers",
     "RetrieveSSI",
     "SearchCompanies",
     "SearchJobs",
     "SearchPeople",
+    "SearchPosts",
     "SendConnectionRequest",
     "SendMessage",
     "SimpleWorkflowMapper",

{linkedapi-1.3.8 → linkedapi-1.3.11}/linkedapi/client.py

@@ -36,10 +36,12 @@ from linkedapi.operations import (
     RetrieveInvitations,
     RetrievePendingRequests,
     RetrievePerformance,
+    RetrieveProfileViewers,
     RetrieveSSI,
     SearchCompanies,
     SearchJobs,
     SearchPeople,
+    SearchPosts,
     SendConnectionRequest,
     SendMessage,
     SyncConversation,
@@ -86,6 +88,7 @@ class LinkedApi:
         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)
@@ -98,6 +101,7 @@ class LinkedApi:
         self.retrieve_feed = RetrieveFeed(self.http_client)
         self.retrieve_ssi = RetrieveSSI(self.http_client)
         self.retrieve_performance = RetrievePerformance(self.http_client)
+        self.retrieve_profile_viewers = RetrieveProfileViewers(self.http_client)
         self.nv_send_message = NvSendMessage(self.http_client)
         self.nv_sync_conversation = NvSyncConversation(self.http_client)
         self.nv_sync_inbox = NvSyncInbox(self.http_client)
@@ -126,6 +130,7 @@ class LinkedApi:
             self.search_companies,
             self.search_people,
             self.search_jobs,
+            self.search_posts,
             self.fetch_company,
             self.fetch_person,
             self.fetch_post,
@@ -138,6 +143,7 @@ class LinkedApi:
             self.retrieve_feed,
             self.retrieve_ssi,
             self.retrieve_performance,
+            self.retrieve_profile_viewers,
             self.nv_send_message,
             self.nv_sync_conversation,
             self.nv_sync_inbox,

{linkedapi-1.3.8 → linkedapi-1.3.11}/linkedapi/errors.py

@@ -16,6 +16,8 @@ LinkedApiActionErrorType = Literal[
     "retrievingNotAllowed",
     "connectionNotFound",
     "searchingNotAllowed",
+    "searchInterfaceMismatch",
+    "filterIdentityMismatch",
     "companyNotFound",
     "postNotFound",
     "jobNotFound",
@@ -41,6 +43,8 @@ LINKED_API_ACTION_ERROR_TYPES: tuple[str, ...] = (
     "retrievingNotAllowed",
     "connectionNotFound",
     "searchingNotAllowed",
+    "searchInterfaceMismatch",
+    "filterIdentityMismatch",
     "companyNotFound",
     "postNotFound",
     "jobNotFound",

{linkedapi-1.3.8 → linkedapi-1.3.11}/linkedapi/operations/__init__.py

@@ -26,10 +26,12 @@ from linkedapi.operations.retrieve_feed import RetrieveFeed
 from linkedapi.operations.retrieve_invitations import RetrieveInvitations
 from linkedapi.operations.retrieve_pending_requests import RetrievePendingRequests
 from linkedapi.operations.retrieve_performance import RetrievePerformance
+from linkedapi.operations.retrieve_profile_viewers import RetrieveProfileViewers
 from linkedapi.operations.retrieve_ssi import RetrieveSSI
 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
@@ -72,10 +74,12 @@ __all__ = [
     "RetrieveInvitations",
     "RetrievePendingRequests",
     "RetrievePerformance",
+    "RetrieveProfileViewers",
     "RetrieveSSI",
     "SearchCompanies",
     "SearchJobs",
     "SearchPeople",
+    "SearchPosts",
     "SendConnectionRequest",
     "SendMessage",
     "SyncConversation",

linkedapi-1.3.11/linkedapi/operations/retrieve_profile_viewers.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from linkedapi.core import Operation
+from linkedapi.mappers import ArrayWorkflowMapper
+from linkedapi.types import ProfileViewer, RetrieveProfileViewersParams
+
+
+class RetrieveProfileViewers(Operation[RetrieveProfileViewersParams, list[ProfileViewer]]):
+    """Retrieve the viewers visible on the current account's LinkedIn profile."""
+
+    operation_name = "retrieveProfileViewers"
+    mapper = ArrayWorkflowMapper[RetrieveProfileViewersParams, ProfileViewer](
+        "st.retrieveProfileViewers",
+        ProfileViewer,
+    )

linkedapi-1.3.11/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-1.3.8 → linkedapi-1.3.11}/linkedapi/types/__init__.py

@@ -96,12 +96,15 @@ from linkedapi.types.jobs import (
     JobDatePosted,
     JobEmploymentType,
     JobExperienceLevel,
+    JobPreferenceEmploymentType,
+    JobPreferenceExperienceLevel,
     JobSalary,
     JobWorkplaceType,
     SalaryPeriod,
     SearchJobResult,
     SearchJobsFilter,
     SearchJobsParams,
+    SearchJobsPreferences,
 )
 from linkedapi.types.message import (
     ConversationPollRequest,
@@ -177,6 +180,11 @@ from linkedapi.types.post import (
     ReplyToCommentParams,
     ReplyToCommentResult,
 )
+from linkedapi.types.profile_viewers import (
+    ProfileViewer,
+    ProfileViewerType,
+    RetrieveProfileViewersParams,
+)
 from linkedapi.types.responses import LinkedApiRequestError, LinkedApiResponse
 from linkedapi.types.search_companies import (
     AnnualRevenueFilter,
@@ -198,6 +206,20 @@ from linkedapi.types.search_people import (
     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,
@@ -315,6 +337,8 @@ __all__ = [
     "JobDatePosted",
     "JobEmploymentType",
     "JobExperienceLevel",
+    "JobPreferenceEmploymentType",
+    "JobPreferenceExperienceLevel",
     "JobSalary",
     "JobWorkplaceType",
     "LanguageProficiency",
@@ -382,7 +406,13 @@ __all__ = [
     "PostReaction",
     "PostReactionsRetrievalConfig",
     "PostReposter",
+    "PostSearchContentType",
+    "PostSearchDatePosted",
+    "PostSearchPostedBy",
+    "PostSearchSort",
     "PostType",
+    "ProfileViewer",
+    "ProfileViewerType",
     "ReactToCommentParams",
     "ReactToPostParams",
     "Reaction",
@@ -402,6 +432,7 @@ __all__ = [
     "RetrieveFeedParams",
     "RetrievePendingRequestsResult",
     "RetrievePerformanceResult",
+    "RetrieveProfileViewersParams",
     "RetrieveSSIResult",
     "SalaryPeriod",
     "SearchCompaniesFilter",
@@ -411,9 +442,18 @@ __all__ = [
     "SearchJobResult",
     "SearchJobsFilter",
     "SearchJobsParams",
+    "SearchJobsPreferences",
     "SearchPeopleFilter",
     "SearchPeopleParams",
     "SearchPeopleResult",
+    "SearchPostActor",
+    "SearchPostResult",
+    "SearchPostsCompanyFilter",
+    "SearchPostsCompanyFilterEntry",
+    "SearchPostsFilter",
+    "SearchPostsParams",
+    "SearchPostsPersonFilter",
+    "SearchPostsPersonFilterEntry",
     "SeatType",
     "SendConnectionRequestParams",
     "SendMessageManageConversation",

{linkedapi-1.3.8 → linkedapi-1.3.11}/linkedapi/types/jobs.py

@@ -24,6 +24,24 @@ JobEmploymentType = Literal[
     "other",
 ]
 JobWorkplaceType = Literal["onSite", "remote", "hybrid"]
+# Experience levels of LinkedIn's AI-powered jobs search. Not a subset of JobExperienceLevel:
+# "senior" corresponds to "midSeniorLevel", "manager" has no classic equivalent, and "internship"
+# and "associate" are absent here.
+JobPreferenceExperienceLevel = Literal[
+    "entryLevel",
+    "senior",
+    "manager",
+    "director",
+    "executive",
+]
+# Same names as JobEmploymentType, minus "temporary" and "other".
+JobPreferenceEmploymentType = Literal[
+    "fullTime",
+    "partTime",
+    "contract",
+    "internship",
+    "volunteer",
+]
 SalaryPeriod = Literal["yearly", "monthly", "hourly"]
 JobCurrency = Literal[
     "usd",
@@ -74,6 +92,12 @@ class JobSalary(LinkedApiModel):
 
 
 class SearchJobsFilter(LinkedApiModel):
+    """Filtering criteria for the classic LinkedIn jobs search.
+
+    Every specified field is applied, or the action fails.
+    """
+
+    # Deprecated: use the top-level "location" of SearchJobsParams instead.
     location: str | None = None
     date_posted: JobDatePosted | None = None
     experience_levels: list[JobExperienceLevel] | None = None
@@ -89,9 +113,32 @@ class SearchJobsFilter(LinkedApiModel):
     fair_chance_employer: bool | None = None
 
 
+class SearchJobsPreferences(LinkedApiModel):
+    """Filtering criteria for LinkedIn's AI-powered jobs search.
+
+    LinkedIn decides which of them it offers for a given search, and the ones it does not offer are
+    skipped instead of failing the action.
+    """
+
+    date_posted: JobDatePosted | None = None
+    experience_levels: list[JobPreferenceExperienceLevel] | None = None
+    employment_types: list[JobPreferenceEmploymentType] | None = None
+    companies: list[str] | None = None
+    remote: bool | None = None
+    easy_apply: bool | None = None
+    under_10_applicants: bool | None = None
+    in_your_network: bool | None = None
+    keywords: list[str] | None = None
+
+
 class SearchJobsParams(BaseActionParams, LimitParams):
     term: str | None = None
+    location: str | None = None
+    allow_similar_results: bool | None = None
+    # "filter" and "preferences" are mutually exclusive: "filter" targets the classic LinkedIn jobs
+    # search, "preferences" the AI-powered one.
     filter: SearchJobsFilter | None = None
+    preferences: SearchJobsPreferences | None = None
     custom_search_url: str | None = None
 
 
@@ -106,6 +153,7 @@ class SearchJobResult(LinkedApiModel):
     salary: JobSalary | None = None
     easy_apply: bool | None = None
     is_promoted: bool | None = None
+    is_similar_match: bool | None = None
 
 
 class FetchJobParams(BaseActionParams):
@@ -118,7 +166,6 @@ class Job(LinkedApiModel):
     job_url: str | None = None
     title: str | None = None
     company_name: str | None = None
-    company_urn: str | None = None
     company_url: str | None = None
     location: str | None = None
     posted_date: str | None = None

{linkedapi-1.3.8 → linkedapi-1.3.11}/linkedapi/types/message.py

@@ -97,6 +97,9 @@ class InboxMessage(LinkedApiModel):
     type: ConversationType | None = None
     thread_id: str | None = None
     person_urn: str | None = None
+    person_hashed_url: str | None = None
+    person_public_url: str | None = None
+    # Deprecated: use person_hashed_url. Still returned by the API for compatibility.
     person_url: str | None = None
     sender: MessageSender | None = None
     text: str | None = None

linkedapi-1.3.11/linkedapi/types/profile_viewers.py

@@ -0,0 +1,82 @@
+from __future__ import annotations
+
+from typing import Literal
+
+from pydantic import Field, model_validator
+
+from linkedapi.types.base import LinkedApiModel
+from linkedapi.types.params import BaseActionParams
+
+ProfileViewerType = Literal["identified", "anonymous"]
+
+
+class RetrieveProfileViewersParams(BaseActionParams):
+    limit: int | None = Field(default=None, ge=1, le=300)
+    since: str | None = None
+
+
+class ProfileViewer(LinkedApiModel):
+    viewer_type: ProfileViewerType
+    viewed_at: str | None
+    viewed_ago: str | None
+    name: str | None = None
+    public_url: str | None = None
+    urn: str | None = None
+    headline: str | None = None
+    connection_degree: Literal[1, 2, 3] | None = None
+    avatar_url: str | None = None
+    description: str | None = None
+    search_url: str | None = None
+
+    @model_validator(mode="after")
+    def validate_type_fields(self) -> ProfileViewer:
+        type_fields = {
+            "name",
+            "public_url",
+            "urn",
+            "headline",
+            "connection_degree",
+            "avatar_url",
+            "description",
+            "search_url",
+        }
+        required_fields = {
+            "identified": {
+                "name",
+                "public_url",
+                "urn",
+                "headline",
+                "connection_degree",
+                "avatar_url",
+            },
+            "anonymous": {"description", "search_url"},
+        }[self.viewer_type]
+        missing_fields = required_fields - self.model_fields_set
+        if missing_fields:
+            msg = (
+                f"{self.viewer_type} profile viewer is missing required fields: "
+                f"{', '.join(sorted(missing_fields))}"
+            )
+            raise ValueError(msg)
+
+        unexpected_fields = (self.model_fields_set & type_fields) - required_fields
+        if unexpected_fields:
+            msg = (
+                f"{self.viewer_type} profile viewer contains fields for another type: "
+                f"{', '.join(sorted(unexpected_fields))}"
+            )
+            raise ValueError(msg)
+
+        required_values = {
+            "identified": {"name": self.name, "public_url": self.public_url},
+            "anonymous": {"description": self.description, "search_url": self.search_url},
+        }[self.viewer_type]
+        null_fields = [name for name, value in required_values.items() if value is None]
+        if null_fields:
+            msg = (
+                f"{self.viewer_type} profile viewer requires non-null fields: "
+                f"{', '.join(sorted(null_fields))}"
+            )
+            raise ValueError(msg)
+
+        return self

linkedapi-1.3.11/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

{linkedapi-1.3.8 → linkedapi-1.3.11}/linkedapi/types/webhooks.py

@@ -102,6 +102,9 @@ class MessageWebhookEventData(LinkedApiModel):
     type: ConversationType | None = None
     thread_id: str | None = None
     person_urn: str | None = None
+    person_hashed_url: str | None = None
+    person_public_url: str | None = None
+    # Deprecated: use person_hashed_url. Still returned by the API for compatibility.
     person_url: str | None = None
     message_id: str | None = None
     sender: MessageSender | None = None

{linkedapi-1.3.8 → linkedapi-1.3.11}/pyproject.toml

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

{linkedapi-1.3.8 → linkedapi-1.3.11}/tests/test_errors.py

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

{linkedapi-1.3.8 → linkedapi-1.3.11}/tests/test_operations.py

@@ -13,6 +13,12 @@ from linkedapi import (
     LinkedApi,
     LinkedApiConfig,
     RetrieveFeedParams,
+    SearchPostActor,
+    SearchPostResult,
+    SearchPostsCompanyFilter,
+    SearchPostsFilter,
+    SearchPostsParams,
+    SearchPostsPersonFilter,
     SimpleWorkflowMapper,
     VoidWorkflowMapper,
 )
@@ -33,6 +39,7 @@ def test_linked_api_exposes_all_predefined_operations() -> None:
         "search_companies",
         "nv_search_companies",
         "search_jobs",
+        "search_posts",
         "send_connection_request",
         "check_connection_status",
         "withdraw_connection_request",
@@ -59,6 +66,7 @@ def test_linked_api_exposes_all_predefined_operations() -> None:
         "create_post",
         "retrieve_ssi",
         "retrieve_performance",
+        "retrieve_profile_viewers",
     ]
 
     for name in operation_names:
@@ -66,7 +74,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) == 38
+    assert len(linkedapi.operations) == 40
 
 
 def test_operation_mappers_match_node_contract() -> None:
@@ -78,6 +86,8 @@ def test_operation_mappers_match_node_contract() -> None:
     assert linkedapi.search_people.mapper.base_action_type == "st.searchPeople"
     assert isinstance(linkedapi.search_jobs.mapper, ArrayWorkflowMapper)
     assert linkedapi.search_jobs.mapper.base_action_type == "st.searchJobs"
+    assert isinstance(linkedapi.search_posts.mapper, ArrayWorkflowMapper)
+    assert linkedapi.search_posts.mapper.base_action_type == "st.searchPosts"
     assert linkedapi.fetch_job.mapper.base_action_type == "st.openJob"
     assert linkedapi.fetch_job.mapper.default_params == {"basicInfo": True}
     assert isinstance(linkedapi.send_connection_request.mapper, VoidWorkflowMapper)
@@ -133,6 +143,153 @@ def test_retrieve_feed_maps_params_and_feed_context() -> None:
             RetrieveFeedParams(limit=invalid_limit)
 
 
+def test_search_posts_maps_filter_params_and_actors_without_urn() -> None:
+    linkedapi = LinkedApi(LinkedApiConfig(linked_api_token="x", identification_token="y"))
+
+    request = linkedapi.search_posts.mapper.map_request(
+        SearchPostsParams(
+            term="climate tech",
+            limit=20,
+            filter={
+                "sort": "latest",
+                "date_posted": "pastWeek",
+                "content_type": "images",
+                "posted_by": ["firstConnections", "peopleYouFollow"],
+                "from_members": [{"name": "Bill Gates", "urn": "urn:li:member:251749025"}],
+                "from_companies": ["Example Company"],
+                "mentioning_members": [],
+                "mentioning_companies": [],
+                "author_companies": [
+                    {"name": "Example Company", "urn": "urn:li:organization:1234567"}
+                ],
+                "author_industries": ["Software Development"],
+            },
+            custom_search_url=(
+                "https://www.linkedin.com/search/results/content/?keywords=climate%20tech"
+            ),
+        )
+    )
+
+    assert request == {
+        "actionType": "st.searchPosts",
+        "term": "climate tech",
+        "limit": 20,
+        "filter": {
+            "sort": "latest",
+            "datePosted": "pastWeek",
+            "contentType": "images",
+            "postedBy": ["firstConnections", "peopleYouFollow"],
+            "fromMembers": [{"name": "Bill Gates", "urn": "urn:li:member:251749025"}],
+            "fromCompanies": ["Example Company"],
+            "mentioningMembers": [],
+            "mentioningCompanies": [],
+            "authorCompanies": [{"name": "Example Company", "urn": "urn:li:organization:1234567"}],
+            "authorIndustries": ["Software Development"],
+        },
+        "customSearchUrl": "https://www.linkedin.com/search/results/content/?keywords=climate%20tech",
+    }
+
+    response = linkedapi.search_posts.mapper.map_response(
+        {
+            "actionType": "st.searchPosts",
+            "success": True,
+            "data": [
+                {
+                    "url": "https://www.linkedin.com/feed/update/urn:li:activity:1",
+                    "activityUrn": "urn:li:activity:1",
+                    "time": "2023-01-01T09:15:00Z",
+                    "type": "repost",
+                    "author": {
+                        "type": "company",
+                        "name": "Example Company",
+                        "companyUrl": "https://www.linkedin.com/company/example-company",
+                    },
+                    "reposter": {
+                        "type": "person",
+                        "name": "Example Reposter",
+                        "profileUrl": "https://www.linkedin.com/in/example-reposter",
+                        "headline": None,
+                    },
+                    "text": "Original post content about the webinar.",
+                    "repostText": "A useful summary for anyone planning a launch.",
+                    "hashtags": [],
+                    "mentions": [],
+                    "externalLinks": [],
+                    "images": [],
+                    "documentSlides": [],
+                    "hasVideo": True,
+                    "videoThumbnail": "https://media.licdn.com/dms/image/video-cover.jpg",
+                    "hasPoll": False,
+                    "reactionsCount": 6,
+                    "commentsCount": 0,
+                    "repostsCount": 1,
+                }
+            ],
+        }
+    )
+
+    assert response.data is not None
+    post = response.data[0]
+    assert isinstance(post, SearchPostResult)
+    assert post.activity_urn == "urn:li:activity:1"
+    assert post.author is not None
+    assert post.author.company_url == "https://www.linkedin.com/company/example-company"
+    assert post.reposter is not None
+    assert post.reposter.profile_url == "https://www.linkedin.com/in/example-reposter"
+    assert post.video_thumbnail == "https://media.licdn.com/dms/image/video-cover.jpg"
+    assert post.reposts_count == 1
+    # A search result never resolves an actor urn, so the field must not exist on this surface.
+    assert "urn" not in SearchPostActor.model_fields
+
+
+def test_search_posts_actor_filters_accept_bare_strings_and_objects_mixed() -> None:
+    params = SearchPostsParams(
+        term="ai",
+        filter=SearchPostsFilter(
+            from_members=[
+                "Bill Gates",
+                SearchPostsPersonFilter(
+                    name="Satya Nadella",
+                    person_hashed_url="https://www.linkedin.com/in/ACoAAABC",
+                ),
+            ],
+            from_companies=[
+                "Acme",
+                SearchPostsCompanyFilter(
+                    name="Globex",
+                    company_hashed_url="https://www.linkedin.com/company/1035",
+                ),
+            ],
+        ),
+    )
+
+    assert params.model_dump(by_alias=True, exclude_none=True) == {
+        "term": "ai",
+        "filter": {
+            "fromMembers": [
+                "Bill Gates",
+                {
+                    "name": "Satya Nadella",
+                    "personHashedUrl": "https://www.linkedin.com/in/ACoAAABC",
+                },
+            ],
+            "fromCompanies": [
+                "Acme",
+                {
+                    "name": "Globex",
+                    "companyHashedUrl": "https://www.linkedin.com/company/1035",
+                },
+            ],
+        },
+    }
+
+    with pytest.raises(ValidationError):
+        SearchPostsFilter(sort="mostRecent")
+
+    with pytest.raises(ValidationError):
+        SearchPostsFilter(from_members=[{"urn": "urn:li:member:1"}])
+
+
 def test_invitation_params_require_the_matching_target_url() -> None:
     params = AcceptInvitationParams(
         invitation_type="companyFollow",