linkedapi 1.0.1__tar.gz → 1.0.2__tar.gz

{linkedapi-1.0.1 → linkedapi-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: linkedapi
-Version: 1.0.1
+Version: 1.0.2
 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.0.1 → linkedapi-1.0.2}/linkedapi/__init__.py

@@ -34,6 +34,8 @@ from linkedapi.operations import (
     CustomWorkflow,
     FetchCompany,
     FetchCompanyMapper,
+    FetchJob,
+    FetchJobMapper,
     FetchPerson,
     FetchPersonMapper,
     FetchPost,
@@ -53,6 +55,7 @@ from linkedapi.operations import (
     RetrievePerformance,
     RetrieveSSI,
     SearchCompanies,
+    SearchJobs,
     SearchPeople,
     SendConnectionRequest,
     SendMessage,
@@ -62,7 +65,7 @@ from linkedapi.operations import (
 from linkedapi.types import *  # noqa: F403
 from linkedapi.types import __all__ as _types_all
 
-__version__ = "1.0.0"
+__version__ = "1.0.2"
 PredefinedOperation = Operation
 
 __all__ = [
@@ -80,6 +83,8 @@ __all__ = [
     "CustomWorkflow",
     "FetchCompany",
     "FetchCompanyMapper",
+    "FetchJob",
+    "FetchJobMapper",
     "FetchPerson",
     "FetchPersonMapper",
     "FetchPost",
@@ -114,6 +119,7 @@ __all__ = [
     "RetrievePerformance",
     "RetrieveSSI",
     "SearchCompanies",
+    "SearchJobs",
     "SearchPeople",
     "SendConnectionRequest",
     "SendMessage",

{linkedapi-1.0.1 → linkedapi-1.0.2}/linkedapi/client.py

@@ -13,6 +13,7 @@ from linkedapi.operations import (
     CreatePost,
     CustomWorkflow,
     FetchCompany,
+    FetchJob,
     FetchPerson,
     FetchPost,
     NvFetchCompany,
@@ -28,6 +29,7 @@ from linkedapi.operations import (
     RetrievePerformance,
     RetrieveSSI,
     SearchCompanies,
+    SearchJobs,
     SearchPeople,
     SendConnectionRequest,
     SendMessage,
@@ -60,9 +62,11 @@ class LinkedApi:
         self.remove_connection = RemoveConnection(self.http_client)
         self.search_companies = SearchCompanies(self.http_client)
         self.search_people = SearchPeople(self.http_client)
+        self.search_jobs = SearchJobs(self.http_client)
         self.fetch_company = FetchCompany(self.http_client)
         self.fetch_person = FetchPerson(self.http_client)
         self.fetch_post = FetchPost(self.http_client)
+        self.fetch_job = FetchJob(self.http_client)
         self.react_to_post = ReactToPost(self.http_client)
         self.comment_on_post = CommentOnPost(self.http_client)
         self.create_post = CreatePost(self.http_client)
@@ -87,9 +91,11 @@ class LinkedApi:
             self.remove_connection,
             self.search_companies,
             self.search_people,
+            self.search_jobs,
             self.fetch_company,
             self.fetch_person,
             self.fetch_post,
+            self.fetch_job,
             self.react_to_post,
             self.comment_on_post,
             self.create_post,

{linkedapi-1.0.1 → linkedapi-1.0.2}/linkedapi/errors.py

@@ -16,6 +16,7 @@ LinkedApiActionErrorType = Literal[
     "searchingNotAllowed",
     "companyNotFound",
     "postNotFound",
+    "jobNotFound",
     "commentingNotAllowed",
     "noPostingPermission",
     "noSalesNavigator",
@@ -35,6 +36,7 @@ LINKED_API_ACTION_ERROR_TYPES: tuple[str, ...] = (
     "searchingNotAllowed",
     "companyNotFound",
     "postNotFound",
+    "jobNotFound",
     "commentingNotAllowed",
     "noPostingPermission",
     "noSalesNavigator",

{linkedapi-1.0.1 → linkedapi-1.0.2}/linkedapi/operations/__init__.py

@@ -3,6 +3,7 @@ from linkedapi.operations.comment_on_post import CommentOnPost
 from linkedapi.operations.create_post import CreatePost
 from linkedapi.operations.custom_workflow import CustomWorkflow
 from linkedapi.operations.fetch_company import FetchCompany, FetchCompanyMapper
+from linkedapi.operations.fetch_job import FetchJob, FetchJobMapper
 from linkedapi.operations.fetch_person import FetchPerson, FetchPersonMapper
 from linkedapi.operations.fetch_post import FetchPost, FetchPostMapper
 from linkedapi.operations.nv_fetch_company import NvFetchCompany, NvFetchCompanyMapper
@@ -18,6 +19,7 @@ from linkedapi.operations.retrieve_pending_requests import RetrievePendingReques
 from linkedapi.operations.retrieve_performance import RetrievePerformance
 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.send_connection_request import SendConnectionRequest
 from linkedapi.operations.send_message import SendMessage
@@ -31,6 +33,8 @@ __all__ = [
     "CustomWorkflow",
     "FetchCompany",
     "FetchCompanyMapper",
+    "FetchJob",
+    "FetchJobMapper",
     "FetchPerson",
     "FetchPersonMapper",
     "FetchPost",
@@ -50,6 +54,7 @@ __all__ = [
     "RetrievePerformance",
     "RetrieveSSI",
     "SearchCompanies",
+    "SearchJobs",
     "SearchPeople",
     "SendConnectionRequest",
     "SendMessage",

linkedapi-1.0.2/linkedapi/operations/fetch_job.py

@@ -0,0 +1,23 @@
+from __future__ import annotations
+
+from linkedapi.core import Operation
+from linkedapi.mappers import ThenWorkflowMapper
+from linkedapi.types import FetchJobParams, Job
+
+
+class FetchJobMapper(ThenWorkflowMapper[FetchJobParams, Job]):
+    def __init__(self) -> None:
+        super().__init__(
+            action_configs=[],
+            response_mappings=[],
+            base_action_type="st.openJob",
+            default_params={"basicInfo": True},
+            result_model=Job,
+        )
+
+
+class FetchJob(Operation[FetchJobParams, Job]):
+    """Fetch a LinkedIn job."""
+
+    operation_name = "fetchJob"
+    mapper = FetchJobMapper()

linkedapi-1.0.2/linkedapi/operations/search_jobs.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from linkedapi.core import Operation
+from linkedapi.mappers import ArrayWorkflowMapper
+from linkedapi.types import SearchJobResult, SearchJobsParams
+
+
+class SearchJobs(Operation[SearchJobsParams, list[SearchJobResult]]):
+    """Search jobs on standard LinkedIn."""
+
+    operation_name = "searchJobs"
+    mapper = ArrayWorkflowMapper[SearchJobsParams, SearchJobResult](
+        "st.searchJobs",
+        SearchJobResult,
+    )

{linkedapi-1.0.1 → linkedapi-1.0.2}/linkedapi/types/__init__.py

@@ -83,6 +83,21 @@ from linkedapi.types.connection import (
     SendConnectionRequestParams,
     WithdrawConnectionRequestParams,
 )
+from linkedapi.types.jobs import (
+    FetchJobParams,
+    FetchJobResult,
+    Job,
+    JobCurrency,
+    JobDatePosted,
+    JobEmploymentType,
+    JobExperienceLevel,
+    JobSalary,
+    JobWorkplaceType,
+    SalaryPeriod,
+    SearchJobResult,
+    SearchJobsFilter,
+    SearchJobsParams,
+)
 from linkedapi.types.message import (
     ConversationPollRequest,
     ConversationPollResult,
@@ -223,6 +238,8 @@ __all__ = [
     "EmploymentType",
     "FetchCompanyParams",
     "FetchCompanyResult",
+    "FetchJobParams",
+    "FetchJobResult",
     "FetchPersonParams",
     "FetchPersonResult",
     "FetchPostParams",
@@ -230,6 +247,13 @@ __all__ = [
     "GetConnectionSessionParams",
     "GetLimitsParams",
     "GetLimitsUsageParams",
+    "Job",
+    "JobCurrency",
+    "JobDatePosted",
+    "JobEmploymentType",
+    "JobExperienceLevel",
+    "JobSalary",
+    "JobWorkplaceType",
     "LanguageProficiency",
     "Limit",
     "LimitCategory",
@@ -298,10 +322,14 @@ __all__ = [
     "RetrievePendingRequestsResult",
     "RetrievePerformanceResult",
     "RetrieveSSIResult",
+    "SalaryPeriod",
     "SearchCompaniesFilter",
     "SearchCompaniesParams",
     "SearchCompanyResult",
     "SearchCompanySize",
+    "SearchJobResult",
+    "SearchJobsFilter",
+    "SearchJobsParams",
     "SearchPeopleFilter",
     "SearchPeopleParams",
     "SearchPeopleResult",

linkedapi-1.0.2/linkedapi/types/jobs.py

@@ -0,0 +1,131 @@
+from __future__ import annotations
+
+from typing import Literal, TypeAlias
+
+from linkedapi.types.base import LinkedApiModel
+from linkedapi.types.params import BaseActionParams, LimitParams
+
+JobDatePosted = Literal["anyTime", "past24Hours", "pastWeek", "pastMonth"]
+JobExperienceLevel = Literal[
+    "internship",
+    "entryLevel",
+    "associate",
+    "midSeniorLevel",
+    "director",
+    "executive",
+]
+JobEmploymentType = Literal[
+    "fullTime",
+    "partTime",
+    "contract",
+    "temporary",
+    "volunteer",
+    "internship",
+    "other",
+]
+JobWorkplaceType = Literal["onSite", "remote", "hybrid"]
+SalaryPeriod = Literal["yearly", "monthly", "hourly"]
+JobCurrency = Literal[
+    "usd",
+    "eur",
+    "gbp",
+    "inr",
+    "cad",
+    "aud",
+    "nzd",
+    "hkd",
+    "sgd",
+    "jpy",
+    "cny",
+    "chf",
+    "sek",
+    "nok",
+    "dkk",
+    "pln",
+    "czk",
+    "huf",
+    "ron",
+    "brl",
+    "mxn",
+    "ars",
+    "zar",
+    "aed",
+    "sar",
+    "ils",
+    "try",
+    "rub",
+    "uah",
+    "krw",
+    "thb",
+    "idr",
+    "myr",
+    "php",
+    "vnd",
+    "ngn",
+    "twd",
+]
+
+
+class JobSalary(LinkedApiModel):
+    currency: JobCurrency | None = None
+    min_amount: float | None = None
+    max_amount: float | None = None
+    period: SalaryPeriod | None = None
+
+
+class SearchJobsFilter(LinkedApiModel):
+    location: str | None = None
+    date_posted: JobDatePosted | None = None
+    experience_levels: list[JobExperienceLevel] | None = None
+    employment_types: list[JobEmploymentType] | None = None
+    workplace_types: list[JobWorkplaceType] | None = None
+    companies: list[str] | None = None
+    industries: list[str] | None = None
+    job_functions: list[str] | None = None
+    easy_apply: bool | None = None
+    has_verifications: bool | None = None
+    under_10_applicants: bool | None = None
+    in_your_network: bool | None = None
+    fair_chance_employer: bool | None = None
+
+
+class SearchJobsParams(BaseActionParams, LimitParams):
+    term: str | None = None
+    filter: SearchJobsFilter | None = None
+    custom_search_url: str | None = None
+
+
+class SearchJobResult(LinkedApiModel):
+    job_id: str | None = None
+    job_url: str | None = None
+    title: str | None = None
+    company_name: str | None = None
+    location: str | None = None
+    workplace_type: str | None = None
+    salary: JobSalary | None = None
+    easy_apply: bool | None = None
+    is_promoted: bool | None = None
+
+
+class FetchJobParams(BaseActionParams):
+    job_url: str
+
+
+class Job(LinkedApiModel):
+    job_id: str | None = None
+    job_url: str | None = None
+    title: str | None = None
+    company_name: str | None = None
+    company_url: str | None = None
+    location: str | None = None
+    posted_date: str | None = None
+    applicants_count: int | None = None
+    workplace_type: str | None = None
+    employment_type: str | None = None
+    salary: JobSalary | None = None
+    description: str | None = None
+    apply_url: str | None = None
+    easy_apply: bool | None = None
+
+
+FetchJobResult: TypeAlias = Job

{linkedapi-1.0.1 → linkedapi-1.0.2}/pyproject.toml

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

{linkedapi-1.0.1 → linkedapi-1.0.2}/tests/test_errors.py

@@ -42,6 +42,7 @@ def test_error_type_sets_match_node_contract() -> None:
         "searchingNotAllowed",
         "companyNotFound",
         "postNotFound",
+        "jobNotFound",
         "commentingNotAllowed",
         "noPostingPermission",
         "noSalesNavigator",

{linkedapi-1.0.1 → linkedapi-1.0.2}/tests/test_operations.py

@@ -20,10 +20,12 @@ def test_linked_api_exposes_all_predefined_operations() -> None:
         "fetch_company",
         "nv_fetch_company",
         "fetch_post",
+        "fetch_job",
         "search_people",
         "nv_search_people",
         "search_companies",
         "nv_search_companies",
+        "search_jobs",
         "send_connection_request",
         "check_connection_status",
         "withdraw_connection_request",
@@ -46,7 +48,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) == 25
+    assert len(linkedapi.operations) == 27
 
 
 def test_operation_mappers_match_node_contract() -> None:
@@ -56,6 +58,10 @@ def test_operation_mappers_match_node_contract() -> None:
     assert linkedapi.fetch_person.mapper.default_params == {"basicInfo": True}
     assert isinstance(linkedapi.search_people.mapper, ArrayWorkflowMapper)
     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 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)
     assert linkedapi.send_connection_request.mapper.action_type == "st.sendConnectionRequest"