update job searching

Author: LordOfTheVillage

linkedapi/errors.py

@@ -16,6 +16,7 @@
     "retrievingNotAllowed",
     "connectionNotFound",
     "searchingNotAllowed",
+    "searchInterfaceMismatch",
     "companyNotFound",
     "postNotFound",
     "jobNotFound",
@@ -41,6 +42,7 @@
     "retrievingNotAllowed",
     "connectionNotFound",
     "searchingNotAllowed",
+    "searchInterfaceMismatch",
     "companyNotFound",
     "postNotFound",
     "jobNotFound",

linkedapi/types/__init__.py

@@ -96,12 +96,15 @@
     JobDatePosted,
     JobEmploymentType,
     JobExperienceLevel,
+    JobPreferenceEmploymentType,
+    JobPreferenceExperienceLevel,
     JobSalary,
     JobWorkplaceType,
     SalaryPeriod,
     SearchJobResult,
     SearchJobsFilter,
     SearchJobsParams,
+    SearchJobsPreferences,
 )
 from linkedapi.types.message import (
     ConversationPollRequest,
@@ -320,6 +323,8 @@
     "JobDatePosted",
     "JobEmploymentType",
     "JobExperienceLevel",
+    "JobPreferenceEmploymentType",
+    "JobPreferenceExperienceLevel",
     "JobSalary",
     "JobWorkplaceType",
     "LanguageProficiency",
@@ -419,6 +424,7 @@
     "SearchJobResult",
     "SearchJobsFilter",
     "SearchJobsParams",
+    "SearchJobsPreferences",
     "SearchPeopleFilter",
     "SearchPeopleParams",
     "SearchPeopleResult",

linkedapi/types/jobs.py

@@ -24,6 +24,24 @@
     "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

pyproject.toml

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

tests/test_errors.py

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