release: 0.3.1 (#14)

Automated Release PR
---


## 0.3.1 (2025-10-21)

Full Changelog:
[v0.3.0...v0.3.1](v0.3.0...v0.3.1)

### Features

* **api**: Make FetchPolicy a common model instead of an extract
specific model
([0acbe77](0acbe77))


---
This pull request is managed by Stainless's [GitHub
App](https://github.com/apps/stainless-app).

The [semver version
number](https://semver.org/#semantic-versioning-specification-semver) is
based on included [commit
messages](https://www.conventionalcommits.org/en/v1.0.0/).
Alternatively, you can manually set the version number in the title of
this pull request.

For a better experience, it is recommended to use either rebase-merge or
squash-merge when merging this pull request.

🔗 Stainless [website](https://www.stainlessapi.com)
📚 Read the [docs](https://app.stainlessapi.com/docs)
🙋 [Reach out](mailto:support@stainlessapi.com) for help or questions

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.3.0"
+  ".": "0.3.1"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 13
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/parallel-web%2Fparallel-sdk-e853fc79f3b41f00b3934fcc2e4c2813aa9f38528548f5f596e2b11ea833019b.yml
 openapi_spec_hash: 34ed7e373927037fce6fd33d9bb60389
-config_hash: ae63572e3769dcd1b11e587f039e211a
+config_hash: 49716a82995763fddc4308b0b302f1cb

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.3.1 (2025-10-21)
+
+Full Changelog: [v0.3.0...v0.3.1](https://github.com/parallel-web/parallel-sdk-python/compare/v0.3.0...v0.3.1)
+
+### Features
+
+* **api:** manual updates ([0acbe77](https://github.com/parallel-web/parallel-sdk-python/commit/0acbe77da0148029c21e6b3c541e0b1ca163038d))
+
 ## 0.3.0 (2025-10-21)
 
 Full Changelog: [v0.2.2...v0.3.0](https://github.com/parallel-web/parallel-sdk-python/compare/v0.2.2...v0.3.0)

api.md

@@ -45,6 +45,7 @@ from parallel.types.beta import (
     ExtractError,
     ExtractResponse,
     ExtractResult,
+    FetchPolicy,
     SearchResult,
     WebSearchResult,
 )

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "parallel-web"
-version = "0.3.0"
+version = "0.3.1"
 description = "The official Python library for the Parallel API"
 dynamic = ["readme"]
 license = "MIT"

src/parallel/_version.py

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

src/parallel/resources/beta/beta.py

@@ -37,6 +37,7 @@
 from ..._base_client import make_request_options
 from ...types.beta.search_result import SearchResult
 from ...types.beta.extract_response import ExtractResponse
+from ...types.beta.fetch_policy_param import FetchPolicyParam
 from ...types.beta.parallel_beta_param import ParallelBetaParam
 from ...types.shared_params.source_policy import SourcePolicy
 
@@ -76,7 +77,7 @@ def extract(
         *,
         urls: SequenceNotStr[str],
         excerpts: beta_extract_params.Excerpts | Omit = omit,
-        fetch_policy: Optional[beta_extract_params.FetchPolicy] | Omit = omit,
+        fetch_policy: Optional[FetchPolicyParam] | Omit = omit,
         full_content: beta_extract_params.FullContent | Omit = omit,
         objective: Optional[str] | Omit = omit,
         search_queries: Optional[SequenceNotStr[str]] | Omit = omit,
@@ -252,7 +253,7 @@ async def extract(
         *,
         urls: SequenceNotStr[str],
         excerpts: beta_extract_params.Excerpts | Omit = omit,
-        fetch_policy: Optional[beta_extract_params.FetchPolicy] | Omit = omit,
+        fetch_policy: Optional[FetchPolicyParam] | Omit = omit,
         full_content: beta_extract_params.FullContent | Omit = omit,
         objective: Optional[str] | Omit = omit,
         search_queries: Optional[SequenceNotStr[str]] | Omit = omit,

src/parallel/types/beta/__init__.py

@@ -18,6 +18,7 @@
 from .task_group_status import TaskGroupStatus as TaskGroupStatus
 from .web_search_result import WebSearchResult as WebSearchResult
 from .beta_search_params import BetaSearchParams as BetaSearchParams
+from .fetch_policy_param import FetchPolicyParam as FetchPolicyParam
 from .beta_extract_params import BetaExtractParams as BetaExtractParams
 from .parallel_beta_param import ParallelBetaParam as ParallelBetaParam
 from .beta_run_input_param import BetaRunInputParam as BetaRunInputParam

src/parallel/types/beta/beta_extract_params.py

@@ -7,10 +7,11 @@
 
 from ..._types import SequenceNotStr
 from ..._utils import PropertyInfo
+from .fetch_policy_param import FetchPolicyParam
 from .parallel_beta_param import ParallelBetaParam
 from .excerpt_settings_param import ExcerptSettingsParam
 
-__all__ = ["BetaExtractParams", "Excerpts", "FetchPolicy", "FullContent", "FullContentFullContentSettings"]
+__all__ = ["BetaExtractParams", "Excerpts", "FullContent", "FullContentFullContentSettings"]
 
 
 class BetaExtractParams(TypedDict, total=False):
@@ -23,7 +24,7 @@ class BetaExtractParams(TypedDict, total=False):
     redundant with full content.
     """
 
-    fetch_policy: Optional[FetchPolicy]
+    fetch_policy: Optional[FetchPolicyParam]
     """Fetch policy.
 
     Determines when to return content from the cache (faster) vs fetching live
@@ -50,29 +51,6 @@ class BetaExtractParams(TypedDict, total=False):
 Excerpts: TypeAlias = Union[bool, ExcerptSettingsParam]
 
 
-class FetchPolicy(TypedDict, total=False):
-    disable_cache_fallback: bool
-    """
-    If false, fallback to cached content older than max-age if live fetch fails or
-    times out. If true, returns an error instead.
-    """
-
-    max_age_seconds: Optional[int]
-    """Maximum age of cached content in seconds to trigger a live fetch.
-
-    Minimum value 600 seconds (10 minutes). If not provided, a dynamic age policy
-    will be used based on the search objective and url.
-    """
-
-    timeout_seconds: Optional[float]
-    """Timeout in seconds for fetching live content if unavailable in cache.
-
-    If unspecified a dynamic timeout will be used based on the url, generally 15
-    seconds for simple pages and up to 60 seconds for complex pages requiring
-    javascript or PDF rendering.
-    """
-
-
 class FullContentFullContentSettings(TypedDict, total=False):
     max_chars_per_result: Optional[int]
     """

src/parallel/types/beta/fetch_policy_param.py

@@ -0,0 +1,31 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import TypedDict
+
+__all__ = ["FetchPolicyParam"]
+
+
+class FetchPolicyParam(TypedDict, total=False):
+    disable_cache_fallback: bool
+    """
+    If false, fallback to cached content older than max-age if live fetch fails or
+    times out. If true, returns an error instead.
+    """
+
+    max_age_seconds: Optional[int]
+    """Maximum age of cached content in seconds to trigger a live fetch.
+
+    Minimum value 600 seconds (10 minutes). If not provided, a dynamic age policy
+    will be used based on the search objective and url.
+    """
+
+    timeout_seconds: Optional[float]
+    """Timeout in seconds for fetching live content if unavailable in cache.
+
+    If unspecified a dynamic timeout will be used based on the url, generally 15
+    seconds for simple pages and up to 60 seconds for complex pages requiring
+    javascript or PDF rendering.
+    """