nimble_python 0.16.0__tar.gz → 0.18.0__tar.gz

nimble_python-0.18.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.18.0"
+}

{nimble_python-0.16.0 → nimble_python-0.18.0}/CHANGELOG.md

@@ -1,5 +1,54 @@
 # Changelog
 
+## 0.18.0 (2026-05-10)
+
+Full Changelog: [v0.17.0...v0.18.0](https://github.com/Nimbleway/nimble-python/compare/v0.17.0...v0.18.0)
+
+### Features
+
+* **api:** Add media, serp and domain_knowledge ([d1e33f1](https://github.com/Nimbleway/nimble-python/commit/d1e33f1e44507ba4a817532d58e25f109c58e776))
+
+
+### Bug Fixes
+
+* **client:** add missing f-string prefix in file type error message ([972cbcd](https://github.com/Nimbleway/nimble-python/commit/972cbcd40b4e4091a7364288d3d0b6033983826c))
+
+## 0.17.0 (2026-05-06)
+
+Full Changelog: [v0.16.0...v0.17.0](https://github.com/Nimbleway/nimble-python/compare/v0.16.0...v0.17.0)
+
+### Features
+
+* **api:** api update ([d859e62](https://github.com/Nimbleway/nimble-python/commit/d859e62068214303e9430d093a78028b25b854a2))
+* **api:** api update ([da41c63](https://github.com/Nimbleway/nimble-python/commit/da41c63037e82fde7af3a3e0da8cb3782a175bb8))
+* **api:** api update ([3460f38](https://github.com/Nimbleway/nimble-python/commit/3460f38ecdf277bbebf2fdc7104015d4a7fee810))
+* **api:** api update ([0809fc4](https://github.com/Nimbleway/nimble-python/commit/0809fc473463e746e5b1af30cfcadbfc87db7a5e))
+* **client:** add client_source parameter, update press_action types ([346cfe7](https://github.com/Nimbleway/nimble-python/commit/346cfe70ff7a237c9f0bd52ae699d2012cf5cec7))
+* support setting headers via env ([74b98e0](https://github.com/Nimbleway/nimble-python/commit/74b98e0af4a71cedc34d53f4b33efd6126b91439))
+
+
+### Bug Fixes
+
+* **client:** preserve hardcoded query params when merging with user params ([c07dd33](https://github.com/Nimbleway/nimble-python/commit/c07dd33a98b0dc7a365153ebe13aa8e4f41035fc))
+* ensure file data are only sent as 1 parameter ([58d7d07](https://github.com/Nimbleway/nimble-python/commit/58d7d07475836f0d4ce1c4f68bba7e3631e68d34))
+* use correct field name format for multipart file arrays ([d33d6b7](https://github.com/Nimbleway/nimble-python/commit/d33d6b7599d29d0508fa14ba03a8e0eb7c756aad))
+
+
+### Performance Improvements
+
+* **client:** optimize file structure copying in multipart requests ([77a1d14](https://github.com/Nimbleway/nimble-python/commit/77a1d14ebc143548bcca089d281babc094e01a7e))
+
+
+### Chores
+
+* **internal:** more robust bootstrap script ([ea52394](https://github.com/Nimbleway/nimble-python/commit/ea52394a5adbf1ef83a2d0a5b378d7feb0e0a5f8))
+* **internal:** reformat pyproject.toml ([7d5cec6](https://github.com/Nimbleway/nimble-python/commit/7d5cec6274e237ab69a2b32e79f72a9baad78fff))
+
+
+### Documentation
+
+* improve examples ([a86f0ef](https://github.com/Nimbleway/nimble-python/commit/a86f0ef01987c3063ab465d4ab61bd04229a4911))
+
 ## 0.16.0 (2026-03-30)
 
 Full Changelog: [v0.15.0...v0.16.0](https://github.com/Nimbleway/nimble-python/compare/v0.15.0...v0.16.0)

{nimble_python-0.16.0 → nimble_python-0.18.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: nimble_python
-Version: 0.16.0
+Version: 0.18.0
 Summary: The official Python library for the nimble API
 Project-URL: Homepage, https://github.com/Nimbleway/nimble-python
 Project-URL: Repository, https://github.com/Nimbleway/nimble-python

{nimble_python-0.16.0 → nimble_python-0.18.0}/api.md

@@ -115,3 +115,42 @@ Methods:
 - <code title="get /v1/batches">client.batches.<a href="./src/nimble_python/resources/batches.py">list</a>() -> None</code>
 - <code title="get /v1/batches/{batch_id}">client.batches.<a href="./src/nimble_python/resources/batches.py">get</a>(batch_id) -> <a href="./src/nimble_python/types/batch_get_response.py">BatchGetResponse</a></code>
 - <code title="get /v1/batches/{batch_id}/progress">client.batches.<a href="./src/nimble_python/resources/batches.py">progress</a>(batch_id) -> <a href="./src/nimble_python/types/batch_progress_response.py">BatchProgressResponse</a></code>
+
+# DomainKnowledge
+
+Types:
+
+```python
+from nimble_python.types import DomainKnowledgeGetDriverResponse
+```
+
+Methods:
+
+- <code title="get /v1/domain-knowledge/driver">client.domain_knowledge.<a href="./src/nimble_python/resources/domain_knowledge.py">get_driver</a>(\*\*<a href="src/nimble_python/types/domain_knowledge_get_driver_params.py">params</a>) -> <a href="./src/nimble_python/types/domain_knowledge_get_driver_response.py">DomainKnowledgeGetDriverResponse</a></code>
+
+# Media
+
+Types:
+
+```python
+from nimble_python.types import MediaRunResponse, MediaRunAsyncResponse
+```
+
+Methods:
+
+- <code title="post /v1/media">client.media.<a href="./src/nimble_python/resources/media.py">run</a>(\*\*<a href="src/nimble_python/types/media_run_params.py">params</a>) -> <a href="./src/nimble_python/types/media_run_response.py">MediaRunResponse</a></code>
+- <code title="post /v1/media/async">client.media.<a href="./src/nimble_python/resources/media.py">run_async</a>(\*\*<a href="src/nimble_python/types/media_run_async_params.py">params</a>) -> <a href="./src/nimble_python/types/media_run_async_response.py">MediaRunAsyncResponse</a></code>
+
+# Serp
+
+Types:
+
+```python
+from nimble_python.types import SerpRunResponse, SerpRunAsyncResponse, SerpRunBatchResponse
+```
+
+Methods:
+
+- <code title="post /v1/serp">client.serp.<a href="./src/nimble_python/resources/serp.py">run</a>(\*\*<a href="src/nimble_python/types/serp_run_params.py">params</a>) -> <a href="./src/nimble_python/types/serp_run_response.py">SerpRunResponse</a></code>
+- <code title="post /v1/serp/async">client.serp.<a href="./src/nimble_python/resources/serp.py">run_async</a>(\*\*<a href="src/nimble_python/types/serp_run_async_params.py">params</a>) -> <a href="./src/nimble_python/types/serp_run_async_response.py">SerpRunAsyncResponse</a></code>
+- <code title="post /v1/serp/batch">client.serp.<a href="./src/nimble_python/resources/serp.py">run_batch</a>(\*\*<a href="src/nimble_python/types/serp_run_batch_params.py">params</a>) -> <a href="./src/nimble_python/types/serp_run_batch_response.py">SerpRunBatchResponse</a></code>

{nimble_python-0.16.0 → nimble_python-0.18.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nimble_python"
-version = "0.16.0"
+version = "0.18.0"
 description = "The official Python library for the nimble API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -154,7 +154,7 @@ show_error_codes = true
 #
 # We also exclude our `tests` as mypy doesn't always infer
 # types correctly and Pyright will still catch any type errors.
-exclude = ['src/nimble_python/_files.py', '_dev/.*.py', 'tests/.*']
+exclude = ["src/nimble_python/_files.py", "_dev/.*.py", "tests/.*"]
 
 strict_equality = true
 implicit_reexport = true

{nimble_python-0.16.0 → nimble_python-0.18.0}/src/nimble_python/_base_client.py

@@ -540,6 +540,10 @@ class BaseClient(Generic[_HttpxClientT, _DefaultStreamT]):
                 files = cast(HttpxRequestFiles, ForceMultipartDict())
 
         prepared_url = self._prepare_url(options.url)
+        # preserve hard-coded query params from the url
+        if params and prepared_url.query:
+            params = {**dict(prepared_url.params.items()), **params}
+            prepared_url = prepared_url.copy_with(raw_path=prepared_url.raw_path.split(b"?", 1)[0])
         if "_" in prepared_url.host:
             # work around https://github.com/encode/httpx/discussions/2880
             kwargs["extensions"] = {"sni_hostname": prepared_url.host.replace("_", "-")}

{nimble_python-0.16.0 → nimble_python-0.18.0}/src/nimble_python/_client.py

@@ -33,6 +33,7 @@ from ._types import (
 )
 from ._utils import (
     is_given,
+    is_mapping_t,
     maybe_transform,
     get_async_library,
     async_maybe_transform,
@@ -60,11 +61,14 @@ from .types.extract_async_response import ExtractAsyncResponse
 from .types.extract_batch_response import ExtractBatchResponse
 
 if TYPE_CHECKING:
-    from .resources import agent, crawl, tasks, batches
+    from .resources import serp, agent, crawl, media, tasks, batches, domain_knowledge
+    from .resources.serp import SerpResource, AsyncSerpResource
     from .resources.agent import AgentResource, AsyncAgentResource
     from .resources.crawl import CrawlResource, AsyncCrawlResource
+    from .resources.media import MediaResource, AsyncMediaResource
     from .resources.tasks import TasksResource, AsyncTasksResource
     from .resources.batches import BatchesResource, AsyncBatchesResource
+    from .resources.domain_knowledge import DomainKnowledgeResource, AsyncDomainKnowledgeResource
 
 __all__ = ["Timeout", "Transport", "ProxiesTypes", "RequestOptions", "Nimble", "AsyncNimble", "Client", "AsyncClient"]
 
@@ -72,11 +76,13 @@ __all__ = ["Timeout", "Transport", "ProxiesTypes", "RequestOptions", "Nimble", "
 class Nimble(SyncAPIClient):
     # client options
     api_key: str | None
+    client_source: str | None
 
     def __init__(
         self,
         *,
         api_key: str | None = None,
+        client_source: str | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: float | Timeout | None | NotGiven = not_given,
         max_retries: int = DEFAULT_MAX_RETRIES,
@@ -98,17 +104,32 @@ class Nimble(SyncAPIClient):
     ) -> None:
         """Construct a new synchronous Nimble client instance.
 
-        This automatically infers the `api_key` argument from the `NIMBLE_API_KEY` environment variable if it is not provided.
+        This automatically infers the following arguments from their corresponding environment variables if they are not provided:
+        - `api_key` from `NIMBLE_API_KEY`
+        - `client_source` from `CLIENT_SOURCE`
         """
         if api_key is None:
             api_key = os.environ.get("NIMBLE_API_KEY")
         self.api_key = api_key
 
+        if client_source is None:
+            client_source = os.environ.get("CLIENT_SOURCE") or "sdk"
+        self.client_source = client_source
+
         if base_url is None:
             base_url = os.environ.get("NIMBLE_BASE_URL")
         if base_url is None:
             base_url = f"https://sdk.nimbleway.com"
 
+        custom_headers_env = os.environ.get("NIMBLE_CUSTOM_HEADERS")
+        if custom_headers_env is not None:
+            parsed: dict[str, str] = {}
+            for line in custom_headers_env.split("\n"):
+                colon = line.find(":")
+                if colon >= 0:
+                    parsed[line[:colon].strip()] = line[colon + 1 :].strip()
+            default_headers = {**parsed, **(default_headers if is_mapping_t(default_headers) else {})}
+
         super().__init__(
             version=__version__,
             base_url=base_url,
@@ -144,6 +165,24 @@ class Nimble(SyncAPIClient):
 
         return BatchesResource(self)
 
+    @cached_property
+    def domain_knowledge(self) -> DomainKnowledgeResource:
+        from .resources.domain_knowledge import DomainKnowledgeResource
+
+        return DomainKnowledgeResource(self)
+
+    @cached_property
+    def media(self) -> MediaResource:
+        from .resources.media import MediaResource
+
+        return MediaResource(self)
+
+    @cached_property
+    def serp(self) -> SerpResource:
+        from .resources.serp import SerpResource
+
+        return SerpResource(self)
+
     @cached_property
     def with_raw_response(self) -> NimbleWithRawResponse:
         return NimbleWithRawResponse(self)
@@ -171,6 +210,7 @@ class Nimble(SyncAPIClient):
         return {
             **super().default_headers,
             "X-Stainless-Async": "false",
+            "X-Client-Source": self.client_source if self.client_source is not None else Omit(),
             **self._custom_headers,
         }
 
@@ -187,6 +227,7 @@ class Nimble(SyncAPIClient):
         self,
         *,
         api_key: str | None = None,
+        client_source: str | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: float | Timeout | None | NotGiven = not_given,
         http_client: httpx.Client | None = None,
@@ -221,6 +262,7 @@ class Nimble(SyncAPIClient):
         http_client = http_client or self._client
         return self.__class__(
             api_key=api_key or self.api_key,
+            client_source=client_source or self.client_source,
             base_url=base_url or self.base_url,
             timeout=self.timeout if isinstance(timeout, NotGiven) else timeout,
             http_client=http_client,
@@ -498,9 +540,9 @@ class Nimble(SyncAPIClient):
         ]
         | Omit = omit,
         device: Literal["desktop", "mobile", "tablet"] | Omit = omit,
-        driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro"] | Omit = omit,
+        driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro", "media-vx6"] | Omit = omit,
         expected_status_codes: Iterable[int] | Omit = omit,
-        formats: List[Literal["html", "markdown", "screenshot", "headers"]] | Omit = omit,
+        formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]] | Omit = omit,
         headers: Dict[str, Union[str, SequenceNotStr[str], None]] | Omit = omit,
         http2: bool | Omit = omit,
         is_xhr: bool | Omit = omit,
@@ -1040,6 +1082,7 @@ class Nimble(SyncAPIClient):
             "auto",
         ]
         | Omit = omit,
+        markdown_backend: Literal["full_page", "main_content"] | Omit = omit,
         method: Literal["GET", "POST", "PUT", "PATCH", "DELETE"] | Omit = omit,
         network_capture: Iterable[client_extract_params.NetworkCapture] | Omit = omit,
         os: Literal["windows", "mac os", "linux", "android", "ios"] | Omit = omit,
@@ -1154,6 +1197,10 @@ class Nimble(SyncAPIClient):
 
           locale: Locale for browser language and region settings
 
+          markdown_backend: Selects which markdown conversion strategy to use. "full_page" converts the
+              entire HTML page. "main_content" uses Mozilla Readability to extract the main
+              article content before converting.
+
           method: HTTP method for the request
 
           network_capture: Filters for capturing network traffic
@@ -1203,6 +1250,7 @@ class Nimble(SyncAPIClient):
                     "http2": http2,
                     "is_xhr": is_xhr,
                     "locale": locale,
+                    "markdown_backend": markdown_backend,
                     "method": method,
                     "network_capture": network_capture,
                     "os": os,
@@ -1489,9 +1537,9 @@ class Nimble(SyncAPIClient):
         ]
         | Omit = omit,
         device: Literal["desktop", "mobile", "tablet"] | Omit = omit,
-        driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro"] | Omit = omit,
+        driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro", "media-vx6"] | Omit = omit,
         expected_status_codes: Iterable[int] | Omit = omit,
-        formats: List[Literal["html", "markdown", "screenshot", "headers"]] | Omit = omit,
+        formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]] | Omit = omit,
         headers: Dict[str, Union[str, SequenceNotStr[str], None]] | Omit = omit,
         http2: bool | Omit = omit,
         is_xhr: bool | Omit = omit,
@@ -2031,6 +2079,7 @@ class Nimble(SyncAPIClient):
             "auto",
         ]
         | Omit = omit,
+        markdown_backend: Literal["full_page", "main_content"] | Omit = omit,
         method: Literal["GET", "POST", "PUT", "PATCH", "DELETE"] | Omit = omit,
         network_capture: Iterable[client_extract_async_params.NetworkCapture] | Omit = omit,
         os: Literal["windows", "mac os", "linux", "android", "ios"] | Omit = omit,
@@ -2151,6 +2200,10 @@ class Nimble(SyncAPIClient):
 
           locale: Locale for browser language and region settings
 
+          markdown_backend: Selects which markdown conversion strategy to use. "full_page" converts the
+              entire HTML page. "main_content" uses Mozilla Readability to extract the main
+              article content before converting.
+
           method: HTTP method for the request
 
           network_capture: Filters for capturing network traffic
@@ -2209,6 +2262,7 @@ class Nimble(SyncAPIClient):
                     "http2": http2,
                     "is_xhr": is_xhr,
                     "locale": locale,
+                    "markdown_backend": markdown_backend,
                     "method": method,
                     "network_capture": network_capture,
                     "os": os,
@@ -3272,11 +3326,13 @@ class Nimble(SyncAPIClient):
 class AsyncNimble(AsyncAPIClient):
     # client options
     api_key: str | None
+    client_source: str | None
 
     def __init__(
         self,
         *,
         api_key: str | None = None,
+        client_source: str | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: float | Timeout | None | NotGiven = not_given,
         max_retries: int = DEFAULT_MAX_RETRIES,
@@ -3298,17 +3354,32 @@ class AsyncNimble(AsyncAPIClient):
     ) -> None:
         """Construct a new async AsyncNimble client instance.
 
-        This automatically infers the `api_key` argument from the `NIMBLE_API_KEY` environment variable if it is not provided.
+        This automatically infers the following arguments from their corresponding environment variables if they are not provided:
+        - `api_key` from `NIMBLE_API_KEY`
+        - `client_source` from `CLIENT_SOURCE`
         """
         if api_key is None:
             api_key = os.environ.get("NIMBLE_API_KEY")
         self.api_key = api_key
 
+        if client_source is None:
+            client_source = os.environ.get("CLIENT_SOURCE") or "sdk"
+        self.client_source = client_source
+
         if base_url is None:
             base_url = os.environ.get("NIMBLE_BASE_URL")
         if base_url is None:
             base_url = f"https://sdk.nimbleway.com"
 
+        custom_headers_env = os.environ.get("NIMBLE_CUSTOM_HEADERS")
+        if custom_headers_env is not None:
+            parsed: dict[str, str] = {}
+            for line in custom_headers_env.split("\n"):
+                colon = line.find(":")
+                if colon >= 0:
+                    parsed[line[:colon].strip()] = line[colon + 1 :].strip()
+            default_headers = {**parsed, **(default_headers if is_mapping_t(default_headers) else {})}
+
         super().__init__(
             version=__version__,
             base_url=base_url,
@@ -3344,6 +3415,24 @@ class AsyncNimble(AsyncAPIClient):
 
         return AsyncBatchesResource(self)
 
+    @cached_property
+    def domain_knowledge(self) -> AsyncDomainKnowledgeResource:
+        from .resources.domain_knowledge import AsyncDomainKnowledgeResource
+
+        return AsyncDomainKnowledgeResource(self)
+
+    @cached_property
+    def media(self) -> AsyncMediaResource:
+        from .resources.media import AsyncMediaResource
+
+        return AsyncMediaResource(self)
+
+    @cached_property
+    def serp(self) -> AsyncSerpResource:
+        from .resources.serp import AsyncSerpResource
+
+        return AsyncSerpResource(self)
+
     @cached_property
     def with_raw_response(self) -> AsyncNimbleWithRawResponse:
         return AsyncNimbleWithRawResponse(self)
@@ -3371,6 +3460,7 @@ class AsyncNimble(AsyncAPIClient):
         return {
             **super().default_headers,
             "X-Stainless-Async": f"async:{get_async_library()}",
+            "X-Client-Source": self.client_source if self.client_source is not None else Omit(),
             **self._custom_headers,
         }
 
@@ -3387,6 +3477,7 @@ class AsyncNimble(AsyncAPIClient):
         self,
         *,
         api_key: str | None = None,
+        client_source: str | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: float | Timeout | None | NotGiven = not_given,
         http_client: httpx.AsyncClient | None = None,
@@ -3421,6 +3512,7 @@ class AsyncNimble(AsyncAPIClient):
         http_client = http_client or self._client
         return self.__class__(
             api_key=api_key or self.api_key,
+            client_source=client_source or self.client_source,
             base_url=base_url or self.base_url,
             timeout=self.timeout if isinstance(timeout, NotGiven) else timeout,
             http_client=http_client,
@@ -3698,9 +3790,9 @@ class AsyncNimble(AsyncAPIClient):
         ]
         | Omit = omit,
         device: Literal["desktop", "mobile", "tablet"] | Omit = omit,
-        driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro"] | Omit = omit,
+        driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro", "media-vx6"] | Omit = omit,
         expected_status_codes: Iterable[int] | Omit = omit,
-        formats: List[Literal["html", "markdown", "screenshot", "headers"]] | Omit = omit,
+        formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]] | Omit = omit,
         headers: Dict[str, Union[str, SequenceNotStr[str], None]] | Omit = omit,
         http2: bool | Omit = omit,
         is_xhr: bool | Omit = omit,
@@ -4240,6 +4332,7 @@ class AsyncNimble(AsyncAPIClient):
             "auto",
         ]
         | Omit = omit,
+        markdown_backend: Literal["full_page", "main_content"] | Omit = omit,
         method: Literal["GET", "POST", "PUT", "PATCH", "DELETE"] | Omit = omit,
         network_capture: Iterable[client_extract_params.NetworkCapture] | Omit = omit,
         os: Literal["windows", "mac os", "linux", "android", "ios"] | Omit = omit,
@@ -4354,6 +4447,10 @@ class AsyncNimble(AsyncAPIClient):
 
           locale: Locale for browser language and region settings
 
+          markdown_backend: Selects which markdown conversion strategy to use. "full_page" converts the
+              entire HTML page. "main_content" uses Mozilla Readability to extract the main
+              article content before converting.
+
           method: HTTP method for the request
 
           network_capture: Filters for capturing network traffic
@@ -4403,6 +4500,7 @@ class AsyncNimble(AsyncAPIClient):
                     "http2": http2,
                     "is_xhr": is_xhr,
                     "locale": locale,
+                    "markdown_backend": markdown_backend,
                     "method": method,
                     "network_capture": network_capture,
                     "os": os,
@@ -4689,9 +4787,9 @@ class AsyncNimble(AsyncAPIClient):
         ]
         | Omit = omit,
         device: Literal["desktop", "mobile", "tablet"] | Omit = omit,
-        driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro"] | Omit = omit,
+        driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro", "media-vx6"] | Omit = omit,
         expected_status_codes: Iterable[int] | Omit = omit,
-        formats: List[Literal["html", "markdown", "screenshot", "headers"]] | Omit = omit,
+        formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]] | Omit = omit,
         headers: Dict[str, Union[str, SequenceNotStr[str], None]] | Omit = omit,
         http2: bool | Omit = omit,
         is_xhr: bool | Omit = omit,
@@ -5231,6 +5329,7 @@ class AsyncNimble(AsyncAPIClient):
             "auto",
         ]
         | Omit = omit,
+        markdown_backend: Literal["full_page", "main_content"] | Omit = omit,
         method: Literal["GET", "POST", "PUT", "PATCH", "DELETE"] | Omit = omit,
         network_capture: Iterable[client_extract_async_params.NetworkCapture] | Omit = omit,
         os: Literal["windows", "mac os", "linux", "android", "ios"] | Omit = omit,
@@ -5351,6 +5450,10 @@ class AsyncNimble(AsyncAPIClient):
 
           locale: Locale for browser language and region settings
 
+          markdown_backend: Selects which markdown conversion strategy to use. "full_page" converts the
+              entire HTML page. "main_content" uses Mozilla Readability to extract the main
+              article content before converting.
+
           method: HTTP method for the request
 
           network_capture: Filters for capturing network traffic
@@ -5409,6 +5512,7 @@ class AsyncNimble(AsyncAPIClient):
                     "http2": http2,
                     "is_xhr": is_xhr,
                     "locale": locale,
+                    "markdown_backend": markdown_backend,
                     "method": method,
                     "network_capture": network_capture,
                     "os": os,
@@ -6515,6 +6619,24 @@ class NimbleWithRawResponse:
 
         return BatchesResourceWithRawResponse(self._client.batches)
 
+    @cached_property
+    def domain_knowledge(self) -> domain_knowledge.DomainKnowledgeResourceWithRawResponse:
+        from .resources.domain_knowledge import DomainKnowledgeResourceWithRawResponse
+
+        return DomainKnowledgeResourceWithRawResponse(self._client.domain_knowledge)
+
+    @cached_property
+    def media(self) -> media.MediaResourceWithRawResponse:
+        from .resources.media import MediaResourceWithRawResponse
+
+        return MediaResourceWithRawResponse(self._client.media)
+
+    @cached_property
+    def serp(self) -> serp.SerpResourceWithRawResponse:
+        from .resources.serp import SerpResourceWithRawResponse
+
+        return SerpResourceWithRawResponse(self._client.serp)
+
 
 class AsyncNimbleWithRawResponse:
     _client: AsyncNimble
@@ -6562,6 +6684,24 @@ class AsyncNimbleWithRawResponse:
 
         return AsyncBatchesResourceWithRawResponse(self._client.batches)
 
+    @cached_property
+    def domain_knowledge(self) -> domain_knowledge.AsyncDomainKnowledgeResourceWithRawResponse:
+        from .resources.domain_knowledge import AsyncDomainKnowledgeResourceWithRawResponse
+
+        return AsyncDomainKnowledgeResourceWithRawResponse(self._client.domain_knowledge)
+
+    @cached_property
+    def media(self) -> media.AsyncMediaResourceWithRawResponse:
+        from .resources.media import AsyncMediaResourceWithRawResponse
+
+        return AsyncMediaResourceWithRawResponse(self._client.media)
+
+    @cached_property
+    def serp(self) -> serp.AsyncSerpResourceWithRawResponse:
+        from .resources.serp import AsyncSerpResourceWithRawResponse
+
+        return AsyncSerpResourceWithRawResponse(self._client.serp)
+
 
 class NimbleWithStreamedResponse:
     _client: Nimble
@@ -6609,6 +6749,24 @@ class NimbleWithStreamedResponse:
 
         return BatchesResourceWithStreamingResponse(self._client.batches)
 
+    @cached_property
+    def domain_knowledge(self) -> domain_knowledge.DomainKnowledgeResourceWithStreamingResponse:
+        from .resources.domain_knowledge import DomainKnowledgeResourceWithStreamingResponse
+
+        return DomainKnowledgeResourceWithStreamingResponse(self._client.domain_knowledge)
+
+    @cached_property
+    def media(self) -> media.MediaResourceWithStreamingResponse:
+        from .resources.media import MediaResourceWithStreamingResponse
+
+        return MediaResourceWithStreamingResponse(self._client.media)
+
+    @cached_property
+    def serp(self) -> serp.SerpResourceWithStreamingResponse:
+        from .resources.serp import SerpResourceWithStreamingResponse
+
+        return SerpResourceWithStreamingResponse(self._client.serp)
+
 
 class AsyncNimbleWithStreamedResponse:
     _client: AsyncNimble
@@ -6656,6 +6814,24 @@ class AsyncNimbleWithStreamedResponse:
 
         return AsyncBatchesResourceWithStreamingResponse(self._client.batches)
 
+    @cached_property
+    def domain_knowledge(self) -> domain_knowledge.AsyncDomainKnowledgeResourceWithStreamingResponse:
+        from .resources.domain_knowledge import AsyncDomainKnowledgeResourceWithStreamingResponse
+
+        return AsyncDomainKnowledgeResourceWithStreamingResponse(self._client.domain_knowledge)
+
+    @cached_property
+    def media(self) -> media.AsyncMediaResourceWithStreamingResponse:
+        from .resources.media import AsyncMediaResourceWithStreamingResponse
+
+        return AsyncMediaResourceWithStreamingResponse(self._client.media)
+
+    @cached_property
+    def serp(self) -> serp.AsyncSerpResourceWithStreamingResponse:
+        from .resources.serp import AsyncSerpResourceWithStreamingResponse
+
+        return AsyncSerpResourceWithStreamingResponse(self._client.serp)
+
 
 Client = Nimble