linkedapi 1.0.1__tar.gz → 1.1.0__tar.gz

{linkedapi-1.0.1 → linkedapi-1.1.0}/.gitignore

@@ -6,4 +6,5 @@ dist/
 .ruff_cache/
 .pytest_cache/
 .venv/
+uv.lock
 build/

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

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

@@ -3,6 +3,7 @@ from linkedapi.admin import (
     AdminHttpClient,
     AdminLimits,
     AdminSubscription,
+    AdminWebhooks,
     LinkedApiAdmin,
 )
 from linkedapi.client import LinkedApi
@@ -34,6 +35,8 @@ from linkedapi.operations import (
     CustomWorkflow,
     FetchCompany,
     FetchCompanyMapper,
+    FetchJob,
+    FetchJobMapper,
     FetchPerson,
     FetchPersonMapper,
     FetchPost,
@@ -53,6 +56,7 @@ from linkedapi.operations import (
     RetrievePerformance,
     RetrieveSSI,
     SearchCompanies,
+    SearchJobs,
     SearchPeople,
     SendConnectionRequest,
     SendMessage,
@@ -61,8 +65,9 @@ from linkedapi.operations import (
 )
 from linkedapi.types import *  # noqa: F403
 from linkedapi.types import __all__ as _types_all
+from linkedapi.webhooks import parse_webhook_event
 
-__version__ = "1.0.0"
+__version__ = "1.1.0"
 PredefinedOperation = Operation
 
 __all__ = [
@@ -71,6 +76,7 @@ __all__ = [
     "AdminHttpClient",
     "AdminLimits",
     "AdminSubscription",
+    "AdminWebhooks",
     "ActionConfig",
     "ArrayWorkflowMapper",
     "BaseMapper",
@@ -80,6 +86,8 @@ __all__ = [
     "CustomWorkflow",
     "FetchCompany",
     "FetchCompanyMapper",
+    "FetchJob",
+    "FetchJobMapper",
     "FetchPerson",
     "FetchPersonMapper",
     "FetchPost",
@@ -114,6 +122,7 @@ __all__ = [
     "RetrievePerformance",
     "RetrieveSSI",
     "SearchCompanies",
+    "SearchJobs",
     "SearchPeople",
     "SendConnectionRequest",
     "SendMessage",
@@ -123,5 +132,6 @@ __all__ = [
     "VoidWorkflowMapper",
     "WithdrawConnectionRequest",
     "__version__",
+    "parse_webhook_event",
     "poll_workflow_result",
 ]

{linkedapi-1.0.1 → linkedapi-1.1.0}/linkedapi/admin/__init__.py

@@ -3,11 +3,13 @@ from linkedapi.admin.admin import LinkedApiAdmin
 from linkedapi.admin.http_client import AdminHttpClient
 from linkedapi.admin.limits import AdminLimits
 from linkedapi.admin.subscription import AdminSubscription
+from linkedapi.admin.webhooks import AdminWebhooks
 
 __all__ = [
     "AdminAccounts",
     "AdminHttpClient",
     "AdminLimits",
     "AdminSubscription",
+    "AdminWebhooks",
     "LinkedApiAdmin",
 ]

{linkedapi-1.0.1 → linkedapi-1.1.0}/linkedapi/admin/accounts.py

@@ -11,10 +11,14 @@ from linkedapi.types.admin import (
     CancelConnectionSessionParams,
     ConnectionSessionResult,
     CreateConnectionSessionResult,
+    CreateReconnectionSessionParams,
+    CreateReconnectionSessionResult,
     DisconnectParams,
     GetConnectionSessionParams,
     RegenerateTokenParams,
     RegenerateTokenResult,
+    ReparseAccountInfoParams,
+    ReparseAccountInfoResult,
 )
 
 TModel = TypeVar("TModel", bound=BaseModel)
@@ -30,6 +34,14 @@ class AdminAccounts:
     def disconnect(self, params: DisconnectParams) -> None:
         self._post_void("/admin/accounts.disconnect", "Failed to disconnect account", params)
 
+    def reparse_account_info(self, params: ReparseAccountInfoParams) -> ReparseAccountInfoResult:
+        return self._post_result(
+            "/admin/accounts.reparseAccountInfo",
+            ReparseAccountInfoResult,
+            "Failed to reparse account info",
+            params,
+        )
+
     def regenerate_identification_token(
         self,
         params: RegenerateTokenParams,
@@ -48,6 +60,17 @@ class AdminAccounts:
             "Failed to create connection session",
         )
 
+    def create_reconnection_session(
+        self,
+        params: CreateReconnectionSessionParams,
+    ) -> CreateReconnectionSessionResult:
+        return self._post_result(
+            "/admin/accounts.createReconnectionSession",
+            CreateReconnectionSessionResult,
+            "Failed to create reconnection session",
+            params,
+        )
+
     def get_connection_session(
         self,
         params: GetConnectionSessionParams,

{linkedapi-1.0.1 → linkedapi-1.1.0}/linkedapi/admin/admin.py

@@ -6,12 +6,13 @@ from linkedapi.admin.accounts import AdminAccounts
 from linkedapi.admin.http_client import AdminHttpClient
 from linkedapi.admin.limits import AdminLimits
 from linkedapi.admin.subscription import AdminSubscription
+from linkedapi.admin.webhooks import AdminWebhooks
 from linkedapi.http import HttpClient
 from linkedapi.types.admin import AdminConfig
 
 
 class LinkedApiAdmin:
-    """Admin SDK for Linked API subscription, account, and limit management."""
+    """Admin SDK for Linked API subscription, account, limit, and webhook management."""
 
     def __init__(self, config: AdminConfig | HttpClient[Any]) -> None:
         http_client = (
@@ -20,3 +21,4 @@ class LinkedApiAdmin:
         self.subscription = AdminSubscription(http_client)
         self.accounts = AdminAccounts(http_client)
         self.limits = AdminLimits(http_client)
+        self.webhooks = AdminWebhooks(http_client)

{linkedapi-1.0.1 → linkedapi-1.1.0}/linkedapi/admin/subscription.py

@@ -7,11 +7,8 @@ from pydantic import BaseModel
 from linkedapi.errors import LinkedApiError
 from linkedapi.http import HttpClient
 from linkedapi.types.admin import (
-    BillingLinkResult,
-    CancelResult,
     SetSeatsParams,
     SetSeatsResult,
-    SubscriptionPricingResult,
     SubscriptionSeatsResult,
     SubscriptionStatus,
 )
@@ -33,26 +30,11 @@ class AdminSubscription:
             "/admin/subscription.getSeats", SubscriptionSeatsResult, "Failed to get seats"
         )
 
-    def get_pricing(self) -> SubscriptionPricingResult:
-        return self._post_result(
-            "/admin/subscription.getPricing", SubscriptionPricingResult, "Failed to get pricing"
-        )
-
     def set_seats(self, params: SetSeatsParams) -> SetSeatsResult:
         return self._post_result(
             "/admin/subscription.setSeats", SetSeatsResult, "Failed to set seats", params
         )
 
-    def get_billing_link(self) -> BillingLinkResult:
-        return self._post_result(
-            "/admin/subscription.getBillingLink", BillingLinkResult, "Failed to get billing link"
-        )
-
-    def cancel(self) -> CancelResult:
-        return self._post_result(
-            "/admin/subscription.cancel", CancelResult, "Failed to cancel subscription"
-        )
-
     def _post_result(
         self,
         path: str,

linkedapi-1.1.0/linkedapi/admin/webhooks.py

@@ -0,0 +1,82 @@
+from __future__ import annotations
+
+from typing import Any
+
+from linkedapi.errors import LinkedApiError
+from linkedapi.http import HttpClient
+from linkedapi.types.webhooks import (
+    DeleteWebhookParams,
+    ReplayWebhookDeliveryParams,
+    SetWebhookParams,
+    SetWebhookPayloadModeParams,
+    WebhookDelivery,
+    WebhookSubscription,
+)
+
+
+class AdminWebhooks:
+    """Manage the client's registered outbound webhook and inspect recent deliveries.
+
+    A client may hold at most one active webhook. It receives every event Linked API emits
+    (workflow lifecycle + account status changes); filter by the event ``type`` on your receiver.
+    """
+
+    def __init__(self, http_client: HttpClient[Any]) -> None:
+        self.http_client = http_client
+
+    def set(self, params: SetWebhookParams) -> WebhookSubscription:
+        result = self._post_result("/admin/webhook.set", "Failed to set webhook", params)
+        return WebhookSubscription.model_validate(result["webhook"])
+
+    def get(self) -> list[WebhookSubscription]:
+        result = self._post_result("/admin/webhook.get", "Failed to get webhooks")
+        return [WebhookSubscription.model_validate(item) for item in result["webhooks"]]
+
+    def set_payload_mode(self, params: SetWebhookPayloadModeParams) -> WebhookSubscription:
+        result = self._post_result(
+            "/admin/webhook.setPayloadMode",
+            "Failed to set webhook payload mode",
+            params,
+        )
+        return WebhookSubscription.model_validate(result["webhook"])
+
+    def delete(self, params: DeleteWebhookParams) -> None:
+        self._post_void("/admin/webhook.delete", "Failed to delete webhook", params)
+
+    def deliveries(self) -> list[WebhookDelivery]:
+        result = self._post_result("/admin/webhook.deliveries", "Failed to get webhook deliveries")
+        return [WebhookDelivery.model_validate(item) for item in result["deliveries"]]
+
+    def replay_delivery(self, params: ReplayWebhookDeliveryParams) -> None:
+        self._post_void(
+            "/admin/webhook.replayDelivery",
+            "Failed to replay webhook delivery",
+            params,
+        )
+
+    def send_test(self) -> None:
+        self._post_void("/admin/webhook.sendTest", "Failed to send test webhook")
+
+    def _post_result(
+        self,
+        path: str,
+        default_message: str,
+        params: Any | None = None,
+    ) -> dict[str, Any]:
+        response = self.http_client.post(path, params)
+        if response.success and response.result is not None:
+            result: dict[str, Any] = response.result
+            return result
+        raise LinkedApiError(
+            response.error.type if response.error else "httpError",
+            response.error.message if response.error else default_message,
+        )
+
+    def _post_void(self, path: str, default_message: str, params: Any | None = None) -> None:
+        response = self.http_client.post(path, params)
+        if response.success:
+            return
+        raise LinkedApiError(
+            response.error.type if response.error else "httpError",
+            response.error.message if response.error else default_message,
+        )

{linkedapi-1.0.1 → linkedapi-1.1.0}/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.1.0}/linkedapi/errors.py

@@ -9,6 +9,8 @@ LinkedApiActionErrorType = Literal[
     "alreadyPending",
     "alreadyConnected",
     "emailRequired",
+    "noteTooLong",
+    "noteLimitExceeded",
     "requestNotAllowed",
     "notPending",
     "retrievingNotAllowed",
@@ -16,6 +18,7 @@ LinkedApiActionErrorType = Literal[
     "searchingNotAllowed",
     "companyNotFound",
     "postNotFound",
+    "jobNotFound",
     "commentingNotAllowed",
     "noPostingPermission",
     "noSalesNavigator",
@@ -28,6 +31,8 @@ LINKED_API_ACTION_ERROR_TYPES: tuple[str, ...] = (
     "alreadyPending",
     "alreadyConnected",
     "emailRequired",
+    "noteTooLong",
+    "noteLimitExceeded",
     "requestNotAllowed",
     "notPending",
     "retrievingNotAllowed",
@@ -35,6 +40,7 @@ LINKED_API_ACTION_ERROR_TYPES: tuple[str, ...] = (
     "searchingNotAllowed",
     "companyNotFound",
     "postNotFound",
+    "jobNotFound",
     "commentingNotAllowed",
     "noPostingPermission",
     "noSalesNavigator",

{linkedapi-1.0.1 → linkedapi-1.1.0}/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.1.0/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.1.0/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.1.0}/linkedapi/types/__init__.py

@@ -4,15 +4,14 @@ from linkedapi.types.admin import (
     AdminAccount,
     AdminAccountStatus,
     AdminConfig,
-    BillingLinkResult,
     BillingPeriod,
     CancelConnectionSessionParams,
-    CancelResult,
     ConnectionSession,
     ConnectionSessionResult,
     ConnectionSessionStatus,
     CreateConnectionSessionResult,
-    Currency,
+    CreateReconnectionSessionParams,
+    CreateReconnectionSessionResult,
     DeleteLimitEntry,
     DeleteLimitsParams,
     DisconnectParams,
@@ -28,6 +27,8 @@ from linkedapi.types.admin import (
     PendingConnectionSession,
     RegenerateTokenParams,
     RegenerateTokenResult,
+    ReparseAccountInfoParams,
+    ReparseAccountInfoResult,
     ResetLimitsParams,
     SeatType,
     SetLimitEntry,
@@ -35,8 +36,6 @@ from linkedapi.types.admin import (
     SetSeatsParams,
     SetSeatsResult,
     SetSeatsStatus,
-    SubscriptionPricingResult,
-    SubscriptionProduct,
     SubscriptionSeat,
     SubscriptionSeatsResult,
     SubscriptionStatus,
@@ -83,6 +82,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,
@@ -164,6 +178,26 @@ from linkedapi.types.statistics import (
     RetrievePerformanceResult,
     RetrieveSSIResult,
 )
+from linkedapi.types.webhooks import (
+    AccountWebhookEvent,
+    AccountWebhookEventData,
+    AccountWebhookStatus,
+    DeleteWebhookParams,
+    ReplayWebhookDeliveryParams,
+    SetWebhookParams,
+    SetWebhookPayloadModeParams,
+    WebhookDelivery,
+    WebhookDeliveryStatus,
+    WebhookEvent,
+    WebhookEventType,
+    WebhookPayloadMode,
+    WebhookSubscription,
+    WebhookTestEvent,
+    WebhookTestEventData,
+    WorkflowWebhookEvent,
+    WorkflowWebhookEventData,
+    WorkflowWebhookStatus,
+)
 from linkedapi.types.workflow import (
     LinkedApiActionError,
     WorkflowCancelResponse,
@@ -180,6 +214,9 @@ from linkedapi.types.workflow import (
 
 __all__ = [
     "AccountInfo",
+    "AccountWebhookEvent",
+    "AccountWebhookEventData",
+    "AccountWebhookStatus",
     "AccountsResult",
     "AdminAccount",
     "AdminAccountStatus",
@@ -195,10 +232,8 @@ __all__ = [
     "BaseFetchPersonParamsWide",
     "BaseFetchPostParams",
     "BaseFetchPostParamsWide",
-    "BillingLinkResult",
     "BillingPeriod",
     "CancelConnectionSessionParams",
-    "CancelResult",
     "CheckConnectionStatusParams",
     "CheckConnectionStatusResult",
     "Comment",
@@ -216,13 +251,17 @@ __all__ = [
     "CreatePostAttachment",
     "CreatePostParams",
     "CreatePostResult",
-    "Currency",
+    "CreateReconnectionSessionParams",
+    "CreateReconnectionSessionResult",
     "DeleteLimitEntry",
     "DeleteLimitsParams",
+    "DeleteWebhookParams",
     "DisconnectParams",
     "EmploymentType",
     "FetchCompanyParams",
     "FetchCompanyResult",
+    "FetchJobParams",
+    "FetchJobResult",
     "FetchPersonParams",
     "FetchPersonResult",
     "FetchPostParams",
@@ -230,6 +269,13 @@ __all__ = [
     "GetConnectionSessionParams",
     "GetLimitsParams",
     "GetLimitsUsageParams",
+    "Job",
+    "JobCurrency",
+    "JobDatePosted",
+    "JobEmploymentType",
+    "JobExperienceLevel",
+    "JobSalary",
+    "JobWorkplaceType",
     "LanguageProficiency",
     "Limit",
     "LimitCategory",
@@ -291,6 +337,9 @@ __all__ = [
     "RegenerateTokenParams",
     "RegenerateTokenResult",
     "RemoveConnectionParams",
+    "ReparseAccountInfoParams",
+    "ReparseAccountInfoResult",
+    "ReplayWebhookDeliveryParams",
     "ResetLimitsParams",
     "RetrieveConnectionsFilter",
     "RetrieveConnectionsParams",
@@ -298,10 +347,14 @@ __all__ = [
     "RetrievePendingRequestsResult",
     "RetrievePerformanceResult",
     "RetrieveSSIResult",
+    "SalaryPeriod",
     "SearchCompaniesFilter",
     "SearchCompaniesParams",
     "SearchCompanyResult",
     "SearchCompanySize",
+    "SearchJobResult",
+    "SearchJobsFilter",
+    "SearchJobsParams",
     "SearchPeopleFilter",
     "SearchPeopleParams",
     "SearchPeopleResult",
@@ -313,17 +366,25 @@ __all__ = [
     "SetSeatsParams",
     "SetSeatsResult",
     "SetSeatsStatus",
+    "SetWebhookParams",
+    "SetWebhookPayloadModeParams",
     "StCompanyDm",
     "StCompanyEmployee",
     "StCompanyEmployeesFilter",
     "StCompanyEmployeesRetrievalConfig",
-    "SubscriptionPricingResult",
-    "SubscriptionProduct",
     "SubscriptionSeat",
     "SubscriptionSeatsResult",
     "SubscriptionStatus",
     "SubscriptionStatusValue",
     "SyncConversationParams",
+    "WebhookDelivery",
+    "WebhookDeliveryStatus",
+    "WebhookEvent",
+    "WebhookEventType",
+    "WebhookPayloadMode",
+    "WebhookSubscription",
+    "WebhookTestEvent",
+    "WebhookTestEventData",
     "WithdrawConnectionRequestParams",
     "WorkflowCancelResponse",
     "WorkflowCompletion",
@@ -335,6 +396,9 @@ __all__ = [
     "WorkflowResponse",
     "WorkflowStartedResponse",
     "WorkflowStatus",
+    "WorkflowWebhookEvent",
+    "WorkflowWebhookEventData",
+    "WorkflowWebhookStatus",
     "YearsOfExperience",
     "dump_model_by_name",
     "serialize_model",