nimble_python 0.18.0__py3-none-any.whl → 0.19.0__py3-none-any.whl

nimble_python/_client.py

@@ -61,7 +61,7 @@ from .types.extract_async_response import ExtractAsyncResponse
 from .types.extract_batch_response import ExtractBatchResponse
 
 if TYPE_CHECKING:
-    from .resources import serp, agent, crawl, media, tasks, batches, domain_knowledge
+    from .resources import serp, agent, crawl, media, tasks, batches, task_agent, domain_knowledge
     from .resources.serp import SerpResource, AsyncSerpResource
     from .resources.agent import AgentResource, AsyncAgentResource
     from .resources.crawl import CrawlResource, AsyncCrawlResource
@@ -69,6 +69,7 @@ if TYPE_CHECKING:
     from .resources.tasks import TasksResource, AsyncTasksResource
     from .resources.batches import BatchesResource, AsyncBatchesResource
     from .resources.domain_knowledge import DomainKnowledgeResource, AsyncDomainKnowledgeResource
+    from .resources.task_agent.task_agent import TaskAgentResource, AsyncTaskAgentResource
 
 __all__ = ["Timeout", "Transport", "ProxiesTypes", "RequestOptions", "Nimble", "AsyncNimble", "Client", "AsyncClient"]
 
@@ -183,6 +184,12 @@ class Nimble(SyncAPIClient):
 
         return SerpResource(self)
 
+    @cached_property
+    def task_agent(self) -> TaskAgentResource:
+        from .resources.task_agent import TaskAgentResource
+
+        return TaskAgentResource(self)
+
     @cached_property
     def with_raw_response(self) -> NimbleWithRawResponse:
         return NimbleWithRawResponse(self)
@@ -280,6 +287,7 @@ class Nimble(SyncAPIClient):
         self,
         *,
         url: str,
+        body: object | Omit = omit,
         browser: client_extract_params.Browser | Omit = omit,
         browser_actions: Iterable[client_extract_params.BrowserAction] | Omit = omit,
         city: str | Omit = omit,
@@ -1169,6 +1177,8 @@ class Nimble(SyncAPIClient):
         Args:
           url: Target URL to scrape
 
+          body: Request body for POST, PUT, PATCH methods
+
           browser: Browser type to emulate
 
           browser_actions: Array of browser automation actions to execute sequentially
