release: 0.35.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.34.0"
+  ".": "0.35.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 25
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-5a8e1f6e16ecdbab4b2ff14701779818fe0328b06a1c7fa44a32da4f4bc87a49.yml
-openapi_spec_hash: 4b5407859d1154232189ef440b783b17
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-b84f53b1a92511eff85645f287ec08d43adcdcc589367c015770bde836422a65.yml
+openapi_spec_hash: 71e317da7bc58cfc3bc2e4180f5b6267
 config_hash: f86a4e06ae5ed725aa79d58d7a8dc27c

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.35.0 (2026-06-11)
+
+Full Changelog: [v0.34.0...v0.35.0](https://github.com/context-dot-dev/context-python-sdk/compare/v0.34.0...v0.35.0)
+
+### Features
+
+* **api:** api update ([6721d0b](https://github.com/context-dot-dev/context-python-sdk/commit/6721d0bb8b04b536a28ebc5dfbda87358ccb2f2b))
+* **api:** api update ([713964b](https://github.com/context-dot-dev/context-python-sdk/commit/713964bbe1868905959b6758a3da528ded51316e))
+
 ## 0.34.0 (2026-06-08)
 
 Full Changelog: [v0.33.0...v0.34.0](https://github.com/context-dot-dev/context-python-sdk/compare/v0.33.0...v0.34.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "context.dev"
-version = "0.34.0"
+version = "0.35.0"
 description = "The official Python library for the context.dev API"
 dynamic = ["readme"]
 license = "Apache-2.0"

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.34.0"  # x-release-please-version
+__version__ = "0.35.0"  # x-release-please-version

src/context/dev/resources/web.py

@@ -76,6 +76,8 @@ def extract(
         include_frames: bool | Omit = omit,
         instructions: str | Omit = omit,
         max_age_ms: int | Omit = omit,
+        max_depth: int | Omit = omit,
+        max_pages: int | Omit = omit,
         pdf: web_extract_params.Pdf | Omit = omit,
         stop_after_ms: int | Omit = omit,
         timeout_ms: int | Omit = omit,
@@ -116,6 +118,11 @@ def extract(
           max_age_ms: Return cached scrape results if a prior scrape for the same parameters is
               younger than this many milliseconds. Defaults to 7 days (604800000 ms).
 
+          max_depth: Optional maximum link depth from the starting URL (0 = only the starting page).
+              If omitted, there is no crawl depth limit.
+
+          max_pages: Maximum number of pages to analyze for extraction. Hard cap: 50. Defaults to 5.
+
           stop_after_ms: Soft time budget for the crawl in milliseconds. Min: 10000 (10s). Max: 110000
               (110s). Default: 80000 (80s).
 
@@ -145,6 +152,8 @@ def extract(
                     "include_frames": include_frames,
                     "instructions": instructions,
                     "max_age_ms": max_age_ms,
+                    "max_depth": max_depth,
+                    "max_pages": max_pages,
                     "pdf": pdf,
                     "stop_after_ms": stop_after_ms,
                     "timeout_ms": timeout_ms,
@@ -985,6 +994,8 @@ async def extract(
         include_frames: bool | Omit = omit,
         instructions: str | Omit = omit,
         max_age_ms: int | Omit = omit,
+        max_depth: int | Omit = omit,
+        max_pages: int | Omit = omit,
         pdf: web_extract_params.Pdf | Omit = omit,
         stop_after_ms: int | Omit = omit,
         timeout_ms: int | Omit = omit,
@@ -1025,6 +1036,11 @@ async def extract(
           max_age_ms: Return cached scrape results if a prior scrape for the same parameters is
               younger than this many milliseconds. Defaults to 7 days (604800000 ms).
 
+          max_depth: Optional maximum link depth from the starting URL (0 = only the starting page).
+              If omitted, there is no crawl depth limit.
+
+          max_pages: Maximum number of pages to analyze for extraction. Hard cap: 50. Defaults to 5.
+
           stop_after_ms: Soft time budget for the crawl in milliseconds. Min: 10000 (10s). Max: 110000
               (110s). Default: 80000 (80s).
 
@@ -1054,6 +1070,8 @@ async def extract(
                     "include_frames": include_frames,
                     "instructions": instructions,
                     "max_age_ms": max_age_ms,
+                    "max_depth": max_depth,
+                    "max_pages": max_pages,
                     "pdf": pdf,
                     "stop_after_ms": stop_after_ms,
                     "timeout_ms": timeout_ms,

src/context/dev/types/ai_ai_query_response.py

@@ -4,7 +4,7 @@
 
 from .._models import BaseModel
 
-__all__ = ["AIAIQueryResponse", "DataExtracted"]
+__all__ = ["AIAIQueryResponse", "DataExtracted", "KeyMetadata"]
 
 
 class DataExtracted(BaseModel):
@@ -19,13 +19,33 @@ class DataExtracted(BaseModel):
     """
 
 
+class KeyMetadata(BaseModel):
+    """Metadata about the API key used for the request.
+
+    Included in every response whenever a valid API key is provided, even when the response status is not 200.
+    """
+
+    credits_consumed: int
+    """The number of credits consumed by this request."""
+
+    credits_remaining: int
+    """The number of credits remaining for your organization after this request."""
+
+
 class AIAIQueryResponse(BaseModel):
     data_extracted: Optional[List[DataExtracted]] = None
     """Array of extracted data points"""
 
     domain: Optional[str] = None
     """The domain that was analyzed"""
 
+    key_metadata: Optional[KeyMetadata] = None
+    """Metadata about the API key used for the request.
+
+    Included in every response whenever a valid API key is provided, even when the
+    response status is not 200.
+    """
+
     status: Optional[str] = None
     """Status of the response, e.g., 'ok'"""
 

src/context/dev/types/ai_extract_product_response.py

@@ -5,7 +5,20 @@
 
 from .._models import BaseModel
 
-__all__ = ["AIExtractProductResponse", "Product"]
+__all__ = ["AIExtractProductResponse", "KeyMetadata", "Product"]
+
+
+class KeyMetadata(BaseModel):
+    """Metadata about the API key used for the request.
+
+    Included in every response whenever a valid API key is provided, even when the response status is not 200.
+    """
+
+    credits_consumed: int
+    """The number of credits consumed by this request."""
+
+    credits_remaining: int
+    """The number of credits remaining for your organization after this request."""
 
 
 class Product(BaseModel):
@@ -58,6 +71,13 @@ class AIExtractProductResponse(BaseModel):
     is_product_page: Optional[bool] = None
     """Whether the given URL is a product detail page"""
 
+    key_metadata: Optional[KeyMetadata] = None
+    """Metadata about the API key used for the request.
+
+    Included in every response whenever a valid API key is provided, even when the
+    response status is not 200.
+    """
+
     platform: Optional[Literal["amazon", "tiktok_shop", "etsy", "generic"]] = None
     """The detected ecommerce platform, or null if not a product page"""
 

src/context/dev/types/ai_extract_products_response.py

@@ -5,7 +5,20 @@
 
 from .._models import BaseModel
 
-__all__ = ["AIExtractProductsResponse", "Product"]
+__all__ = ["AIExtractProductsResponse", "KeyMetadata", "Product"]
+
+
+class KeyMetadata(BaseModel):
+    """Metadata about the API key used for the request.
+
+    Included in every response whenever a valid API key is provided, even when the response status is not 200.
+    """
+
+    credits_consumed: int
+    """The number of credits consumed by this request."""
+
+    credits_remaining: int
+    """The number of credits remaining for your organization after this request."""
 
 
 class Product(BaseModel):
@@ -53,5 +66,12 @@ class Product(BaseModel):
 
 
 class AIExtractProductsResponse(BaseModel):
+    key_metadata: Optional[KeyMetadata] = None
+    """Metadata about the API key used for the request.
+
+    Included in every response whenever a valid API key is provided, even when the
+    response status is not 200.
+    """
+
     products: Optional[List[Product]] = None
     """Array of products extracted from the website"""

src/context/dev/types/brand_identify_from_transaction_response.py

@@ -21,6 +21,7 @@
     "BrandLogoResolution",
     "BrandSocial",
     "BrandStock",
+    "KeyMetadata",
 ]
 
 
@@ -650,12 +651,32 @@ class Brand(BaseModel):
     """The title or name of the brand"""
 
 
+class KeyMetadata(BaseModel):
+    """Metadata about the API key used for the request.
+
+    Included in every response whenever a valid API key is provided, even when the response status is not 200.
+    """
+
+    credits_consumed: int
+    """The number of credits consumed by this request."""
+
+    credits_remaining: int
+    """The number of credits remaining for your organization after this request."""
+
+
 class BrandIdentifyFromTransactionResponse(BaseModel):
     brand: Optional[Brand] = None
     """Detailed brand information"""
 
     code: Optional[int] = None
     """HTTP status code"""
 
+    key_metadata: Optional[KeyMetadata] = None
+    """Metadata about the API key used for the request.
+
+    Included in every response whenever a valid API key is provided, even when the
+    response status is not 200.
+    """
+
     status: Optional[str] = None
     """Status of the response, e.g., 'ok'"""

src/context/dev/types/brand_retrieve_by_email_response.py

@@ -21,6 +21,7 @@
     "BrandLogoResolution",
     "BrandSocial",
     "BrandStock",
+    "KeyMetadata",
 ]
 
 
@@ -650,12 +651,32 @@ class Brand(BaseModel):
     """The title or name of the brand"""
 
 
+class KeyMetadata(BaseModel):
+    """Metadata about the API key used for the request.
+
+    Included in every response whenever a valid API key is provided, even when the response status is not 200.
+    """
+
+    credits_consumed: int
+    """The number of credits consumed by this request."""
+
+    credits_remaining: int
+    """The number of credits remaining for your organization after this request."""
+
+
 class BrandRetrieveByEmailResponse(BaseModel):
     brand: Optional[Brand] = None
     """Detailed brand information"""
 
     code: Optional[int] = None
     """HTTP status code"""
 
+    key_metadata: Optional[KeyMetadata] = None
+    """Metadata about the API key used for the request.
+
+    Included in every response whenever a valid API key is provided, even when the
+    response status is not 200.
+    """
+
     status: Optional[str] = None
     """Status of the response, e.g., 'ok'"""

src/context/dev/types/brand_retrieve_by_isin_response.py

@@ -21,6 +21,7 @@
     "BrandLogoResolution",
     "BrandSocial",
     "BrandStock",
+    "KeyMetadata",
 ]
 
 
@@ -650,12 +651,32 @@ class Brand(BaseModel):
     """The title or name of the brand"""
 
 
+class KeyMetadata(BaseModel):
+    """Metadata about the API key used for the request.
+
+    Included in every response whenever a valid API key is provided, even when the response status is not 200.
+    """
+
+    credits_consumed: int
+    """The number of credits consumed by this request."""
+
+    credits_remaining: int
+    """The number of credits remaining for your organization after this request."""
+
+
 class BrandRetrieveByIsinResponse(BaseModel):
     brand: Optional[Brand] = None
     """Detailed brand information"""
 
     code: Optional[int] = None
     """HTTP status code"""
 
+    key_metadata: Optional[KeyMetadata] = None
+    """Metadata about the API key used for the request.
+
+    Included in every response whenever a valid API key is provided, even when the
+    response status is not 200.
+    """
+
     status: Optional[str] = None
     """Status of the response, e.g., 'ok'"""

src/context/dev/types/brand_retrieve_by_name_response.py

@@ -21,6 +21,7 @@
     "BrandLogoResolution",
     "BrandSocial",
     "BrandStock",
+    "KeyMetadata",
 ]
 
 
@@ -650,12 +651,32 @@ class Brand(BaseModel):
     """The title or name of the brand"""
 
 
+class KeyMetadata(BaseModel):
+    """Metadata about the API key used for the request.
+
+    Included in every response whenever a valid API key is provided, even when the response status is not 200.
+    """
+
+    credits_consumed: int
+    """The number of credits consumed by this request."""
+
+    credits_remaining: int
+    """The number of credits remaining for your organization after this request."""
+
+
 class BrandRetrieveByNameResponse(BaseModel):
     brand: Optional[Brand] = None
     """Detailed brand information"""
 
     code: Optional[int] = None
     """HTTP status code"""
 
+    key_metadata: Optional[KeyMetadata] = None
+    """Metadata about the API key used for the request.
+
+    Included in every response whenever a valid API key is provided, even when the
+    response status is not 200.
+    """
+
     status: Optional[str] = None
     """Status of the response, e.g., 'ok'"""