getanyapi 0.92.0__tar.gz → 0.93.0__tar.gz

{getanyapi-0.92.0 → getanyapi-0.93.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: getanyapi
-Version: 0.92.0
+Version: 0.93.0
 Summary: Official typed Python SDK for AnyAPI: any API, one wallet, USD, no subscriptions.
 Project-URL: Homepage, https://getanyapi.com
 Project-URL: Documentation, https://getanyapi.com/docs

{getanyapi-0.92.0 → getanyapi-0.93.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "getanyapi"
-version = "0.92.0"
+version = "0.93.0"
 description = "Official typed Python SDK for AnyAPI: any API, one wallet, USD, no subscriptions."
 readme = "README.md"
 requires-python = ">=3.10"

{getanyapi-0.92.0 → getanyapi-0.93.0}/src/getanyapi/__init__.py

@@ -55,7 +55,7 @@ from .types import (
     unwrap,
 )
 
-__version__ = "0.92.0"
+__version__ = "0.93.0"
 
 __all__ = [
     # clients + top-level functions

{getanyapi-0.92.0 → getanyapi-0.93.0}/src/getanyapi/platforms/linkedin.py

@@ -257,6 +257,8 @@ class LinkedinJobsInput(TypedDict, total=False):
     """Optional, default true. When false, only the sources listed in `source` may serve; the request is refused with no charge if none of them can. When true, the listed sources are tried first and any other source may serve after them, at the normal price. Default: true."""
     company: NotRequired[str]
     """Filter to a specific company by name (e.g. Google)."""
+    cursor: NotRequired[str]
+    """Opaque pagination cursor from a previous response's nextCursor. Omit for the first page; pass it to fetch the next page of job listings."""
     easyApply: NotRequired[bool]
     """When true, only return jobs offering LinkedIn Easy Apply."""
     employmentType: NotRequired[
@@ -272,7 +274,7 @@ class LinkedinJobsInput(TypedDict, total=False):
     ignoreSources: NotRequired[list[str]]
     """Optional. Source ids to skip for this request, taken from this endpoint's `lanes[].source.id`. The cheapest remaining source serves and the price is that of the dearest remaining source. An id that does not serve this endpoint, or that is also in `source`, is rejected as invalid input with no charge; skipping every source is rejected the same way."""
     limit: NotRequired[int]
-    """Maximum number of results to return (1-25, default 25). You are billed per result returned, so a lower limit costs less. Range: 1 to 25."""
+    """Accepted for compatibility and ignored: each call returns one full page of up to 25 jobs at one flat price per call; follow nextCursor for more. Range: 1 to 25."""
     location: NotRequired[str]
     """City, region, or country to search within (e.g. United States, San Francisco)."""
     postedLimit: NotRequired[Literal["1h", "24h", "week", "month"]]
@@ -304,6 +306,8 @@ class LinkedinJobsThinInput(TypedDict, total=False):
     """Optional, default true. When false, only the sources listed in `source` may serve; the request is refused with no charge if none of them can. When true, the listed sources are tried first and any other source may serve after them, at the normal price. Default: true."""
     companyId: NotRequired[str]
     """Filter to a specific company by its LinkedIn numeric company id."""
+    cursor: NotRequired[str]
+    """Opaque pagination cursor from a previous response's nextCursor. Omit for the first page; pass it to fetch the next page of job listings."""
     employmentType: NotRequired[
         Literal["full-time", "part-time", "contract", "internship", "temporary"]
     ]
@@ -319,7 +323,7 @@ class LinkedinJobsThinInput(TypedDict, total=False):
     ignoreSources: NotRequired[list[str]]
     """Optional. Source ids to skip for this request, taken from this endpoint's `lanes[].source.id`. The cheapest remaining source serves and the price is that of the dearest remaining source. An id that does not serve this endpoint, or that is also in `source`, is rejected as invalid input with no charge; skipping every source is rejected the same way."""
     limit: NotRequired[int]
-    """Maximum number of results to return (1-25, default 25). Range: 1 to 25."""
+    """Accepted for compatibility and ignored: each call returns one full source page (10 or 25 jobs depending on source); follow nextCursor for more. Range: 1 to 25."""
     location: NotRequired[str]
     """City, region, or country to search within."""
     postedLimit: NotRequired[Literal["24h", "week", "month"]]
@@ -2105,9 +2109,16 @@ class LinkedinJobSalary(BaseModel):
 
 
 class LinkedinJobsData(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
     items: list[LinkedinJobsItem] = Field(
         description="Full job listing records for the search. Populated whenever the provider has data for the entity."
     )
+    next_cursor: str | None = Field(
+        default=None,
+        alias="nextCursor",
+        description="Opaque cursor for the next page of job listings, or null when there are no more. Pass it back as cursor to continue.",
+    )
 
 
 class LinkedinJobsItem(BaseModel):
@@ -2248,9 +2259,16 @@ class LinkedinJobsSalary(BaseModel):
 
 
 class LinkedinJobsThinData(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
     items: list[LinkedinJobsThinItem] = Field(
         description="Job listing index records for the search. Populated whenever the provider has data for the entity."
     )
+    next_cursor: str | None = Field(
+        default=None,
+        alias="nextCursor",
+        description="Opaque cursor for the next page of job listings, or null when there are no more. Pass it back as cursor to continue.",
+    )
 
 
 class LinkedinJobsThinItem(BaseModel):
@@ -4630,7 +4648,7 @@ class LinkedinNamespace:
         description, salary, applicant count, seniority, company details, and
         benefits. Up to 25 jobs per request.
 
-        Price: $0.0011 per request plus $0.0011 per result (maximum $0.0286).
+        Price: $0.0286 per request plus $0 per result (maximum $0.0286).
 
         Example:
             res = client.linkedin.jobs(limit=3, location="United States", query="software engineer", workplaceType="remote")
@@ -4640,6 +4658,29 @@ class LinkedinNamespace:
         )
         return RunResult[LinkedinJobsData].model_validate(raw)
 
+    def iter_jobs(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[LinkedinJobsInput],
+    ) -> Paginator[LinkedinJobsItem, LinkedinJobsData]:
+        """Iterate LinkedIn Jobs results, following pagination cursors.
+
+        Yields validated `LinkedinJobsItem` items from the `items` field of
+        each page. Use `.pages()` on the returned paginator to walk whole
+        `RunResult` pages.
+        """
+        return paginate(
+            self._client,
+            "linkedin.jobs",
+            dict(input),
+            "items",
+            item_model=LinkedinJobsItem,
+            data_model=LinkedinJobsData,
+            bare=False,
+            options=options,
+        )
+
     def jobs_thin(
         self,
         *,
@@ -4661,6 +4702,29 @@ class LinkedinNamespace:
         )
         return RunResult[LinkedinJobsThinData].model_validate(raw)
 
+    def iter_jobs_thin(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[LinkedinJobsThinInput],
+    ) -> Paginator[LinkedinJobsThinItem, LinkedinJobsThinData]:
+        """Iterate LinkedIn Jobs (index) results, following pagination cursors.
+
+        Yields validated `LinkedinJobsThinItem` items from the `items` field of
+        each page. Use `.pages()` on the returned paginator to walk whole
+        `RunResult` pages.
+        """
+        return paginate(
+            self._client,
+            "linkedin.jobs_thin",
+            dict(input),
+            "items",
+            item_model=LinkedinJobsThinItem,
+            data_model=LinkedinJobsThinData,
+            bare=False,
+            options=options,
+        )
+
     def post(
         self,
         *,
@@ -5397,7 +5461,7 @@ class AsyncLinkedinNamespace:
         description, salary, applicant count, seniority, company details, and
         benefits. Up to 25 jobs per request.
 
-        Price: $0.0011 per request plus $0.0011 per result (maximum $0.0286).
+        Price: $0.0286 per request plus $0 per result (maximum $0.0286).
 
         Example:
             res = client.linkedin.jobs(limit=3, location="United States", query="software engineer", workplaceType="remote")
@@ -5407,6 +5471,29 @@ class AsyncLinkedinNamespace:
         )
         return RunResult[LinkedinJobsData].model_validate(raw)
 
+    def iter_jobs(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[LinkedinJobsInput],
+    ) -> AsyncPaginator[LinkedinJobsItem, LinkedinJobsData]:
+        """Iterate LinkedIn Jobs results, following pagination cursors.
+
+        Yields validated `LinkedinJobsItem` items from the `items` field of
+        each page. Use `.pages()` on the returned paginator to walk whole
+        `RunResult` pages.
+        """
+        return apaginate(
+            self._client,
+            "linkedin.jobs",
+            dict(input),
+            "items",
+            item_model=LinkedinJobsItem,
+            data_model=LinkedinJobsData,
+            bare=False,
+            options=options,
+        )
+
     async def jobs_thin(
         self,
         *,
@@ -5428,6 +5515,29 @@ class AsyncLinkedinNamespace:
         )
         return RunResult[LinkedinJobsThinData].model_validate(raw)
 
+    def iter_jobs_thin(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[LinkedinJobsThinInput],
+    ) -> AsyncPaginator[LinkedinJobsThinItem, LinkedinJobsThinData]:
+        """Iterate LinkedIn Jobs (index) results, following pagination cursors.
+
+        Yields validated `LinkedinJobsThinItem` items from the `items` field of
+        each page. Use `.pages()` on the returned paginator to walk whole
+        `RunResult` pages.
+        """
+        return apaginate(
+            self._client,
+            "linkedin.jobs_thin",
+            dict(input),
+            "items",
+            item_model=LinkedinJobsThinItem,
+            data_model=LinkedinJobsThinData,
+            bare=False,
+            options=options,
+        )
+
     async def post(
         self,
         *,