@@ -1236,6 +1246,7 @@ class Nimble(SyncAPIClient):
             body=maybe_transform(
                 {
                     "url": url,
+                    "body": body,
                     "browser": browser,
                     "browser_actions": browser_actions,
                     "city": city,
@@ -1276,6 +1287,7 @@ class Nimble(SyncAPIClient):
         self,
         *,
         url: str,
+        body: object | Omit = omit,
         browser: client_extract_async_params.Browser | Omit = omit,
         browser_actions: Iterable[client_extract_async_params.BrowserAction] | Omit = omit,
         callback_url: str | Omit = omit,
@@ -2170,6 +2182,8 @@ class Nimble(SyncAPIClient):
         Args:
           url: Target URL to scrape
 
+          body: Request body for POST, PUT, PATCH methods
+
           browser: Browser type to emulate
 
           browser_actions: Array of browser automation actions to execute sequentially
@@ -2247,6 +2261,7 @@ class Nimble(SyncAPIClient):
             body=maybe_transform(
                 {
                     "url": url,
+                    "body": body,
                     "browser": browser,
                     "browser_actions": browser_actions,
                     "callback_url": callback_url,
@@ -3186,6 +3201,7 @@ class Nimble(SyncAPIClient):
         query: str,
         content_type: Optional[SequenceNotStr[str]] | Omit = omit,
         country: str | Omit = omit,
+        debug_params: Optional[Dict[str, object]] | Omit = omit,
         deep_search: Optional[bool] | Omit = omit,
         end_date: Optional[str] | Omit = omit,
         exclude_domains: Optional[SequenceNotStr[str]] | Omit = omit,
@@ -3218,6 +3234,8 @@ class Nimble(SyncAPIClient):
 
           country: Country code for geo-targeted results (e.g., 'US', 'GB', 'IL')
 
+          debug_params: Internal-only. Gated to allowlisted accounts; ignored otherwise.
+
           deep_search: Deprecated. Use search_depth instead. true maps to 'deep', false maps to 'lite'.
 
           end_date: Filter results before this date (format: YYYY-MM-DD or YYYY)
@@ -3267,6 +3285,7 @@ class Nimble(SyncAPIClient):
                     "query": query,
                     "content_type": content_type,
                     "country": country,
+                    "debug_params": debug_params,
                     "deep_search": deep_search,
                     "end_date": end_date,
                     "exclude_domains": exclude_domains,
@@ -3433,6 +3452,12 @@ class AsyncNimble(AsyncAPIClient):
 
         return AsyncSerpResource(self)
 
+    @cached_property
+    def task_agent(self) -> AsyncTaskAgentResource:
+        from .resources.task_agent import AsyncTaskAgentResource
+
+        return AsyncTaskAgentResource(self)
+
     @cached_property
     def with_raw_response(self) -> AsyncNimbleWithRawResponse:
         return AsyncNimbleWithRawResponse(self)
@@ -3530,6 +3555,7 @@ class AsyncNimble(AsyncAPIClient):
         self,
         *,
         url: str,
+        body: object | Omit = omit,
         browser: client_extract_params.Browser | Omit = omit,
         browser_actions: Iterable[client_extract_params.BrowserAction] | Omit = omit,
         city: str | Omit = omit,
@@ -4419,6 +4445,8 @@ class AsyncNimble(AsyncAPIClient):
         Args:
           url: Target URL to scrape
 
+          body: Request body for POST, PUT, PATCH methods
+
           browser: Browser type to emulate
 
           browser_actions: Array of browser automation actions to execute sequentially
@@ -4486,6 +4514,7 @@ class AsyncNimble(AsyncAPIClient):
             body=await async_maybe_transform(
                 {
                     "url": url,
+                    "body": body,
                     "browser": browser,
                     "browser_actions": browser_actions,
                     "city": city,
@@ -4526,6 +4555,7 @@ class AsyncNimble(AsyncAPIClient):
         self,
         *,
         url: str,
+        body: object | Omit = omit,
         browser: client_extract_async_params.Browser | Omit = omit,
         browser_actions: Iterable[client_extract_async_params.BrowserAction] | Omit = omit,
         callback_url: str | Omit = omit,
@@ -5420,6 +5450,8 @@ class AsyncNimble(AsyncAPIClient):
         Args:
           url: Target URL to scrape
 
+          body: Request body for POST, PUT, PATCH methods
+
           browser: Browser type to emulate
 
           browser_actions: Array of browser automation actions to execute sequentially
@@ -5497,6 +5529,7 @@ class AsyncNimble(AsyncAPIClient):
             body=await async_maybe_transform(
                 {
                     "url": url,
+                    "body": body,
                     "browser": browser,
                     "browser_actions": browser_actions,
                     "callback_url": callback_url,
@@ -6436,6 +6469,7 @@ class AsyncNimble(AsyncAPIClient):
         query: str,
         content_type: Optional[SequenceNotStr[str]] | Omit = omit,
         country: str | Omit = omit,
+        debug_params: Optional[Dict[str, object]] | Omit = omit,
         deep_search: Optional[bool] | Omit = omit,
         end_date: Optional[str] | Omit = omit,
         exclude_domains: Optional[SequenceNotStr[str]] | Omit = omit,
@@ -6468,6 +6502,8 @@ class AsyncNimble(AsyncAPIClient):
 
           country: Country code for geo-targeted results (e.g., 'US', 'GB', 'IL')
 
+          debug_params: Internal-only. Gated to allowlisted accounts; ignored otherwise.
+
           deep_search: Deprecated. Use search_depth instead. true maps to 'deep', false maps to 'lite'.
 
           end_date: Filter results before this date (format: YYYY-MM-DD or YYYY)
@@ -6517,6 +6553,7 @@ class AsyncNimble(AsyncAPIClient):
                     "query": query,
                     "content_type": content_type,
                     "country": country,
+                    "debug_params": debug_params,
                     "deep_search": deep_search,
                     "end_date": end_date,
                     "exclude_domains": exclude_domains,
@@ -6637,6 +6674,12 @@ class NimbleWithRawResponse:
 
         return SerpResourceWithRawResponse(self._client.serp)
 
+    @cached_property
+    def task_agent(self) -> task_agent.TaskAgentResourceWithRawResponse:
+        from .resources.task_agent import TaskAgentResourceWithRawResponse
+
+        return TaskAgentResourceWithRawResponse(self._client.task_agent)
+
 
 class AsyncNimbleWithRawResponse:
     _client: AsyncNimble
@@ -6702,6 +6745,12 @@ class AsyncNimbleWithRawResponse:
 
         return AsyncSerpResourceWithRawResponse(self._client.serp)
 
+    @cached_property
+    def task_agent(self) -> task_agent.AsyncTaskAgentResourceWithRawResponse:
+        from .resources.task_agent import AsyncTaskAgentResourceWithRawResponse
+
+        return AsyncTaskAgentResourceWithRawResponse(self._client.task_agent)
+
 
 class NimbleWithStreamedResponse:
     _client: Nimble
@@ -6767,6 +6816,12 @@ class NimbleWithStreamedResponse:
 
         return SerpResourceWithStreamingResponse(self._client.serp)
 
+    @cached_property
+    def task_agent(self) -> task_agent.TaskAgentResourceWithStreamingResponse:
+        from .resources.task_agent import TaskAgentResourceWithStreamingResponse
+
+        return TaskAgentResourceWithStreamingResponse(self._client.task_agent)
+
 
 class AsyncNimbleWithStreamedResponse:
     _client: AsyncNimble
@@ -6832,6 +6887,12 @@ class AsyncNimbleWithStreamedResponse:
 
         return AsyncSerpResourceWithStreamingResponse(self._client.serp)
 
+    @cached_property
+    def task_agent(self) -> task_agent.AsyncTaskAgentResourceWithStreamingResponse:
+        from .resources.task_agent import AsyncTaskAgentResourceWithStreamingResponse
+
+        return AsyncTaskAgentResourceWithStreamingResponse(self._client.task_agent)
+
 
 Client = Nimble
 

nimble_python/_models.py

@@ -25,7 +25,9 @@ from typing_extensions import (
     ClassVar,
     Protocol,
     Required,
+    Annotated,
     ParamSpec,
+    TypeAlias,
     TypedDict,
     TypeGuard,
     final,
@@ -79,7 +81,15 @@ from ._compat import (
 from ._constants import RAW_RESPONSE_HEADER
 
 if TYPE_CHECKING:
+    from pydantic import GetCoreSchemaHandler, ValidatorFunctionWrapHandler
+    from pydantic_core import CoreSchema, core_schema
     from pydantic_core.core_schema import ModelField, ModelSchema, LiteralSchema, ModelFieldsSchema
+else:
+    try:
+        from pydantic_core import CoreSchema, core_schema
+    except ImportError:
+        CoreSchema = None
+        core_schema = None
 
 __all__ = ["BaseModel", "GenericModel"]
 
@@ -396,6 +406,76 @@ class BaseModel(pydantic.BaseModel):
             )
 
 
+class _EagerIterable(list[_T], Generic[_T]):
+    """
+    Accepts any Iterable[T] input (including generators), consumes it
+    eagerly, and validates all items upfront.
+
+    Validation preserves the original container type where possible
+    (e.g. a set[T] stays a set[T]).  Serialization (model_dump / JSON)
+    always emits a list — round-tripping through model_dump() will not
+    restore the original container type.
+    """
+
+    @classmethod
+    def __get_pydantic_core_schema__(
+        cls,
+        source_type: Any,
+        handler: GetCoreSchemaHandler,
+    ) -> CoreSchema:
+        (item_type,) = get_args(source_type) or (Any,)
+        item_schema: CoreSchema = handler.generate_schema(item_type)
+        list_of_items_schema: CoreSchema = core_schema.list_schema(item_schema)
+
+        return core_schema.no_info_wrap_validator_function(
+            cls._validate,
+            list_of_items_schema,
+            serialization=core_schema.plain_serializer_function_ser_schema(
+                cls._serialize,
+                info_arg=False,
+            ),
+        )
+
+    @staticmethod
+    def _validate(v: Iterable[_T], handler: "ValidatorFunctionWrapHandler") -> Any:
+        original_type: type[Any] = type(v)
+
+        # Normalize to list so list_schema can validate each item
+        if isinstance(v, list):
+            items: list[_T] = v
+        else:
+            try:
+                items = list(v)
+            except TypeError as e:
+                raise TypeError("Value is not iterable") from e
+
+        # Validate items against the inner schema
+        validated: list[_T] = handler(items)
+
+        # Reconstruct original container type
+        if original_type is list:
+            return validated
+        # str(list) produces the list's repr, not a string built from items,
+        # so skip reconstruction for str and its subclasses.
+        if issubclass(original_type, str):
+            return validated
+        try:
+            return original_type(validated)
+        except (TypeError, ValueError):
+            # If the type cannot be reconstructed, just return the validated list
+            return validated
+
+    @staticmethod
+    def _serialize(v: Iterable[_T]) -> list[_T]:
+        """Always serialize as a list so Pydantic's JSON encoder is happy."""
+        if isinstance(v, list):
+            return v
+        return list(v)
+
+
+EagerIterable: TypeAlias = Annotated[Iterable[_T], _EagerIterable]
+
+
 def _construct_field(value: object, field: FieldInfo, key: str) -> object:
     if value is None:
         return field_get_default(field)

nimble_python/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "nimble_python"
-__version__ = "0.18.0"  # x-release-please-version
+__version__ = "0.19.0"  # x-release-please-version

nimble_python/resources/__init__.py

@@ -48,6 +48,14 @@ from .batches import (
     BatchesResourceWithStreamingResponse,
     AsyncBatchesResourceWithStreamingResponse,
 )
+from .task_agent import (
+    TaskAgentResource,
+    AsyncTaskAgentResource,
+    TaskAgentResourceWithRawResponse,
+    AsyncTaskAgentResourceWithRawResponse,
+    TaskAgentResourceWithStreamingResponse,
+    AsyncTaskAgentResourceWithStreamingResponse,
+)
 from .domain_knowledge import (
     DomainKnowledgeResource,
     AsyncDomainKnowledgeResource,
@@ -100,4 +108,10 @@ __all__ = [
     "AsyncSerpResourceWithRawResponse",
     "SerpResourceWithStreamingResponse",
     "AsyncSerpResourceWithStreamingResponse",
+    "TaskAgentResource",
+    "AsyncTaskAgentResource",
+    "TaskAgentResourceWithRawResponse",
+    "AsyncTaskAgentResourceWithRawResponse",
+    "TaskAgentResourceWithStreamingResponse",
+    "AsyncTaskAgentResourceWithStreamingResponse",
 ]

nimble_python/resources/agent.py

@@ -2,7 +2,6 @@
 
 from __future__ import annotations
 
-import typing_extensions
 from typing import Dict, List, Iterable, Optional
 from typing_extensions import Literal, overload
 
@@ -11,7 +10,6 @@ import httpx
 from ..types import (
     agent_run_params,
     agent_list_params,
-    agent_publish_params,
     agent_generate_params,
     agent_run_async_params,
     agent_run_batch_params,
@@ -30,7 +28,6 @@ from .._base_client import make_request_options
 from ..types.agent_get_response import AgentGetResponse
 from ..types.agent_run_response import AgentRunResponse
 from ..types.agent_list_response import AgentListResponse
-from ..types.agent_publish_response import AgentPublishResponse
 from ..types.agent_generate_response import AgentGenerateResponse
 from ..types.agent_run_async_response import AgentRunAsyncResponse
 from ..types.agent_run_batch_response import AgentRunBatchResponse
@@ -124,9 +121,9 @@ class AgentResource(SyncAPIResource):
         prompt: str,
         url: str,
         agent_name: Optional[str] | Omit = omit,
-        input_schema: object | Omit = omit,
+        input_schema: Dict[str, object] | Omit = omit,
         metadata: Optional[agent_generate_params.CreateAgentGenerationRequestMetadata] | Omit = omit,
-        output_schema: object | Omit = omit,
+        output_schema: Dict[str, object] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -182,9 +179,9 @@ class AgentResource(SyncAPIResource):
         prompt: str,
         url: str | Omit = omit,
         agent_name: Optional[str] | Omit = omit,
-        input_schema: object | Omit = omit,
+        input_schema: Dict[str, object] | Omit = omit,
         metadata: Optional[agent_generate_params.CreateAgentGenerationRequestMetadata] | Omit = omit,
-        output_schema: object | Omit = omit,
+        output_schema: Dict[str, object] | Omit = omit,
         from_agent: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -279,42 +276,6 @@ class AgentResource(SyncAPIResource):
             cast_to=AgentGetGenerationResponse,
         )
 
-    @typing_extensions.deprecated("deprecated")
-    def publish(
-        self,
-        agent_name: str,
-        *,
-        version_id: str,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> AgentPublishResponse:
-        """
-        Publish Agent Version
-
-        Args:
-          extra_headers: Send extra headers
-
-          extra_query: Add additional query parameters to the request
-
-          extra_body: Add additional JSON properties to the request
-
-          timeout: Override the client-level default timeout for this request, in seconds
-        """
-        if not agent_name:
-            raise ValueError(f"Expected a non-empty value for `agent_name` but received {agent_name!r}")
-        return self._post(
-            path_template("/v1/agents/{agent_name}/publish", agent_name=agent_name),
-            body=maybe_transform({"version_id": version_id}, agent_publish_params.AgentPublishParams),
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=AgentPublishResponse,
-        )
-
     def run(
         self,
         *,
@@ -551,9 +512,9 @@ class AsyncAgentResource(AsyncAPIResource):
         prompt: str,
         url: str,
         agent_name: Optional[str] | Omit = omit,
-        input_schema: object | Omit = omit,
+        input_schema: Dict[str, object] | Omit = omit,
         metadata: Optional[agent_generate_params.CreateAgentGenerationRequestMetadata] | Omit = omit,
-        output_schema: object | Omit = omit,
+        output_schema: Dict[str, object] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -609,9 +570,9 @@ class AsyncAgentResource(AsyncAPIResource):
         prompt: str,
         url: str | Omit = omit,
         agent_name: Optional[str] | Omit = omit,
-        input_schema: object | Omit = omit,
+        input_schema: Dict[str, object] | Omit = omit,
         metadata: Optional[agent_generate_params.CreateAgentGenerationRequestMetadata] | Omit = omit,
-        output_schema: object | Omit = omit,
+        output_schema: Dict[str, object] | Omit = omit,
         from_agent: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -706,42 +667,6 @@ class AsyncAgentResource(AsyncAPIResource):
             cast_to=AgentGetGenerationResponse,
         )
 
-    @typing_extensions.deprecated("deprecated")
-    async def publish(
-        self,
-        agent_name: str,
-        *,
-        version_id: str,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> AgentPublishResponse:
-        """
-        Publish Agent Version
-
-        Args:
-          extra_headers: Send extra headers
-
-          extra_query: Add additional query parameters to the request
-
-          extra_body: Add additional JSON properties to the request
-
-          timeout: Override the client-level default timeout for this request, in seconds
-        """
-        if not agent_name:
-            raise ValueError(f"Expected a non-empty value for `agent_name` but received {agent_name!r}")
-        return await self._post(
-            path_template("/v1/agents/{agent_name}/publish", agent_name=agent_name),
-            body=await async_maybe_transform({"version_id": version_id}, agent_publish_params.AgentPublishParams),
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=AgentPublishResponse,
-        )
-
     async def run(
         self,
         *,
@@ -909,11 +834,6 @@ class AgentResourceWithRawResponse:
         self.get_generation = to_raw_response_wrapper(
             agent.get_generation,
         )
-        self.publish = (  # pyright: ignore[reportDeprecated]
-            to_raw_response_wrapper(
-                agent.publish,  # pyright: ignore[reportDeprecated],
-            )
-        )
         self.run = to_raw_response_wrapper(
             agent.run,
         )
@@ -941,11 +861,6 @@ class AsyncAgentResourceWithRawResponse:
         self.get_generation = async_to_raw_response_wrapper(
             agent.get_generation,
         )
-        self.publish = (  # pyright: ignore[reportDeprecated]
-            async_to_raw_response_wrapper(
-                agent.publish,  # pyright: ignore[reportDeprecated],
-            )
-        )
         self.run = async_to_raw_response_wrapper(
             agent.run,
         )
@@ -973,11 +888,6 @@ class AgentResourceWithStreamingResponse:
         self.get_generation = to_streamed_response_wrapper(
             agent.get_generation,
         )
-        self.publish = (  # pyright: ignore[reportDeprecated]
-            to_streamed_response_wrapper(
-                agent.publish,  # pyright: ignore[reportDeprecated],
-            )
-        )
         self.run = to_streamed_response_wrapper(
             agent.run,
         )
@@ -1005,11 +915,6 @@ class AsyncAgentResourceWithStreamingResponse:
         self.get_generation = async_to_streamed_response_wrapper(
             agent.get_generation,
         )
-        self.publish = (  # pyright: ignore[reportDeprecated]
-            async_to_streamed_response_wrapper(
-                agent.publish,  # pyright: ignore[reportDeprecated],
-            )
-        )
         self.run = async_to_streamed_response_wrapper(
             agent.run,
         )

nimble_python/resources/serp.py

@@ -71,6 +71,7 @@ class SerpResource(SyncAPIResource):
         parse: bool | Omit = omit,
         query: str | Omit = omit,
         render: bool | Omit = omit,
+        show_hidden_results: bool | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -105,6 +106,9 @@ class SerpResource(SyncAPIResource):
 
           render: Whether to render the page in a browser before extracting.
 
+          show_hidden_results: When true, disables Google result filtering (filter=0) so omitted/duplicate and
+              highly similar pages are also returned. Applies to Google search engines.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -128,6 +132,7 @@ class SerpResource(SyncAPIResource):
                     "parse": parse,
                     "query": query,
                     "render": render,
+                    "show_hidden_results": show_hidden_results,
                 },
                 serp_run_params.SerpRunParams,
             ),
@@ -163,6 +168,7 @@ class SerpResource(SyncAPIResource):
         parse: bool | Omit = omit,
         query: str | Omit = omit,
         render: bool | Omit = omit,
+        show_hidden_results: bool | Omit = omit,
         storage_compress: bool | Omit = omit,
         storage_object_name: str | Omit = omit,
         storage_type: str | Omit = omit,
@@ -203,6 +209,9 @@ class SerpResource(SyncAPIResource):
 
           render: Whether to render the page in a browser before extracting.
 
+          show_hidden_results: When true, disables Google result filtering (filter=0) so omitted/duplicate and
+              highly similar pages are also returned. Applies to Google search engines.
+
           storage_compress: Whether to compress stored data
 
           storage_object_name: Custom name for the stored object
@@ -235,6 +244,7 @@ class SerpResource(SyncAPIResource):
                     "parse": parse,
                     "query": query,
                     "render": render,
+                    "show_hidden_results": show_hidden_results,
                     "storage_compress": storage_compress,
                     "storage_object_name": storage_object_name,
                     "storage_type": storage_type,
@@ -340,6 +350,7 @@ class AsyncSerpResource(AsyncAPIResource):
         parse: bool | Omit = omit,
         query: str | Omit = omit,
         render: bool | Omit = omit,
+        show_hidden_results: bool | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -374,6 +385,9 @@ class AsyncSerpResource(AsyncAPIResource):
 
           render: Whether to render the page in a browser before extracting.
 
+          show_hidden_results: When true, disables Google result filtering (filter=0) so omitted/duplicate and
+              highly similar pages are also returned. Applies to Google search engines.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -397,6 +411,7 @@ class AsyncSerpResource(AsyncAPIResource):
                     "parse": parse,
                     "query": query,
                     "render": render,
+                    "show_hidden_results": show_hidden_results,
                 },
                 serp_run_params.SerpRunParams,
             ),
@@ -432,6 +447,7 @@ class AsyncSerpResource(AsyncAPIResource):
         parse: bool | Omit = omit,
         query: str | Omit = omit,
         render: bool | Omit = omit,
+        show_hidden_results: bool | Omit = omit,
         storage_compress: bool | Omit = omit,
         storage_object_name: str | Omit = omit,
         storage_type: str | Omit = omit,
@@ -472,6 +488,9 @@ class AsyncSerpResource(AsyncAPIResource):
 
           render: Whether to render the page in a browser before extracting.
 
+          show_hidden_results: When true, disables Google result filtering (filter=0) so omitted/duplicate and
+              highly similar pages are also returned. Applies to Google search engines.
+
           storage_compress: Whether to compress stored data
 
           storage_object_name: Custom name for the stored object
@@ -504,6 +523,7 @@ class AsyncSerpResource(AsyncAPIResource):
                     "parse": parse,
                     "query": query,
                     "render": render,
+                    "show_hidden_results": show_hidden_results,
                     "storage_compress": storage_compress,
                     "storage_object_name": storage_object_name,
                     "storage_type": storage_type,