fix(api): re-add deprecated max_chars_per_result

stainless-app[bot] · stainless-app[bot] · commit e0976a12f85f · 2025-11-06T17:42:29.000Z
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 13
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/parallel-web%2Fparallel-sdk-40c12295a3f32ed93d58b523bb28f33ceabe8e6bfa8c44d5f863ed9c77feff58.yml
-openapi_spec_hash: 9f3cd99867507ada834db61c6d8391b9
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/parallel-web%2Fparallel-sdk-75b88aac7d973b5965b0ff4c6b16264a2b9051e0b156943931c1f28fe2b4777b.yml
+openapi_spec_hash: dc891ed9f9ca1172750db864a883f646
 config_hash: 677d555754b79eb922f6bf64bccd9559
diff --git a/src/parallel/resources/beta/beta.py b/src/parallel/resources/beta/beta.py
@@ -154,6 +154,7 @@ def search(
         *,
         excerpts: ExcerptSettingsParam | Omit = omit,
         fetch_policy: Optional[FetchPolicyParam] | Omit = omit,
+        max_chars_per_result: Optional[int] | Omit = omit,
         max_results: Optional[int] | Omit = omit,
         mode: Optional[Literal["one-shot", "agentic"]] | Omit = omit,
         objective: Optional[str] | Omit = omit,
@@ -182,6 +183,10 @@ def search(
               live content (fresher). The default policy for search uses cached results only,
               while extract uses a dynamic policy based on the search objective and url.
 
+          max_chars_per_result: Optional upper bound on the total number of characters to include per url.
+              Excerpts may contain fewer characters than this limit to maximize relevance and
+              token efficiency.
+
           max_results: Upper bound on the number of results to return. May be limited by the processor.
               Defaults to 10 if not provided.
 
@@ -229,6 +234,7 @@ def search(
                 {
                     "excerpts": excerpts,
                     "fetch_policy": fetch_policy,
+                    "max_chars_per_result": max_chars_per_result,
                     "max_results": max_results,
                     "mode": mode,
                     "objective": objective,
@@ -352,6 +358,7 @@ async def search(
         *,
         excerpts: ExcerptSettingsParam | Omit = omit,
         fetch_policy: Optional[FetchPolicyParam] | Omit = omit,
+        max_chars_per_result: Optional[int] | Omit = omit,
         max_results: Optional[int] | Omit = omit,
         mode: Optional[Literal["one-shot", "agentic"]] | Omit = omit,
         objective: Optional[str] | Omit = omit,
@@ -380,6 +387,10 @@ async def search(
               live content (fresher). The default policy for search uses cached results only,
               while extract uses a dynamic policy based on the search objective and url.
 
+          max_chars_per_result: Optional upper bound on the total number of characters to include per url.
+              Excerpts may contain fewer characters than this limit to maximize relevance and
+              token efficiency.
+
           max_results: Upper bound on the number of results to return. May be limited by the processor.
               Defaults to 10 if not provided.
 
@@ -427,6 +438,7 @@ async def search(
                 {
                     "excerpts": excerpts,
                     "fetch_policy": fetch_policy,
+                    "max_chars_per_result": max_chars_per_result,
                     "max_results": max_results,
                     "mode": mode,
                     "objective": objective,
diff --git a/src/parallel/types/beta/beta_search_params.py b/src/parallel/types/beta/beta_search_params.py
@@ -27,6 +27,13 @@ class BetaSearchParams(TypedDict, total=False):
     while extract uses a dynamic policy based on the search objective and url.
     """
 
+    max_chars_per_result: Optional[int]
+    """Optional upper bound on the total number of characters to include per url.
+
+    Excerpts may contain fewer characters than this limit to maximize relevance and
+    token efficiency.
+    """
+
     max_results: Optional[int]
     """Upper bound on the number of results to return.
 
diff --git a/tests/api_resources/test_beta.py b/tests/api_resources/test_beta.py
@@ -85,6 +85,7 @@ def test_method_search_with_all_params(self, client: Parallel) -> None:
                 "max_age_seconds": 86400,
                 "timeout_seconds": 60,
             },
+            max_chars_per_result=0,
             max_results=0,
             mode="one-shot",
             objective="objective",
@@ -188,6 +189,7 @@ async def test_method_search_with_all_params(self, async_client: AsyncParallel)
                 "max_age_seconds": 86400,
                 "timeout_seconds": 60,
             },
+            max_chars_per_result=0,
             max_results=0,
             mode="one-shot",
             objective="objective",
