From 5b9481966d0e279462f6cdea930cd738871239ee Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sun, 31 May 2026 20:16:55 +0000
Subject: [PATCH 1/6] feat(api): api update

---
 .stats.yml                       |  4 ++--
 src/context/dev/resources/web.py | 10 ++--------
 2 files changed, 4 insertions(+), 10 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 4eb43d2..e30da8b 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 24
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-cc8ca2c80e73bdcff491c96d9289c9e88d831215375ef83632cc51f8e8e06183.yml
-openapi_spec_hash: bf55dce481efcf2f24bc9ff59c2e3f61
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-03de02938a74b3a1f4774c8b648d35bea53c1582ab4f2ebdc92f4094ea1e94a8.yml
+openapi_spec_hash: 116ab48eae6dc7629da583b8a38361dc
 config_hash: cf2c7f48b329e0a61612b30cd2755ad1
diff --git a/src/context/dev/resources/web.py b/src/context/dev/resources/web.py
index 95d25b5..7f0a091 100644
--- a/src/context/dev/resources/web.py
+++ b/src/context/dev/resources/web.py
@@ -86,10 +86,7 @@ def extract(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> WebExtractResponse:
         """
-        Crawl a website, convert pages to Markdown using the scrape cache, and extract
-        structured data into the provided JSON Schema. The schema must describe the
-        response data object. This endpoint does not accept targeted page-type
-        selection.
+        Crawl a website and extract structured data using the provided JSON Schema.
 
         Args:
           schema: JSON Schema for the returned data object. TypeScript Zod users can pass a JSON
@@ -876,10 +873,7 @@ async def extract(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> WebExtractResponse:
         """
-        Crawl a website, convert pages to Markdown using the scrape cache, and extract
-        structured data into the provided JSON Schema. The schema must describe the
-        response data object. This endpoint does not accept targeted page-type
-        selection.
+        Crawl a website and extract structured data using the provided JSON Schema.
 
         Args:
           schema: JSON Schema for the returned data object. TypeScript Zod users can pass a JSON

From edeabb036e0a5f8730fd0175fcd2fd42d4156b05 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sun, 31 May 2026 21:55:20 +0000
Subject: [PATCH 2/6] feat(api): api update

---
 .stats.yml                                  |  4 ++--
 src/context/dev/resources/web.py            | 24 ++++++++++-----------
 src/context/dev/types/web_extract_params.py | 12 +++++------
 3 files changed, 20 insertions(+), 20 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index e30da8b..85fc14d 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 24
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-03de02938a74b3a1f4774c8b648d35bea53c1582ab4f2ebdc92f4094ea1e94a8.yml
-openapi_spec_hash: 116ab48eae6dc7629da583b8a38361dc
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-6dda47a78deee48e39249ec36fe6e565b6f010472796b13b3d52c418d0b54711.yml
+openapi_spec_hash: c46d519e3c6d2da7bc219ad127e4290a
 config_hash: cf2c7f48b329e0a61612b30cd2755ad1
diff --git a/src/context/dev/resources/web.py b/src/context/dev/resources/web.py
index 7f0a091..9058689 100644
--- a/src/context/dev/resources/web.py
+++ b/src/context/dev/resources/web.py
@@ -96,12 +96,12 @@ def extract(
           url: The starting website URL to crawl and extract from. Must include http:// or
               https://.
 
-          fact_check: When true (default), every returned value must be grounded in facts stated on
-              the page; fields that cannot be supported by the page are returned as
-              null/empty. When false, the model may make reasonable inferences and derivations
-              from the page content (e.g. ideal customer, competitor analysis,
-              recommendations) while keeping verifiable specifics (names, quotes, URLs, dates,
-              metrics) faithful to the source.
+          fact_check: When true, every returned value must be grounded in facts stated on the page;
+              fields that cannot be supported by the page are returned as null/empty. When
+              false (default), the model may make reasonable inferences and derivations from
+              the page content (e.g. ideal customer, competitor analysis, recommendations)
+              while keeping verifiable specifics (names, quotes, URLs, dates, metrics)
+              faithful to the source.
 
           follow_subdomains: When true, follow links on subdomains of the starting URL's domain.
 
@@ -883,12 +883,12 @@ async def extract(
           url: The starting website URL to crawl and extract from. Must include http:// or
               https://.
 
-          fact_check: When true (default), every returned value must be grounded in facts stated on
-              the page; fields that cannot be supported by the page are returned as
-              null/empty. When false, the model may make reasonable inferences and derivations
-              from the page content (e.g. ideal customer, competitor analysis,
-              recommendations) while keeping verifiable specifics (names, quotes, URLs, dates,
-              metrics) faithful to the source.
+          fact_check: When true, every returned value must be grounded in facts stated on the page;
+              fields that cannot be supported by the page are returned as null/empty. When
+              false (default), the model may make reasonable inferences and derivations from
+              the page content (e.g. ideal customer, competitor analysis, recommendations)
+              while keeping verifiable specifics (names, quotes, URLs, dates, metrics)
+              faithful to the source.
 
           follow_subdomains: When true, follow links on subdomains of the starting URL's domain.
 
diff --git a/src/context/dev/types/web_extract_params.py b/src/context/dev/types/web_extract_params.py
index cbf46e3..f3a3ca6 100644
--- a/src/context/dev/types/web_extract_params.py
+++ b/src/context/dev/types/web_extract_params.py
@@ -26,12 +26,12 @@ class WebExtractParams(TypedDict, total=False):
 
     fact_check: Annotated[bool, PropertyInfo(alias="factCheck")]
     """
-    When true (default), every returned value must be grounded in facts stated on
-    the page; fields that cannot be supported by the page are returned as
-    null/empty. When false, the model may make reasonable inferences and derivations
-    from the page content (e.g. ideal customer, competitor analysis,
-    recommendations) while keeping verifiable specifics (names, quotes, URLs, dates,
-    metrics) faithful to the source.
+    When true, every returned value must be grounded in facts stated on the page;
+    fields that cannot be supported by the page are returned as null/empty. When
+    false (default), the model may make reasonable inferences and derivations from
+    the page content (e.g. ideal customer, competitor analysis, recommendations)
+    while keeping verifiable specifics (names, quotes, URLs, dates, metrics)
+    faithful to the source.
     """
 
     follow_subdomains: Annotated[bool, PropertyInfo(alias="followSubdomains")]

From f44a6b924b2b1b20de8e280e030acef1726f0dc6 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sun, 31 May 2026 23:15:46 +0000
Subject: [PATCH 3/6] codegen metadata

---
 .stats.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 85fc14d..b8f55eb 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 24
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-6dda47a78deee48e39249ec36fe6e565b6f010472796b13b3d52c418d0b54711.yml
-openapi_spec_hash: c46d519e3c6d2da7bc219ad127e4290a
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-aacd4fe671f95f7229d8045bbfd51523a5135ff99b52206c1ec73ef350ef4a87.yml
+openapi_spec_hash: 0b62bc35fdab1cf4cecfacc733b4940f
 config_hash: cf2c7f48b329e0a61612b30cd2755ad1

From cd90e97f36bc6adcf790522df90edb2640f3f510 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Mon, 1 Jun 2026 02:48:27 +0000
Subject: [PATCH 4/6] feat(api): api update

---
 .stats.yml                                  |  4 ++--
 src/context/dev/resources/web.py            | 10 ++++++----
 src/context/dev/types/web_extract_params.py |  2 +-
 3 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index b8f55eb..a12255a 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 24
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-aacd4fe671f95f7229d8045bbfd51523a5135ff99b52206c1ec73ef350ef4a87.yml
-openapi_spec_hash: 0b62bc35fdab1cf4cecfacc733b4940f
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-72a5e799aeb35d66c3a93b613eb57e559b9f05fff9bafe977ef312260666192d.yml
+openapi_spec_hash: b679f0ba091667a2f6f3054373121d98
 config_hash: cf2c7f48b329e0a61612b30cd2755ad1
diff --git a/src/context/dev/resources/web.py b/src/context/dev/resources/web.py
index 9058689..dde889b 100644
--- a/src/context/dev/resources/web.py
+++ b/src/context/dev/resources/web.py
@@ -86,7 +86,8 @@ def extract(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> WebExtractResponse:
         """
-        Crawl a website and extract structured data using the provided JSON Schema.
+        Crawl a website, use the provided JSON Schema and instructions to prioritize
+        relevant internal links, and extract structured data from the selected pages.
 
         Args:
           schema: JSON Schema for the returned data object. TypeScript Zod users can pass a JSON
@@ -111,7 +112,7 @@ def extract(
               interpret fields in the schema.
 
           max_age_ms: Return cached scrape results if a prior scrape for the same parameters is
-              younger than this many milliseconds.
+              younger than this many milliseconds. Defaults to 7 days (604800000 ms).
 
           stop_after_ms: Soft time budget for the crawl in milliseconds.
 
@@ -873,7 +874,8 @@ async def extract(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> WebExtractResponse:
         """
-        Crawl a website and extract structured data using the provided JSON Schema.
+        Crawl a website, use the provided JSON Schema and instructions to prioritize
+        relevant internal links, and extract structured data from the selected pages.
 
         Args:
           schema: JSON Schema for the returned data object. TypeScript Zod users can pass a JSON
@@ -898,7 +900,7 @@ async def extract(
               interpret fields in the schema.
 
           max_age_ms: Return cached scrape results if a prior scrape for the same parameters is
-              younger than this many milliseconds.
+              younger than this many milliseconds. Defaults to 7 days (604800000 ms).
 
           stop_after_ms: Soft time budget for the crawl in milliseconds.
 
diff --git a/src/context/dev/types/web_extract_params.py b/src/context/dev/types/web_extract_params.py
index f3a3ca6..b11c37d 100644
--- a/src/context/dev/types/web_extract_params.py
+++ b/src/context/dev/types/web_extract_params.py
@@ -49,7 +49,7 @@ class WebExtractParams(TypedDict, total=False):
     max_age_ms: Annotated[int, PropertyInfo(alias="maxAgeMs")]
     """
     Return cached scrape results if a prior scrape for the same parameters is
-    younger than this many milliseconds.
+    younger than this many milliseconds. Defaults to 7 days (604800000 ms).
     """
 
     pdf: Pdf

From 105adb353ec7d37f1ecff2a25dbc712b757a1bbe Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Mon, 1 Jun 2026 21:03:28 +0000
Subject: [PATCH 5/6] codegen metadata

---
 .stats.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index a12255a..deed013 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 24
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-72a5e799aeb35d66c3a93b613eb57e559b9f05fff9bafe977ef312260666192d.yml
-openapi_spec_hash: b679f0ba091667a2f6f3054373121d98
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-1785aa93e6fb2784640a4c32eb0221f0b31aa06644d090f72f8533524aeef7c6.yml
+openapi_spec_hash: 7dc1fadcec32637e795f641a0e97c63e
 config_hash: cf2c7f48b329e0a61612b30cd2755ad1

From c7203a3624a3b750e4d78e458b1fb79585ff3483 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Mon, 1 Jun 2026 21:03:54 +0000
Subject: [PATCH 6/6] release: 0.28.0

---
 .release-please-manifest.json |  2 +-
 CHANGELOG.md                  | 10 ++++++++++
 pyproject.toml                |  2 +-
 src/context/dev/_version.py   |  2 +-
 4 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 59acac4..8935e93 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.27.0"
+  ".": "0.28.0"
 }
\ No newline at end of file
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1d73219..c927c01 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.28.0 (2026-06-01)
+
+Full Changelog: [v0.27.0...v0.28.0](https://github.com/context-dot-dev/context-python-sdk/compare/v0.27.0...v0.28.0)
+
+### Features
+
+* **api:** api update ([cd90e97](https://github.com/context-dot-dev/context-python-sdk/commit/cd90e97f36bc6adcf790522df90edb2640f3f510))
+* **api:** api update ([edeabb0](https://github.com/context-dot-dev/context-python-sdk/commit/edeabb036e0a5f8730fd0175fcd2fd42d4156b05))
+* **api:** api update ([5b94819](https://github.com/context-dot-dev/context-python-sdk/commit/5b9481966d0e279462f6cdea930cd738871239ee))
+
 ## 0.27.0 (2026-05-31)
 
 Full Changelog: [v0.26.0...v0.27.0](https://github.com/context-dot-dev/context-python-sdk/compare/v0.26.0...v0.27.0)
diff --git a/pyproject.toml b/pyproject.toml
index aced26b..8cfb067 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "context.dev"
-version = "0.27.0"
+version = "0.28.0"
 description = "The official Python library for the context.dev API"
 dynamic = ["readme"]
 license = "Apache-2.0"
diff --git a/src/context/dev/_version.py b/src/context/dev/_version.py
index e1a2539..5d6e23e 100644
--- a/src/context/dev/_version.py
+++ b/src/context/dev/_version.py
@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "context.dev"
-__version__ = "0.27.0"  # x-release-please-version
+__version__ = "0.28.0"  # x-release-please-version