diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index d0ab664..2a8f4ff 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "1.2.0"
+  ".": "1.3.0"
 }
\ No newline at end of file
diff --git a/.stats.yml b/.stats.yml
index e34b116..9dc6067 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 25
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-4903d5902cec6a80f42b9adaa9cf0defa9805ff22d7ae96970d209a4f867e195.yml
-openapi_spec_hash: 1097891c23530dfe0155f23170daf973
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-d3da262409c68576e457536f6c0e7ecc538219e0af19df415111c18f8fe92cfd.yml
+openapi_spec_hash: 25009575202702d24bc6672472eb8506
 config_hash: c7b0cdaba3b9797b77efd89e1754d803
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2b03d82..d98c81a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,14 @@
 # Changelog
 
+## 1.3.0 (2026-06-26)
+
+Full Changelog: [v1.2.0...v1.3.0](https://github.com/context-dot-dev/context-php-sdk/compare/v1.2.0...v1.3.0)
+
+### Features
+
+* **api:** api update ([df50f08](https://github.com/context-dot-dev/context-php-sdk/commit/df50f08fb5e0eb21378598088d745bc3ebd6b1dd))
+* **api:** api update ([8d1b848](https://github.com/context-dot-dev/context-php-sdk/commit/8d1b84827184cc37a49fa3c532e21c16fa7dbc47))
+
 ## 1.2.0 (2026-06-25)
 
 Full Changelog: [v1.1.0...v1.2.0](https://github.com/context-dot-dev/context-php-sdk/compare/v1.1.0...v1.2.0)
diff --git a/README.md b/README.md
index ee10b94..bf4e14c 100644
--- a/README.md
+++ b/README.md
@@ -13,7 +13,7 @@ The REST API documentation can be found on [docs.context.dev](https://docs.conte
 <!-- x-release-please-start-version -->
 
 ```
-composer require "context-dev/context-dev-php 1.2.0"
+composer require "context-dev/context-dev-php 1.3.0"
 ```
 
 <!-- x-release-please-end -->
diff --git a/src/ServiceContracts/WebContract.php b/src/ServiceContracts/WebContract.php
index b6b0288..14a1f55 100644
--- a/src/ServiceContracts/WebContract.php
+++ b/src/ServiceContracts/WebContract.php
@@ -11,6 +11,7 @@
 use ContextDev\Web\WebExtractParams\Pdf;
 use ContextDev\Web\WebExtractResponse;
 use ContextDev\Web\WebExtractStyleguideResponse;
+use ContextDev\Web\WebScreenshotParams\Country;
 use ContextDev\Web\WebScreenshotParams\FullScreenshot;
 use ContextDev\Web\WebScreenshotParams\HandleCookiePopup;
 use ContextDev\Web\WebScreenshotParams\Page;
@@ -133,6 +134,7 @@ public function extractStyleguide(
     /**
      * @api
      *
+     * @param Country|value-of<Country> $country Two-letter ISO 3166-1 alpha-2 country code for the website request location. When provided, Context.dev fetches the target page from that country.
      * @param string $directURL A specific URL to screenshot directly, bypassing domain resolution (e.g., 'https://example.com/pricing'). When provided, the screenshot is taken of this exact URL. You must provide either 'domain' or 'directUrl', but not both.
      * @param string $domain Domain name to take screenshot of (e.g., 'example.com', 'google.com'). The domain will be automatically normalized and validated. You must provide either 'domain' or 'directUrl', but not both.
      * @param FullScreenshot|value-of<FullScreenshot> $fullScreenshot Optional parameter to determine screenshot type. If 'true', takes a full page screenshot capturing all content. If 'false' or not provided, takes a viewport screenshot (standard browser view).
@@ -148,6 +150,7 @@ public function extractStyleguide(
      * @throws APIException
      */
     public function screenshot(
+        Country|string|null $country = null,
         ?string $directURL = null,
         ?string $domain = null,
         FullScreenshot|string|null $fullScreenshot = null,
@@ -164,11 +167,13 @@ public function screenshot(
     /**
      * @api
      *
-     * @param string $query natural-language search query
+     * @param string $query Search query. Accepts natural language as well as Google-style search operators such as `site:`, `-site:`, `inurl:`, `intitle:`, quoted phrases, and `OR`.
+     * @param \ContextDev\Web\WebSearchParams\Country|value-of<\ContextDev\Web\WebSearchParams\Country> $country Two-letter ISO 3166-1 alpha-2 country code to localize results to a specific country (maps to Google's `gl` parameter). Example: "us", "gb", "de".
      * @param list<string> $excludeDomains Blocklist — drop results from these domains. Example: ["pinterest.com", "reddit.com"].
      * @param Freshness|value-of<Freshness> $freshness restrict results to content published within this window
      * @param list<string> $includeDomains Allowlist — only return results from these domains. Example: ["arxiv.org", "github.com"].
      * @param MarkdownOptions|MarkdownOptionsShape $markdownOptions Inline Markdown scraping for each result. Set `enabled: true` to activate.
+     * @param int $numResults Number of results to request and return (10–100). Defaults to 10.
      * @param bool $queryFanout expand the query into multiple parallel variants for broader recall
      * @param int $timeoutMs Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes).
      * @param RequestOpts|null $requestOptions
@@ -177,10 +182,12 @@ public function screenshot(
      */
     public function search(
         string $query,
+        \ContextDev\Web\WebSearchParams\Country|string|null $country = null,
         ?array $excludeDomains = null,
         Freshness|string|null $freshness = null,
         ?array $includeDomains = null,
         MarkdownOptions|array|null $markdownOptions = null,
+        int $numResults = 10,
         ?bool $queryFanout = null,
         ?int $timeoutMs = null,
         RequestOptions|array|null $requestOptions = null,
@@ -190,6 +197,7 @@ public function search(
      * @api
      *
      * @param string $url The starting URL for the crawl (must include http:// or https:// protocol)
+     * @param \ContextDev\Web\WebWebCrawlMdParams\Country|value-of<\ContextDev\Web\WebWebCrawlMdParams\Country> $country Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev residential proxy exit location. Must be one of Context.dev's supported countries. When provided, Context.dev fetches the target page from that country.
      * @param list<string> $excludeSelectors CSS selectors to remove before each crawled page is converted to Markdown. Applied after includeSelectors. Exclusion takes precedence: an element matching both is removed. Examples: "nav", "footer", ".ad-banner", "[aria-hidden=true]".
      * @param bool $followSubdomains When true, follow links on subdomains of the starting URL's domain (e.g. docs.example.com when starting from example.com). www and apex are always treated as equivalent.
      * @param bool $includeFrames when true, the contents of iframes are rendered to Markdown for each crawled page
@@ -212,6 +220,7 @@ public function search(
      */
     public function webCrawlMd(
         string $url,
+        \ContextDev\Web\WebWebCrawlMdParams\Country|string|null $country = null,
         ?array $excludeSelectors = null,
         bool $followSubdomains = false,
         bool $includeFrames = false,
@@ -237,6 +246,7 @@ public function webCrawlMd(
      * @api
      *
      * @param string $url Full URL to scrape (must include http:// or https:// protocol)
+     * @param \ContextDev\Web\WebWebScrapeHTMLParams\Country|value-of<\ContextDev\Web\WebWebScrapeHTMLParams\Country> $country Two-letter ISO 3166-1 alpha-2 country code for the website request location. When provided, Context.dev fetches the target page from that country.
      * @param list<string> $excludeSelectors CSS selectors to remove from the result. Applied after includeSelectors. Exclusion takes precedence: an element matching both is removed. Examples: "nav", "footer", ".ad-banner", "[aria-hidden=true]".
      * @param array<string,string> $headers Optional outbound HTTP headers forwarded only to the target URL, sent as deep-object query params such as headers[X-Custom]=value. When provided, caching is bypassed: the result is neither read from nor written to cache.
      * @param bool $includeFrames when true, iframes are rendered inline into the returned HTML
@@ -252,6 +262,7 @@ public function webCrawlMd(
      */
     public function webScrapeHTML(
         string $url,
+        \ContextDev\Web\WebWebScrapeHTMLParams\Country|string|null $country = null,
         ?array $excludeSelectors = null,
         ?array $headers = null,
         bool $includeFrames = false,
@@ -293,6 +304,7 @@ public function webScrapeImages(
      * @api
      *
      * @param string $url Full URL to scrape into LLM usable Markdown (must include http:// or https:// protocol)
+     * @param \ContextDev\Web\WebWebScrapeMdParams\Country|value-of<\ContextDev\Web\WebWebScrapeMdParams\Country> $country Two-letter ISO 3166-1 alpha-2 country code for the website request location. When provided, Context.dev fetches the target page from that country.
      * @param list<string> $excludeSelectors CSS selectors to remove before conversion to Markdown. Applied after includeSelectors. Exclusion takes precedence: an element matching both is removed. Examples: "nav", "footer", ".ad-banner", "[aria-hidden=true]".
      * @param array<string,string> $headers Optional outbound HTTP headers forwarded only to the target URL, sent as deep-object query params such as headers[X-Custom]=value. When provided, caching is bypassed: the result is neither read from nor written to cache.
      * @param bool $includeFrames when true, the contents of iframes are rendered to Markdown
@@ -311,6 +323,7 @@ public function webScrapeImages(
      */
     public function webScrapeMd(
         string $url,
+        \ContextDev\Web\WebWebScrapeMdParams\Country|string|null $country = null,
         ?array $excludeSelectors = null,
         ?array $headers = null,
         bool $includeFrames = false,
diff --git a/src/Services/WebRawService.php b/src/Services/WebRawService.php
index c6f0459..6505344 100644
--- a/src/Services/WebRawService.php
+++ b/src/Services/WebRawService.php
@@ -20,6 +20,7 @@
 use ContextDev\Web\WebExtractStyleguideParams;
 use ContextDev\Web\WebExtractStyleguideResponse;
 use ContextDev\Web\WebScreenshotParams;
+use ContextDev\Web\WebScreenshotParams\Country;
 use ContextDev\Web\WebScreenshotParams\FullScreenshot;
 use ContextDev\Web\WebScreenshotParams\HandleCookiePopup;
 use ContextDev\Web\WebScreenshotParams\Page;
@@ -215,6 +216,7 @@ public function extractStyleguide(
      * Capture a screenshot of a website.
      *
      * @param array{
+     *   country?: value-of<Country>,
      *   directURL?: string,
      *   domain?: string,
      *   fullScreenshot?: FullScreenshot|value-of<FullScreenshot>,
@@ -261,10 +263,12 @@ public function screenshot(
      *
      * @param array{
      *   query: string,
+     *   country?: value-of<WebSearchParams\Country>,
      *   excludeDomains?: list<string>,
      *   freshness?: Freshness|value-of<Freshness>,
      *   includeDomains?: list<string>,
      *   markdownOptions?: MarkdownOptions|MarkdownOptionsShape,
+     *   numResults?: int,
      *   queryFanout?: bool,
      *   timeoutMs?: int,
      * }|WebSearchParams $params
@@ -300,6 +304,7 @@ public function search(
      *
      * @param array{
      *   url: string,
+     *   country?: value-of<WebWebCrawlMdParams\Country>,
      *   excludeSelectors?: list<string>,
      *   followSubdomains?: bool,
      *   includeFrames?: bool,
@@ -349,6 +354,7 @@ public function webCrawlMd(
      *
      * @param array{
      *   url: string,
+     *   country?: value-of<WebWebScrapeHTMLParams\Country>,
      *   excludeSelectors?: list<string>,
      *   headers?: array<string,string>,
      *   includeFrames?: bool,
@@ -429,6 +435,7 @@ public function webScrapeImages(
      *
      * @param array{
      *   url: string,
+     *   country?: value-of<WebWebScrapeMdParams\Country>,
      *   excludeSelectors?: list<string>,
      *   headers?: array<string,string>,
      *   includeFrames?: bool,
diff --git a/src/Services/WebService.php b/src/Services/WebService.php
index 224efa2..84a997a 100644
--- a/src/Services/WebService.php
+++ b/src/Services/WebService.php
@@ -14,6 +14,7 @@
 use ContextDev\Web\WebExtractParams\Pdf;
 use ContextDev\Web\WebExtractResponse;
 use ContextDev\Web\WebExtractStyleguideResponse;
+use ContextDev\Web\WebScreenshotParams\Country;
 use ContextDev\Web\WebScreenshotParams\FullScreenshot;
 use ContextDev\Web\WebScreenshotParams\HandleCookiePopup;
 use ContextDev\Web\WebScreenshotParams\Page;
@@ -223,6 +224,7 @@ public function extractStyleguide(
      *
      * Capture a screenshot of a website.
      *
+     * @param Country|value-of<Country> $country Two-letter ISO 3166-1 alpha-2 country code for the website request location. When provided, Context.dev fetches the target page from that country.
      * @param string $directURL A specific URL to screenshot directly, bypassing domain resolution (e.g., 'https://example.com/pricing'). When provided, the screenshot is taken of this exact URL. You must provide either 'domain' or 'directUrl', but not both.
      * @param string $domain Domain name to take screenshot of (e.g., 'example.com', 'google.com'). The domain will be automatically normalized and validated. You must provide either 'domain' or 'directUrl', but not both.
      * @param FullScreenshot|value-of<FullScreenshot> $fullScreenshot Optional parameter to determine screenshot type. If 'true', takes a full page screenshot capturing all content. If 'false' or not provided, takes a viewport screenshot (standard browser view).
@@ -238,6 +240,7 @@ public function extractStyleguide(
      * @throws APIException
      */
     public function screenshot(
+        Country|string|null $country = null,
         ?string $directURL = null,
         ?string $domain = null,
         FullScreenshot|string|null $fullScreenshot = null,
@@ -252,6 +255,7 @@ public function screenshot(
     ): WebScreenshotResponse {
         $params = Util::removeNulls(
             [
+                'country' => $country,
                 'directURL' => $directURL,
                 'domain' => $domain,
                 'fullScreenshot' => $fullScreenshot,
@@ -276,11 +280,13 @@ public function screenshot(
      *
      * Search the web and optionally scrape each result to Markdown in one round-trip.
      *
-     * @param string $query natural-language search query
+     * @param string $query Search query. Accepts natural language as well as Google-style search operators such as `site:`, `-site:`, `inurl:`, `intitle:`, quoted phrases, and `OR`.
+     * @param \ContextDev\Web\WebSearchParams\Country|value-of<\ContextDev\Web\WebSearchParams\Country> $country Two-letter ISO 3166-1 alpha-2 country code to localize results to a specific country (maps to Google's `gl` parameter). Example: "us", "gb", "de".
      * @param list<string> $excludeDomains Blocklist — drop results from these domains. Example: ["pinterest.com", "reddit.com"].
      * @param Freshness|value-of<Freshness> $freshness restrict results to content published within this window
      * @param list<string> $includeDomains Allowlist — only return results from these domains. Example: ["arxiv.org", "github.com"].
      * @param MarkdownOptions|MarkdownOptionsShape $markdownOptions Inline Markdown scraping for each result. Set `enabled: true` to activate.
+     * @param int $numResults Number of results to request and return (10–100). Defaults to 10.
      * @param bool $queryFanout expand the query into multiple parallel variants for broader recall
      * @param int $timeoutMs Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes).
      * @param RequestOpts|null $requestOptions
@@ -289,10 +295,12 @@ public function screenshot(
      */
     public function search(
         string $query,
+        \ContextDev\Web\WebSearchParams\Country|string|null $country = null,
         ?array $excludeDomains = null,
         Freshness|string|null $freshness = null,
         ?array $includeDomains = null,
         MarkdownOptions|array|null $markdownOptions = null,
+        int $numResults = 10,
         ?bool $queryFanout = null,
         ?int $timeoutMs = null,
         RequestOptions|array|null $requestOptions = null,
@@ -300,10 +308,12 @@ public function search(
         $params = Util::removeNulls(
             [
                 'query' => $query,
+                'country' => $country,
                 'excludeDomains' => $excludeDomains,
                 'freshness' => $freshness,
                 'includeDomains' => $includeDomains,
                 'markdownOptions' => $markdownOptions,
+                'numResults' => $numResults,
                 'queryFanout' => $queryFanout,
                 'timeoutMs' => $timeoutMs,
             ],
@@ -321,6 +331,7 @@ public function search(
      * Performs a crawl starting from a given URL, extracts page content as Markdown, and returns results for all crawled pages.
      *
      * @param string $url The starting URL for the crawl (must include http:// or https:// protocol)
+     * @param \ContextDev\Web\WebWebCrawlMdParams\Country|value-of<\ContextDev\Web\WebWebCrawlMdParams\Country> $country Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev residential proxy exit location. Must be one of Context.dev's supported countries. When provided, Context.dev fetches the target page from that country.
      * @param list<string> $excludeSelectors CSS selectors to remove before each crawled page is converted to Markdown. Applied after includeSelectors. Exclusion takes precedence: an element matching both is removed. Examples: "nav", "footer", ".ad-banner", "[aria-hidden=true]".
      * @param bool $followSubdomains When true, follow links on subdomains of the starting URL's domain (e.g. docs.example.com when starting from example.com). www and apex are always treated as equivalent.
      * @param bool $includeFrames when true, the contents of iframes are rendered to Markdown for each crawled page
@@ -343,6 +354,7 @@ public function search(
      */
     public function webCrawlMd(
         string $url,
+        \ContextDev\Web\WebWebCrawlMdParams\Country|string|null $country = null,
         ?array $excludeSelectors = null,
         bool $followSubdomains = false,
         bool $includeFrames = false,
@@ -366,6 +378,7 @@ public function webCrawlMd(
         $params = Util::removeNulls(
             [
                 'url' => $url,
+                'country' => $country,
                 'excludeSelectors' => $excludeSelectors,
                 'followSubdomains' => $followSubdomains,
                 'includeFrames' => $includeFrames,
@@ -397,6 +410,7 @@ public function webCrawlMd(
      * Scrapes the given URL and returns the raw HTML content of the page.
      *
      * @param string $url Full URL to scrape (must include http:// or https:// protocol)
+     * @param \ContextDev\Web\WebWebScrapeHTMLParams\Country|value-of<\ContextDev\Web\WebWebScrapeHTMLParams\Country> $country Two-letter ISO 3166-1 alpha-2 country code for the website request location. When provided, Context.dev fetches the target page from that country.
      * @param list<string> $excludeSelectors CSS selectors to remove from the result. Applied after includeSelectors. Exclusion takes precedence: an element matching both is removed. Examples: "nav", "footer", ".ad-banner", "[aria-hidden=true]".
      * @param array<string,string> $headers Optional outbound HTTP headers forwarded only to the target URL, sent as deep-object query params such as headers[X-Custom]=value. When provided, caching is bypassed: the result is neither read from nor written to cache.
      * @param bool $includeFrames when true, iframes are rendered inline into the returned HTML
@@ -412,6 +426,7 @@ public function webCrawlMd(
      */
     public function webScrapeHTML(
         string $url,
+        \ContextDev\Web\WebWebScrapeHTMLParams\Country|string|null $country = null,
         ?array $excludeSelectors = null,
         ?array $headers = null,
         bool $includeFrames = false,
@@ -428,6 +443,7 @@ public function webScrapeHTML(
         $params = Util::removeNulls(
             [
                 'url' => $url,
+                'country' => $country,
                 'excludeSelectors' => $excludeSelectors,
                 'headers' => $headers,
                 'includeFrames' => $includeFrames,
@@ -493,6 +509,7 @@ public function webScrapeImages(
      * Scrapes the given URL into LLM usable Markdown.
      *
      * @param string $url Full URL to scrape into LLM usable Markdown (must include http:// or https:// protocol)
+     * @param \ContextDev\Web\WebWebScrapeMdParams\Country|value-of<\ContextDev\Web\WebWebScrapeMdParams\Country> $country Two-letter ISO 3166-1 alpha-2 country code for the website request location. When provided, Context.dev fetches the target page from that country.
      * @param list<string> $excludeSelectors CSS selectors to remove before conversion to Markdown. Applied after includeSelectors. Exclusion takes precedence: an element matching both is removed. Examples: "nav", "footer", ".ad-banner", "[aria-hidden=true]".
      * @param array<string,string> $headers Optional outbound HTTP headers forwarded only to the target URL, sent as deep-object query params such as headers[X-Custom]=value. When provided, caching is bypassed: the result is neither read from nor written to cache.
      * @param bool $includeFrames when true, the contents of iframes are rendered to Markdown
@@ -511,6 +528,7 @@ public function webScrapeImages(
      */
     public function webScrapeMd(
         string $url,
+        \ContextDev\Web\WebWebScrapeMdParams\Country|string|null $country = null,
         ?array $excludeSelectors = null,
         ?array $headers = null,
         bool $includeFrames = false,
@@ -530,6 +548,7 @@ public function webScrapeMd(
         $params = Util::removeNulls(
             [
                 'url' => $url,
+                'country' => $country,
                 'excludeSelectors' => $excludeSelectors,
                 'headers' => $headers,
                 'includeFrames' => $includeFrames,
diff --git a/src/Version.php b/src/Version.php
index 664fee6..348143f 100644
--- a/src/Version.php
+++ b/src/Version.php
@@ -5,5 +5,5 @@
 namespace ContextDev;
 
 // x-release-please-start-version
-const VERSION = '1.2.0';
+const VERSION = '1.3.0';
 // x-release-please-end
diff --git a/src/Web/WebScreenshotParams.php b/src/Web/WebScreenshotParams.php
index 56d3b65..e0385ee 100644
--- a/src/Web/WebScreenshotParams.php
+++ b/src/Web/WebScreenshotParams.php
@@ -8,6 +8,7 @@
 use ContextDev\Core\Concerns\SdkModel;
 use ContextDev\Core\Concerns\SdkParams;
 use ContextDev\Core\Contracts\BaseModel;
+use ContextDev\Web\WebScreenshotParams\Country;
 use ContextDev\Web\WebScreenshotParams\FullScreenshot;
 use ContextDev\Web\WebScreenshotParams\HandleCookiePopup;
 use ContextDev\Web\WebScreenshotParams\Page;
@@ -21,6 +22,7 @@
  * @phpstan-import-type ViewportShape from \ContextDev\Web\WebScreenshotParams\Viewport
  *
  * @phpstan-type WebScreenshotParamsShape = array{
+ *   country?: null|Country|value-of<Country>,
  *   directURL?: string|null,
  *   domain?: string|null,
  *   fullScreenshot?: null|FullScreenshot|value-of<FullScreenshot>,
@@ -39,6 +41,14 @@ final class WebScreenshotParams implements BaseModel
     use SdkModel;
     use SdkParams;
 
+    /**
+     * Two-letter ISO 3166-1 alpha-2 country code for the website request location. When provided, Context.dev fetches the target page from that country.
+     *
+     * @var value-of<Country>|null $country
+     */
+    #[Optional(enum: Country::class)]
+    public ?string $country;
+
     /**
      * A specific URL to screenshot directly, bypassing domain resolution (e.g., 'https://example.com/pricing'). When provided, the screenshot is taken of this exact URL. You must provide either 'domain' or 'directUrl', but not both.
      */
@@ -115,12 +125,14 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
+     * @param Country|value-of<Country>|null $country
      * @param FullScreenshot|value-of<FullScreenshot>|null $fullScreenshot
      * @param HandleCookiePopup|value-of<HandleCookiePopup>|null $handleCookiePopup
      * @param Page|value-of<Page>|null $page
      * @param Viewport|ViewportShape|null $viewport
      */
     public static function with(
+        Country|string|null $country = null,
         ?string $directURL = null,
         ?string $domain = null,
         FullScreenshot|string|null $fullScreenshot = null,
@@ -134,6 +146,7 @@ public static function with(
     ): self {
         $self = new self;
 
+        null !== $country && $self['country'] = $country;
         null !== $directURL && $self['directURL'] = $directURL;
         null !== $domain && $self['domain'] = $domain;
         null !== $fullScreenshot && $self['fullScreenshot'] = $fullScreenshot;
@@ -148,6 +161,19 @@ public static function with(
         return $self;
     }
 
+    /**
+     * Two-letter ISO 3166-1 alpha-2 country code for the website request location. When provided, Context.dev fetches the target page from that country.
+     *
+     * @param Country|value-of<Country> $country
+     */
+    public function withCountry(Country|string $country): self
+    {
+        $self = clone $this;
+        $self['country'] = $country;
+
+        return $self;
+    }
+
     /**
      * A specific URL to screenshot directly, bypassing domain resolution (e.g., 'https://example.com/pricing'). When provided, the screenshot is taken of this exact URL. You must provide either 'domain' or 'directUrl', but not both.
      */
diff --git a/src/Web/WebScreenshotParams/Country.php b/src/Web/WebScreenshotParams/Country.php
new file mode 100644
index 0000000..912e435
--- /dev/null
+++ b/src/Web/WebScreenshotParams/Country.php
@@ -0,0 +1,419 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebScreenshotParams;
+
+/**
+ * Two-letter ISO 3166-1 alpha-2 country code for the website request location. When provided, Context.dev fetches the target page from that country.
+ */
+enum Country: string
+{
+    case AD = 'ad';
+
+    case AE = 'ae';
+
+    case AF = 'af';
+
+    case AG = 'ag';
+
+    case AI = 'ai';
+
+    case AL = 'al';
+
+    case AM = 'am';
+
+    case AO = 'ao';
+
+    case AR = 'ar';
+
+    case AT = 'at';
+
+    case AU = 'au';
+
+    case AW = 'aw';
+
+    case AZ = 'az';
+
+    case BA = 'ba';
+
+    case BB = 'bb';
+
+    case BD = 'bd';
+
+    case BE = 'be';
+
+    case BF = 'bf';
+
+    case BG = 'bg';
+
+    case BH = 'bh';
+
+    case BI = 'bi';
+
+    case BJ = 'bj';
+
+    case BM = 'bm';
+
+    case BN = 'bn';
+
+    case BO = 'bo';
+
+    case BQ = 'bq';
+
+    case BR = 'br';
+
+    case BS = 'bs';
+
+    case BW = 'bw';
+
+    case BY = 'by';
+
+    case BZ = 'bz';
+
+    case CA = 'ca';
+
+    case CD = 'cd';
+
+    case CF = 'cf';
+
+    case CG = 'cg';
+
+    case CH = 'ch';
+
+    case CI = 'ci';
+
+    case CL = 'cl';
+
+    case CM = 'cm';
+
+    case CN = 'cn';
+
+    case CO = 'co';
+
+    case CR = 'cr';
+
+    case CV = 'cv';
+
+    case CW = 'cw';
+
+    case CY = 'cy';
+
+    case CZ = 'cz';
+
+    case DE = 'de';
+
+    case DJ = 'dj';
+
+    case DK = 'dk';
+
+    case DM = 'dm';
+
+    case DO = 'do';
+
+    case DZ = 'dz';
+
+    case EC = 'ec';
+
+    case EE = 'ee';
+
+    case EG = 'eg';
+
+    case ES = 'es';
+
+    case ET = 'et';
+
+    case FI = 'fi';
+
+    case FJ = 'fj';
+
+    case FR = 'fr';
+
+    case GA = 'ga';
+
+    case GB = 'gb';
+
+    case GD = 'gd';
+
+    case GE = 'ge';
+
+    case GF = 'gf';
+
+    case GG = 'gg';
+
+    case GH = 'gh';
+
+    case GM = 'gm';
+
+    case GN = 'gn';
+
+    case GP = 'gp';
+
+    case GQ = 'gq';
+
+    case GR = 'gr';
+
+    case GT = 'gt';
+
+    case GU = 'gu';
+
+    case GW = 'gw';
+
+    case GY = 'gy';
+
+    case HK = 'hk';
+
+    case HN = 'hn';
+
+    case HR = 'hr';
+
+    case HT = 'ht';
+
+    case HU = 'hu';
+
+    case ID = 'id';
+
+    case IE = 'ie';
+
+    case IL = 'il';
+
+    case IM = 'im';
+
+    case IN = 'in';
+
+    case IQ = 'iq';
+
+    case IR = 'ir';
+
+    case IS = 'is';
+
+    case IT = 'it';
+
+    case JE = 'je';
+
+    case JM = 'jm';
+
+    case JO = 'jo';
+
+    case JP = 'jp';
+
+    case KE = 'ke';
+
+    case KG = 'kg';
+
+    case KH = 'kh';
+
+    case KN = 'kn';
+
+    case KR = 'kr';
+
+    case KW = 'kw';
+
+    case KY = 'ky';
+
+    case KZ = 'kz';
+
+    case LA = 'la';
+
+    case LB = 'lb';
+
+    case LC = 'lc';
+
+    case LK = 'lk';
+
+    case LR = 'lr';
+
+    case LS = 'ls';
+
+    case LT = 'lt';
+
+    case LU = 'lu';
+
+    case LV = 'lv';
+
+    case LY = 'ly';
+
+    case MA = 'ma';
+
+    case MC = 'mc';
+
+    case MD = 'md';
+
+    case ME = 'me';
+
+    case MF = 'mf';
+
+    case MG = 'mg';
+
+    case MK = 'mk';
+
+    case ML = 'ml';
+
+    case MM = 'mm';
+
+    case MN = 'mn';
+
+    case MO = 'mo';
+
+    case MQ = 'mq';
+
+    case MR = 'mr';
+
+    case MT = 'mt';
+
+    case MU = 'mu';
+
+    case MV = 'mv';
+
+    case MW = 'mw';
+
+    case MX = 'mx';
+
+    case MY = 'my';
+
+    case MZ = 'mz';
+
+    case NA = 'na';
+
+    case NC = 'nc';
+
+    case NE = 'ne';
+
+    case NG = 'ng';
+
+    case NI = 'ni';
+
+    case NL = 'nl';
+
+    case NO = 'no';
+
+    case NP = 'np';
+
+    case NZ = 'nz';
+
+    case OM = 'om';
+
+    case PA = 'pa';
+
+    case PE = 'pe';
+
+    case PF = 'pf';
+
+    case PG = 'pg';
+
+    case PH = 'ph';
+
+    case PK = 'pk';
+
+    case PL = 'pl';
+
+    case PR = 'pr';
+
+    case PS = 'ps';
+
+    case PT = 'pt';
+
+    case PY = 'py';
+
+    case QA = 'qa';
+
+    case RE = 're';
+
+    case RO = 'ro';
+
+    case RS = 'rs';
+
+    case RU = 'ru';
+
+    case RW = 'rw';
+
+    case SA = 'sa';
+
+    case SC = 'sc';
+
+    case SD = 'sd';
+
+    case SE = 'se';
+
+    case SG = 'sg';
+
+    case SI = 'si';
+
+    case SK = 'sk';
+
+    case SL = 'sl';
+
+    case SM = 'sm';
+
+    case SN = 'sn';
+
+    case SO = 'so';
+
+    case SR = 'sr';
+
+    case SS = 'ss';
+
+    case ST = 'st';
+
+    case SV = 'sv';
+
+    case SX = 'sx';
+
+    case SY = 'sy';
+
+    case SZ = 'sz';
+
+    case TC = 'tc';
+
+    case TD = 'td';
+
+    case TG = 'tg';
+
+    case TH = 'th';
+
+    case TJ = 'tj';
+
+    case TL = 'tl';
+
+    case TM = 'tm';
+
+    case TN = 'tn';
+
+    case TR = 'tr';
+
+    case TT = 'tt';
+
+    case TW = 'tw';
+
+    case TZ = 'tz';
+
+    case UA = 'ua';
+
+    case UG = 'ug';
+
+    case US = 'us';
+
+    case UY = 'uy';
+
+    case UZ = 'uz';
+
+    case VC = 'vc';
+
+    case VE = 've';
+
+    case VG = 'vg';
+
+    case VI = 'vi';
+
+    case VN = 'vn';
+
+    case YE = 'ye';
+
+    case YT = 'yt';
+
+    case ZA = 'za';
+
+    case ZM = 'zm';
+
+    case ZW = 'zw';
+}
diff --git a/src/Web/WebSearchParams.php b/src/Web/WebSearchParams.php
index d7257d0..82e5f48 100644
--- a/src/Web/WebSearchParams.php
+++ b/src/Web/WebSearchParams.php
@@ -9,6 +9,7 @@
 use ContextDev\Core\Concerns\SdkModel;
 use ContextDev\Core\Concerns\SdkParams;
 use ContextDev\Core\Contracts\BaseModel;
+use ContextDev\Web\WebSearchParams\Country;
 use ContextDev\Web\WebSearchParams\Freshness;
 use ContextDev\Web\WebSearchParams\MarkdownOptions;
 
@@ -21,10 +22,12 @@
  *
  * @phpstan-type WebSearchParamsShape = array{
  *   query: string,
+ *   country?: null|Country|value-of<Country>,
  *   excludeDomains?: list<string>|null,
  *   freshness?: null|Freshness|value-of<Freshness>,
  *   includeDomains?: list<string>|null,
  *   markdownOptions?: null|MarkdownOptions|MarkdownOptionsShape,
+ *   numResults?: int|null,
  *   queryFanout?: bool|null,
  *   timeoutMs?: int|null,
  * }
@@ -36,11 +39,19 @@ final class WebSearchParams implements BaseModel
     use SdkParams;
 
     /**
-     * Natural-language search query.
+     * Search query. Accepts natural language as well as Google-style search operators such as `site:`, `-site:`, `inurl:`, `intitle:`, quoted phrases, and `OR`.
      */
     #[Required]
     public string $query;
 
+    /**
+     * Two-letter ISO 3166-1 alpha-2 country code to localize results to a specific country (maps to Google's `gl` parameter). Example: "us", "gb", "de".
+     *
+     * @var value-of<Country>|null $country
+     */
+    #[Optional(enum: Country::class)]
+    public ?string $country;
+
     /**
      * Blocklist — drop results from these domains. Example: ["pinterest.com", "reddit.com"].
      *
@@ -71,6 +82,12 @@ final class WebSearchParams implements BaseModel
     #[Optional]
     public ?MarkdownOptions $markdownOptions;
 
+    /**
+     * Number of results to request and return (10–100). Defaults to 10.
+     */
+    #[Optional]
+    public ?int $numResults;
+
     /**
      * Expand the query into multiple parallel variants for broader recall.
      */
@@ -107,6 +124,7 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
+     * @param Country|value-of<Country>|null $country
      * @param list<string>|null $excludeDomains
      * @param Freshness|value-of<Freshness>|null $freshness
      * @param list<string>|null $includeDomains
@@ -114,10 +132,12 @@ public function __construct()
      */
     public static function with(
         string $query,
+        Country|string|null $country = null,
         ?array $excludeDomains = null,
         Freshness|string|null $freshness = null,
         ?array $includeDomains = null,
         MarkdownOptions|array|null $markdownOptions = null,
+        ?int $numResults = null,
         ?bool $queryFanout = null,
         ?int $timeoutMs = null,
     ): self {
@@ -125,10 +145,12 @@ public static function with(
 
         $self['query'] = $query;
 
+        null !== $country && $self['country'] = $country;
         null !== $excludeDomains && $self['excludeDomains'] = $excludeDomains;
         null !== $freshness && $self['freshness'] = $freshness;
         null !== $includeDomains && $self['includeDomains'] = $includeDomains;
         null !== $markdownOptions && $self['markdownOptions'] = $markdownOptions;
+        null !== $numResults && $self['numResults'] = $numResults;
         null !== $queryFanout && $self['queryFanout'] = $queryFanout;
         null !== $timeoutMs && $self['timeoutMs'] = $timeoutMs;
 
@@ -136,7 +158,7 @@ public static function with(
     }
 
     /**
-     * Natural-language search query.
+     * Search query. Accepts natural language as well as Google-style search operators such as `site:`, `-site:`, `inurl:`, `intitle:`, quoted phrases, and `OR`.
      */
     public function withQuery(string $query): self
     {
@@ -146,6 +168,19 @@ public function withQuery(string $query): self
         return $self;
     }
 
+    /**
+     * Two-letter ISO 3166-1 alpha-2 country code to localize results to a specific country (maps to Google's `gl` parameter). Example: "us", "gb", "de".
+     *
+     * @param Country|value-of<Country> $country
+     */
+    public function withCountry(Country|string $country): self
+    {
+        $self = clone $this;
+        $self['country'] = $country;
+
+        return $self;
+    }
+
     /**
      * Blocklist — drop results from these domains. Example: ["pinterest.com", "reddit.com"].
      *
@@ -199,6 +234,17 @@ public function withMarkdownOptions(
         return $self;
     }
 
+    /**
+     * Number of results to request and return (10–100). Defaults to 10.
+     */
+    public function withNumResults(int $numResults): self
+    {
+        $self = clone $this;
+        $self['numResults'] = $numResults;
+
+        return $self;
+    }
+
     /**
      * Expand the query into multiple parallel variants for broader recall.
      */
diff --git a/src/Web/WebSearchParams/Country.php b/src/Web/WebSearchParams/Country.php
new file mode 100644
index 0000000..4b7a183
--- /dev/null
+++ b/src/Web/WebSearchParams/Country.php
@@ -0,0 +1,489 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebSearchParams;
+
+/**
+ * Two-letter ISO 3166-1 alpha-2 country code to localize results to a specific country (maps to Google's `gl` parameter). Example: "us", "gb", "de".
+ */
+enum Country: string
+{
+    case AF = 'af';
+
+    case AL = 'al';
+
+    case DZ = 'dz';
+
+    case AS = 'as';
+
+    case AD = 'ad';
+
+    case AO = 'ao';
+
+    case AI = 'ai';
+
+    case AQ = 'aq';
+
+    case AG = 'ag';
+
+    case AR = 'ar';
+
+    case AM = 'am';
+
+    case AW = 'aw';
+
+    case AU = 'au';
+
+    case AT = 'at';
+
+    case AZ = 'az';
+
+    case BS = 'bs';
+
+    case BH = 'bh';
+
+    case BD = 'bd';
+
+    case BB = 'bb';
+
+    case BY = 'by';
+
+    case BE = 'be';
+
+    case BZ = 'bz';
+
+    case BJ = 'bj';
+
+    case BM = 'bm';
+
+    case BT = 'bt';
+
+    case BO = 'bo';
+
+    case BA = 'ba';
+
+    case BW = 'bw';
+
+    case BV = 'bv';
+
+    case BR = 'br';
+
+    case IO = 'io';
+
+    case BN = 'bn';
+
+    case BG = 'bg';
+
+    case BF = 'bf';
+
+    case BI = 'bi';
+
+    case KH = 'kh';
+
+    case CM = 'cm';
+
+    case CA = 'ca';
+
+    case CV = 'cv';
+
+    case KY = 'ky';
+
+    case CF = 'cf';
+
+    case TD = 'td';
+
+    case CL = 'cl';
+
+    case CN = 'cn';
+
+    case CX = 'cx';
+
+    case CC = 'cc';
+
+    case CO = 'co';
+
+    case KM = 'km';
+
+    case CG = 'cg';
+
+    case CD = 'cd';
+
+    case CK = 'ck';
+
+    case CR = 'cr';
+
+    case CI = 'ci';
+
+    case HR = 'hr';
+
+    case CU = 'cu';
+
+    case CY = 'cy';
+
+    case CZ = 'cz';
+
+    case DK = 'dk';
+
+    case DJ = 'dj';
+
+    case DM = 'dm';
+
+    case DO = 'do';
+
+    case EC = 'ec';
+
+    case EG = 'eg';
+
+    case SV = 'sv';
+
+    case GQ = 'gq';
+
+    case ER = 'er';
+
+    case EE = 'ee';
+
+    case ET = 'et';
+
+    case FK = 'fk';
+
+    case FO = 'fo';
+
+    case FJ = 'fj';
+
+    case FI = 'fi';
+
+    case FR = 'fr';
+
+    case GF = 'gf';
+
+    case PF = 'pf';
+
+    case TF = 'tf';
+
+    case GA = 'ga';
+
+    case GM = 'gm';
+
+    case GE = 'ge';
+
+    case DE = 'de';
+
+    case GH = 'gh';
+
+    case GI = 'gi';
+
+    case GR = 'gr';
+
+    case GL = 'gl';
+
+    case GD = 'gd';
+
+    case GP = 'gp';
+
+    case GU = 'gu';
+
+    case GT = 'gt';
+
+    case GN = 'gn';
+
+    case GW = 'gw';
+
+    case GY = 'gy';
+
+    case HT = 'ht';
+
+    case HM = 'hm';
+
+    case VA = 'va';
+
+    case HN = 'hn';
+
+    case HK = 'hk';
+
+    case HU = 'hu';
+
+    case IS = 'is';
+
+    case IN = 'in';
+
+    case ID = 'id';
+
+    case IR = 'ir';
+
+    case IQ = 'iq';
+
+    case IE = 'ie';
+
+    case IL = 'il';
+
+    case IT = 'it';
+
+    case JM = 'jm';
+
+    case JP = 'jp';
+
+    case JO = 'jo';
+
+    case KZ = 'kz';
+
+    case KE = 'ke';
+
+    case KI = 'ki';
+
+    case KP = 'kp';
+
+    case KR = 'kr';
+
+    case KW = 'kw';
+
+    case KG = 'kg';
+
+    case LA = 'la';
+
+    case LV = 'lv';
+
+    case LB = 'lb';
+
+    case LS = 'ls';
+
+    case LR = 'lr';
+
+    case LY = 'ly';
+
+    case LI = 'li';
+
+    case LT = 'lt';
+
+    case LU = 'lu';
+
+    case MO = 'mo';
+
+    case MK = 'mk';
+
+    case MG = 'mg';
+
+    case MW = 'mw';
+
+    case MY = 'my';
+
+    case MV = 'mv';
+
+    case ML = 'ml';
+
+    case MT = 'mt';
+
+    case MH = 'mh';
+
+    case MQ = 'mq';
+
+    case MR = 'mr';
+
+    case MU = 'mu';
+
+    case YT = 'yt';
+
+    case MX = 'mx';
+
+    case FM = 'fm';
+
+    case MD = 'md';
+
+    case MC = 'mc';
+
+    case MN = 'mn';
+
+    case MS = 'ms';
+
+    case MA = 'ma';
+
+    case MZ = 'mz';
+
+    case MM = 'mm';
+
+    case NA = 'na';
+
+    case NR = 'nr';
+
+    case NP = 'np';
+
+    case NL = 'nl';
+
+    case AN = 'an';
+
+    case NC = 'nc';
+
+    case NZ = 'nz';
+
+    case NI = 'ni';
+
+    case NE = 'ne';
+
+    case NG = 'ng';
+
+    case NU = 'nu';
+
+    case NF = 'nf';
+
+    case MP = 'mp';
+
+    case NO = 'no';
+
+    case OM = 'om';
+
+    case PK = 'pk';
+
+    case PW = 'pw';
+
+    case PS = 'ps';
+
+    case PA = 'pa';
+
+    case PG = 'pg';
+
+    case PY = 'py';
+
+    case PE = 'pe';
+
+    case PH = 'ph';
+
+    case PN = 'pn';
+
+    case PL = 'pl';
+
+    case PT = 'pt';
+
+    case PR = 'pr';
+
+    case QA = 'qa';
+
+    case RE = 're';
+
+    case RO = 'ro';
+
+    case RU = 'ru';
+
+    case RW = 'rw';
+
+    case SH = 'sh';
+
+    case KN = 'kn';
+
+    case LC = 'lc';
+
+    case PM = 'pm';
+
+    case VC = 'vc';
+
+    case WS = 'ws';
+
+    case SM = 'sm';
+
+    case ST = 'st';
+
+    case SA = 'sa';
+
+    case SN = 'sn';
+
+    case RS = 'rs';
+
+    case SC = 'sc';
+
+    case SL = 'sl';
+
+    case SG = 'sg';
+
+    case SK = 'sk';
+
+    case SI = 'si';
+
+    case SB = 'sb';
+
+    case SO = 'so';
+
+    case ZA = 'za';
+
+    case GS = 'gs';
+
+    case ES = 'es';
+
+    case LK = 'lk';
+
+    case SD = 'sd';
+
+    case SR = 'sr';
+
+    case SJ = 'sj';
+
+    case SZ = 'sz';
+
+    case SE = 'se';
+
+    case CH = 'ch';
+
+    case SY = 'sy';
+
+    case TW = 'tw';
+
+    case TJ = 'tj';
+
+    case TZ = 'tz';
+
+    case TH = 'th';
+
+    case TL = 'tl';
+
+    case TG = 'tg';
+
+    case TK = 'tk';
+
+    case TO = 'to';
+
+    case TT = 'tt';
+
+    case TN = 'tn';
+
+    case TR = 'tr';
+
+    case TM = 'tm';
+
+    case TC = 'tc';
+
+    case TV = 'tv';
+
+    case UG = 'ug';
+
+    case UA = 'ua';
+
+    case AE = 'ae';
+
+    case GB = 'gb';
+
+    case US = 'us';
+
+    case UM = 'um';
+
+    case UY = 'uy';
+
+    case UZ = 'uz';
+
+    case VU = 'vu';
+
+    case VE = 've';
+
+    case VN = 'vn';
+
+    case VG = 'vg';
+
+    case VI = 'vi';
+
+    case WF = 'wf';
+
+    case EH = 'eh';
+
+    case YE = 'ye';
+
+    case ZM = 'zm';
+
+    case ZW = 'zw';
+}
diff --git a/src/Web/WebWebCrawlMdParams.php b/src/Web/WebWebCrawlMdParams.php
index 5722281..d08a8bd 100644
--- a/src/Web/WebWebCrawlMdParams.php
+++ b/src/Web/WebWebCrawlMdParams.php
@@ -9,6 +9,7 @@
 use ContextDev\Core\Concerns\SdkModel;
 use ContextDev\Core\Concerns\SdkParams;
 use ContextDev\Core\Contracts\BaseModel;
+use ContextDev\Web\WebWebCrawlMdParams\Country;
 use ContextDev\Web\WebWebCrawlMdParams\Pdf;
 
 /**
@@ -20,6 +21,7 @@
  *
  * @phpstan-type WebWebCrawlMdParamsShape = array{
  *   url: string,
+ *   country?: null|Country|value-of<Country>,
  *   excludeSelectors?: list<string>|null,
  *   followSubdomains?: bool|null,
  *   includeFrames?: bool|null,
@@ -50,6 +52,14 @@ final class WebWebCrawlMdParams implements BaseModel
     #[Required]
     public string $url;
 
+    /**
+     * Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev residential proxy exit location. Must be one of Context.dev's supported countries. When provided, Context.dev fetches the target page from that country.
+     *
+     * @var value-of<Country>|null $country
+     */
+    #[Optional(enum: Country::class)]
+    public ?string $country;
+
     /**
      * CSS selectors to remove before each crawled page is converted to Markdown. Applied after includeSelectors. Exclusion takes precedence: an element matching both is removed. Examples: "nav", "footer", ".ad-banner", "[aria-hidden=true]".
      *
@@ -174,12 +184,14 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
+     * @param Country|value-of<Country>|null $country
      * @param list<string>|null $excludeSelectors
      * @param list<string>|null $includeSelectors
      * @param Pdf|PdfShape|null $pdf
      */
     public static function with(
         string $url,
+        Country|string|null $country = null,
         ?array $excludeSelectors = null,
         ?bool $followSubdomains = null,
         ?bool $includeFrames = null,
@@ -201,6 +213,7 @@ public static function with(
 
         $self['url'] = $url;
 
+        null !== $country && $self['country'] = $country;
         null !== $excludeSelectors && $self['excludeSelectors'] = $excludeSelectors;
         null !== $followSubdomains && $self['followSubdomains'] = $followSubdomains;
         null !== $includeFrames && $self['includeFrames'] = $includeFrames;
@@ -232,6 +245,19 @@ public function withURL(string $url): self
         return $self;
     }
 
+    /**
+     * Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev residential proxy exit location. Must be one of Context.dev's supported countries. When provided, Context.dev fetches the target page from that country.
+     *
+     * @param Country|value-of<Country> $country
+     */
+    public function withCountry(Country|string $country): self
+    {
+        $self = clone $this;
+        $self['country'] = $country;
+
+        return $self;
+    }
+
     /**
      * CSS selectors to remove before each crawled page is converted to Markdown. Applied after includeSelectors. Exclusion takes precedence: an element matching both is removed. Examples: "nav", "footer", ".ad-banner", "[aria-hidden=true]".
      *
diff --git a/src/Web/WebWebCrawlMdParams/Country.php b/src/Web/WebWebCrawlMdParams/Country.php
new file mode 100644
index 0000000..e3c0594
--- /dev/null
+++ b/src/Web/WebWebCrawlMdParams/Country.php
@@ -0,0 +1,419 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebWebCrawlMdParams;
+
+/**
+ * Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev residential proxy exit location. Must be one of Context.dev's supported countries. When provided, Context.dev fetches the target page from that country.
+ */
+enum Country: string
+{
+    case AD = 'ad';
+
+    case AE = 'ae';
+
+    case AF = 'af';
+
+    case AG = 'ag';
+
+    case AI = 'ai';
+
+    case AL = 'al';
+
+    case AM = 'am';
+
+    case AO = 'ao';
+
+    case AR = 'ar';
+
+    case AT = 'at';
+
+    case AU = 'au';
+
+    case AW = 'aw';
+
+    case AZ = 'az';
+
+    case BA = 'ba';
+
+    case BB = 'bb';
+
+    case BD = 'bd';
+
+    case BE = 'be';
+
+    case BF = 'bf';
+
+    case BG = 'bg';
+
+    case BH = 'bh';
+
+    case BI = 'bi';
+
+    case BJ = 'bj';
+
+    case BM = 'bm';
+
+    case BN = 'bn';
+
+    case BO = 'bo';
+
+    case BQ = 'bq';
+
+    case BR = 'br';
+
+    case BS = 'bs';
+
+    case BW = 'bw';
+
+    case BY = 'by';
+
+    case BZ = 'bz';
+
+    case CA = 'ca';
+
+    case CD = 'cd';
+
+    case CF = 'cf';
+
+    case CG = 'cg';
+
+    case CH = 'ch';
+
+    case CI = 'ci';
+
+    case CL = 'cl';
+
+    case CM = 'cm';
+
+    case CN = 'cn';
+
+    case CO = 'co';
+
+    case CR = 'cr';
+
+    case CV = 'cv';
+
+    case CW = 'cw';
+
+    case CY = 'cy';
+
+    case CZ = 'cz';
+
+    case DE = 'de';
+
+    case DJ = 'dj';
+
+    case DK = 'dk';
+
+    case DM = 'dm';
+
+    case DO = 'do';
+
+    case DZ = 'dz';
+
+    case EC = 'ec';
+
+    case EE = 'ee';
+
+    case EG = 'eg';
+
+    case ES = 'es';
+
+    case ET = 'et';
+
+    case FI = 'fi';
+
+    case FJ = 'fj';
+
+    case FR = 'fr';
+
+    case GA = 'ga';
+
+    case GB = 'gb';
+
+    case GD = 'gd';
+
+    case GE = 'ge';
+
+    case GF = 'gf';
+
+    case GG = 'gg';
+
+    case GH = 'gh';
+
+    case GM = 'gm';
+
+    case GN = 'gn';
+
+    case GP = 'gp';
+
+    case GQ = 'gq';
+
+    case GR = 'gr';
+
+    case GT = 'gt';
+
+    case GU = 'gu';
+
+    case GW = 'gw';
+
+    case GY = 'gy';
+
+    case HK = 'hk';
+
+    case HN = 'hn';
+
+    case HR = 'hr';
+
+    case HT = 'ht';
+
+    case HU = 'hu';
+
+    case ID = 'id';
+
+    case IE = 'ie';
+
+    case IL = 'il';
+
+    case IM = 'im';
+
+    case IN = 'in';
+
+    case IQ = 'iq';
+
+    case IR = 'ir';
+
+    case IS = 'is';
+
+    case IT = 'it';
+
+    case JE = 'je';
+
+    case JM = 'jm';
+
+    case JO = 'jo';
+
+    case JP = 'jp';
+
+    case KE = 'ke';
+
+    case KG = 'kg';
+
+    case KH = 'kh';
+
+    case KN = 'kn';
+
+    case KR = 'kr';
+
+    case KW = 'kw';
+
+    case KY = 'ky';
+
+    case KZ = 'kz';
+
+    case LA = 'la';
+
+    case LB = 'lb';
+
+    case LC = 'lc';
+
+    case LK = 'lk';
+
+    case LR = 'lr';
+
+    case LS = 'ls';
+
+    case LT = 'lt';
+
+    case LU = 'lu';
+
+    case LV = 'lv';
+
+    case LY = 'ly';
+
+    case MA = 'ma';
+
+    case MC = 'mc';
+
+    case MD = 'md';
+
+    case ME = 'me';
+
+    case MF = 'mf';
+
+    case MG = 'mg';
+
+    case MK = 'mk';
+
+    case ML = 'ml';
+
+    case MM = 'mm';
+
+    case MN = 'mn';
+
+    case MO = 'mo';
+
+    case MQ = 'mq';
+
+    case MR = 'mr';
+
+    case MT = 'mt';
+
+    case MU = 'mu';
+
+    case MV = 'mv';
+
+    case MW = 'mw';
+
+    case MX = 'mx';
+
+    case MY = 'my';
+
+    case MZ = 'mz';
+
+    case NA = 'na';
+
+    case NC = 'nc';
+
+    case NE = 'ne';
+
+    case NG = 'ng';
+
+    case NI = 'ni';
+
+    case NL = 'nl';
+
+    case NO = 'no';
+
+    case NP = 'np';
+
+    case NZ = 'nz';
+
+    case OM = 'om';
+
+    case PA = 'pa';
+
+    case PE = 'pe';
+
+    case PF = 'pf';
+
+    case PG = 'pg';
+
+    case PH = 'ph';
+
+    case PK = 'pk';
+
+    case PL = 'pl';
+
+    case PR = 'pr';
+
+    case PS = 'ps';
+
+    case PT = 'pt';
+
+    case PY = 'py';
+
+    case QA = 'qa';
+
+    case RE = 're';
+
+    case RO = 'ro';
+
+    case RS = 'rs';
+
+    case RU = 'ru';
+
+    case RW = 'rw';
+
+    case SA = 'sa';
+
+    case SC = 'sc';
+
+    case SD = 'sd';
+
+    case SE = 'se';
+
+    case SG = 'sg';
+
+    case SI = 'si';
+
+    case SK = 'sk';
+
+    case SL = 'sl';
+
+    case SM = 'sm';
+
+    case SN = 'sn';
+
+    case SO = 'so';
+
+    case SR = 'sr';
+
+    case SS = 'ss';
+
+    case ST = 'st';
+
+    case SV = 'sv';
+
+    case SX = 'sx';
+
+    case SY = 'sy';
+
+    case SZ = 'sz';
+
+    case TC = 'tc';
+
+    case TD = 'td';
+
+    case TG = 'tg';
+
+    case TH = 'th';
+
+    case TJ = 'tj';
+
+    case TL = 'tl';
+
+    case TM = 'tm';
+
+    case TN = 'tn';
+
+    case TR = 'tr';
+
+    case TT = 'tt';
+
+    case TW = 'tw';
+
+    case TZ = 'tz';
+
+    case UA = 'ua';
+
+    case UG = 'ug';
+
+    case US = 'us';
+
+    case UY = 'uy';
+
+    case UZ = 'uz';
+
+    case VC = 'vc';
+
+    case VE = 've';
+
+    case VG = 'vg';
+
+    case VI = 'vi';
+
+    case VN = 'vn';
+
+    case YE = 'ye';
+
+    case YT = 'yt';
+
+    case ZA = 'za';
+
+    case ZM = 'zm';
+
+    case ZW = 'zw';
+}
diff --git a/src/Web/WebWebScrapeHTMLParams.php b/src/Web/WebWebScrapeHTMLParams.php
index cbe8261..785afc2 100644
--- a/src/Web/WebWebScrapeHTMLParams.php
+++ b/src/Web/WebWebScrapeHTMLParams.php
@@ -9,6 +9,7 @@
 use ContextDev\Core\Concerns\SdkModel;
 use ContextDev\Core\Concerns\SdkParams;
 use ContextDev\Core\Contracts\BaseModel;
+use ContextDev\Web\WebWebScrapeHTMLParams\Country;
 use ContextDev\Web\WebWebScrapeHTMLParams\Pdf;
 
 /**
@@ -20,6 +21,7 @@
  *
  * @phpstan-type WebWebScrapeHTMLParamsShape = array{
  *   url: string,
+ *   country?: null|Country|value-of<Country>,
  *   excludeSelectors?: list<string>|null,
  *   headers?: array<string,string>|null,
  *   includeFrames?: bool|null,
@@ -43,6 +45,14 @@ final class WebWebScrapeHTMLParams implements BaseModel
     #[Required]
     public string $url;
 
+    /**
+     * Two-letter ISO 3166-1 alpha-2 country code for the website request location. When provided, Context.dev fetches the target page from that country.
+     *
+     * @var value-of<Country>|null $country
+     */
+    #[Optional(enum: Country::class)]
+    public ?string $country;
+
     /**
      * CSS selectors to remove from the result. Applied after includeSelectors. Exclusion takes precedence: an element matching both is removed. Examples: "nav", "footer", ".ad-banner", "[aria-hidden=true]".
      *
@@ -127,6 +137,7 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
+     * @param Country|value-of<Country>|null $country
      * @param list<string>|null $excludeSelectors
      * @param array<string,string>|null $headers
      * @param list<string>|null $includeSelectors
@@ -134,6 +145,7 @@ public function __construct()
      */
     public static function with(
         string $url,
+        Country|string|null $country = null,
         ?array $excludeSelectors = null,
         ?array $headers = null,
         ?bool $includeFrames = null,
@@ -148,6 +160,7 @@ public static function with(
 
         $self['url'] = $url;
 
+        null !== $country && $self['country'] = $country;
         null !== $excludeSelectors && $self['excludeSelectors'] = $excludeSelectors;
         null !== $headers && $self['headers'] = $headers;
         null !== $includeFrames && $self['includeFrames'] = $includeFrames;
@@ -172,6 +185,19 @@ public function withURL(string $url): self
         return $self;
     }
 
+    /**
+     * Two-letter ISO 3166-1 alpha-2 country code for the website request location. When provided, Context.dev fetches the target page from that country.
+     *
+     * @param Country|value-of<Country> $country
+     */
+    public function withCountry(Country|string $country): self
+    {
+        $self = clone $this;
+        $self['country'] = $country;
+
+        return $self;
+    }
+
     /**
      * CSS selectors to remove from the result. Applied after includeSelectors. Exclusion takes precedence: an element matching both is removed. Examples: "nav", "footer", ".ad-banner", "[aria-hidden=true]".
      *
diff --git a/src/Web/WebWebScrapeHTMLParams/Country.php b/src/Web/WebWebScrapeHTMLParams/Country.php
new file mode 100644
index 0000000..6c784e4
--- /dev/null
+++ b/src/Web/WebWebScrapeHTMLParams/Country.php
@@ -0,0 +1,419 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebWebScrapeHTMLParams;
+
+/**
+ * Two-letter ISO 3166-1 alpha-2 country code for the website request location. When provided, Context.dev fetches the target page from that country.
+ */
+enum Country: string
+{
+    case AD = 'ad';
+
+    case AE = 'ae';
+
+    case AF = 'af';
+
+    case AG = 'ag';
+
+    case AI = 'ai';
+
+    case AL = 'al';
+
+    case AM = 'am';
+
+    case AO = 'ao';
+
+    case AR = 'ar';
+
+    case AT = 'at';
+
+    case AU = 'au';
+
+    case AW = 'aw';
+
+    case AZ = 'az';
+
+    case BA = 'ba';
+
+    case BB = 'bb';
+
+    case BD = 'bd';
+
+    case BE = 'be';
+
+    case BF = 'bf';
+
+    case BG = 'bg';
+
+    case BH = 'bh';
+
+    case BI = 'bi';
+
+    case BJ = 'bj';
+
+    case BM = 'bm';
+
+    case BN = 'bn';
+
+    case BO = 'bo';
+
+    case BQ = 'bq';
+
+    case BR = 'br';
+
+    case BS = 'bs';
+
+    case BW = 'bw';
+
+    case BY = 'by';
+
+    case BZ = 'bz';
+
+    case CA = 'ca';
+
+    case CD = 'cd';
+
+    case CF = 'cf';
+
+    case CG = 'cg';
+
+    case CH = 'ch';
+
+    case CI = 'ci';
+
+    case CL = 'cl';
+
+    case CM = 'cm';
+
+    case CN = 'cn';
+
+    case CO = 'co';
+
+    case CR = 'cr';
+
+    case CV = 'cv';
+
+    case CW = 'cw';
+
+    case CY = 'cy';
+
+    case CZ = 'cz';
+
+    case DE = 'de';
+
+    case DJ = 'dj';
+
+    case DK = 'dk';
+
+    case DM = 'dm';
+
+    case DO = 'do';
+
+    case DZ = 'dz';
+
+    case EC = 'ec';
+
+    case EE = 'ee';
+
+    case EG = 'eg';
+
+    case ES = 'es';
+
+    case ET = 'et';
+
+    case FI = 'fi';
+
+    case FJ = 'fj';
+
+    case FR = 'fr';
+
+    case GA = 'ga';
+
+    case GB = 'gb';
+
+    case GD = 'gd';
+
+    case GE = 'ge';
+
+    case GF = 'gf';
+
+    case GG = 'gg';
+
+    case GH = 'gh';
+
+    case GM = 'gm';
+
+    case GN = 'gn';
+
+    case GP = 'gp';
+
+    case GQ = 'gq';
+
+    case GR = 'gr';
+
+    case GT = 'gt';
+
+    case GU = 'gu';
+
+    case GW = 'gw';
+
+    case GY = 'gy';
+
+    case HK = 'hk';
+
+    case HN = 'hn';
+
+    case HR = 'hr';
+
+    case HT = 'ht';
+
+    case HU = 'hu';
+
+    case ID = 'id';
+
+    case IE = 'ie';
+
+    case IL = 'il';
+
+    case IM = 'im';
+
+    case IN = 'in';
+
+    case IQ = 'iq';
+
+    case IR = 'ir';
+
+    case IS = 'is';
+
+    case IT = 'it';
+
+    case JE = 'je';
+
+    case JM = 'jm';
+
+    case JO = 'jo';
+
+    case JP = 'jp';
+
+    case KE = 'ke';
+
+    case KG = 'kg';
+
+    case KH = 'kh';
+
+    case KN = 'kn';
+
+    case KR = 'kr';
+
+    case KW = 'kw';
+
+    case KY = 'ky';
+
+    case KZ = 'kz';
+
+    case LA = 'la';
+
+    case LB = 'lb';
+
+    case LC = 'lc';
+
+    case LK = 'lk';
+
+    case LR = 'lr';
+
+    case LS = 'ls';
+
+    case LT = 'lt';
+
+    case LU = 'lu';
+
+    case LV = 'lv';
+
+    case LY = 'ly';
+
+    case MA = 'ma';
+
+    case MC = 'mc';
+
+    case MD = 'md';
+
+    case ME = 'me';
+
+    case MF = 'mf';
+
+    case MG = 'mg';
+
+    case MK = 'mk';
+
+    case ML = 'ml';
+
+    case MM = 'mm';
+
+    case MN = 'mn';
+
+    case MO = 'mo';
+
+    case MQ = 'mq';
+
+    case MR = 'mr';
+
+    case MT = 'mt';
+
+    case MU = 'mu';
+
+    case MV = 'mv';
+
+    case MW = 'mw';
+
+    case MX = 'mx';
+
+    case MY = 'my';
+
+    case MZ = 'mz';
+
+    case NA = 'na';
+
+    case NC = 'nc';
+
+    case NE = 'ne';
+
+    case NG = 'ng';
+
+    case NI = 'ni';
+
+    case NL = 'nl';
+
+    case NO = 'no';
+
+    case NP = 'np';
+
+    case NZ = 'nz';
+
+    case OM = 'om';
+
+    case PA = 'pa';
+
+    case PE = 'pe';
+
+    case PF = 'pf';
+
+    case PG = 'pg';
+
+    case PH = 'ph';
+
+    case PK = 'pk';
+
+    case PL = 'pl';
+
+    case PR = 'pr';
+
+    case PS = 'ps';
+
+    case PT = 'pt';
+
+    case PY = 'py';
+
+    case QA = 'qa';
+
+    case RE = 're';
+
+    case RO = 'ro';
+
+    case RS = 'rs';
+
+    case RU = 'ru';
+
+    case RW = 'rw';
+
+    case SA = 'sa';
+
+    case SC = 'sc';
+
+    case SD = 'sd';
+
+    case SE = 'se';
+
+    case SG = 'sg';
+
+    case SI = 'si';
+
+    case SK = 'sk';
+
+    case SL = 'sl';
+
+    case SM = 'sm';
+
+    case SN = 'sn';
+
+    case SO = 'so';
+
+    case SR = 'sr';
+
+    case SS = 'ss';
+
+    case ST = 'st';
+
+    case SV = 'sv';
+
+    case SX = 'sx';
+
+    case SY = 'sy';
+
+    case SZ = 'sz';
+
+    case TC = 'tc';
+
+    case TD = 'td';
+
+    case TG = 'tg';
+
+    case TH = 'th';
+
+    case TJ = 'tj';
+
+    case TL = 'tl';
+
+    case TM = 'tm';
+
+    case TN = 'tn';
+
+    case TR = 'tr';
+
+    case TT = 'tt';
+
+    case TW = 'tw';
+
+    case TZ = 'tz';
+
+    case UA = 'ua';
+
+    case UG = 'ug';
+
+    case US = 'us';
+
+    case UY = 'uy';
+
+    case UZ = 'uz';
+
+    case VC = 'vc';
+
+    case VE = 've';
+
+    case VG = 'vg';
+
+    case VI = 'vi';
+
+    case VN = 'vn';
+
+    case YE = 'ye';
+
+    case YT = 'yt';
+
+    case ZA = 'za';
+
+    case ZM = 'zm';
+
+    case ZW = 'zw';
+}
diff --git a/src/Web/WebWebScrapeMdParams.php b/src/Web/WebWebScrapeMdParams.php
index 1efb700..54f2cc7 100644
--- a/src/Web/WebWebScrapeMdParams.php
+++ b/src/Web/WebWebScrapeMdParams.php
@@ -9,6 +9,7 @@
 use ContextDev\Core\Concerns\SdkModel;
 use ContextDev\Core\Concerns\SdkParams;
 use ContextDev\Core\Contracts\BaseModel;
+use ContextDev\Web\WebWebScrapeMdParams\Country;
 use ContextDev\Web\WebWebScrapeMdParams\Pdf;
 
 /**
@@ -20,6 +21,7 @@
  *
  * @phpstan-type WebWebScrapeMdParamsShape = array{
  *   url: string,
+ *   country?: null|Country|value-of<Country>,
  *   excludeSelectors?: list<string>|null,
  *   headers?: array<string,string>|null,
  *   includeFrames?: bool|null,
@@ -46,6 +48,14 @@ final class WebWebScrapeMdParams implements BaseModel
     #[Required]
     public string $url;
 
+    /**
+     * Two-letter ISO 3166-1 alpha-2 country code for the website request location. When provided, Context.dev fetches the target page from that country.
+     *
+     * @var value-of<Country>|null $country
+     */
+    #[Optional(enum: Country::class)]
+    public ?string $country;
+
     /**
      * CSS selectors to remove before conversion to Markdown. Applied after includeSelectors. Exclusion takes precedence: an element matching both is removed. Examples: "nav", "footer", ".ad-banner", "[aria-hidden=true]".
      *
@@ -148,6 +158,7 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
+     * @param Country|value-of<Country>|null $country
      * @param list<string>|null $excludeSelectors
      * @param array<string,string>|null $headers
      * @param list<string>|null $includeSelectors
@@ -155,6 +166,7 @@ public function __construct()
      */
     public static function with(
         string $url,
+        Country|string|null $country = null,
         ?array $excludeSelectors = null,
         ?array $headers = null,
         ?bool $includeFrames = null,
@@ -172,6 +184,7 @@ public static function with(
 
         $self['url'] = $url;
 
+        null !== $country && $self['country'] = $country;
         null !== $excludeSelectors && $self['excludeSelectors'] = $excludeSelectors;
         null !== $headers && $self['headers'] = $headers;
         null !== $includeFrames && $self['includeFrames'] = $includeFrames;
@@ -199,6 +212,19 @@ public function withURL(string $url): self
         return $self;
     }
 
+    /**
+     * Two-letter ISO 3166-1 alpha-2 country code for the website request location. When provided, Context.dev fetches the target page from that country.
+     *
+     * @param Country|value-of<Country> $country
+     */
+    public function withCountry(Country|string $country): self
+    {
+        $self = clone $this;
+        $self['country'] = $country;
+
+        return $self;
+    }
+
     /**
      * CSS selectors to remove before conversion to Markdown. Applied after includeSelectors. Exclusion takes precedence: an element matching both is removed. Examples: "nav", "footer", ".ad-banner", "[aria-hidden=true]".
      *
diff --git a/src/Web/WebWebScrapeMdParams/Country.php b/src/Web/WebWebScrapeMdParams/Country.php
new file mode 100644
index 0000000..3d1460e
--- /dev/null
+++ b/src/Web/WebWebScrapeMdParams/Country.php
@@ -0,0 +1,419 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebWebScrapeMdParams;
+
+/**
+ * Two-letter ISO 3166-1 alpha-2 country code for the website request location. When provided, Context.dev fetches the target page from that country.
+ */
+enum Country: string
+{
+    case AD = 'ad';
+
+    case AE = 'ae';
+
+    case AF = 'af';
+
+    case AG = 'ag';
+
+    case AI = 'ai';
+
+    case AL = 'al';
+
+    case AM = 'am';
+
+    case AO = 'ao';
+
+    case AR = 'ar';
+
+    case AT = 'at';
+
+    case AU = 'au';
+
+    case AW = 'aw';
+
+    case AZ = 'az';
+
+    case BA = 'ba';
+
+    case BB = 'bb';
+
+    case BD = 'bd';
+
+    case BE = 'be';
+
+    case BF = 'bf';
+
+    case BG = 'bg';
+
+    case BH = 'bh';
+
+    case BI = 'bi';
+
+    case BJ = 'bj';
+
+    case BM = 'bm';
+
+    case BN = 'bn';
+
+    case BO = 'bo';
+
+    case BQ = 'bq';
+
+    case BR = 'br';
+
+    case BS = 'bs';
+
+    case BW = 'bw';
+
+    case BY = 'by';
+
+    case BZ = 'bz';
+
+    case CA = 'ca';
+
+    case CD = 'cd';
+
+    case CF = 'cf';
+
+    case CG = 'cg';
+
+    case CH = 'ch';
+
+    case CI = 'ci';
+
+    case CL = 'cl';
+
+    case CM = 'cm';
+
+    case CN = 'cn';
+
+    case CO = 'co';
+
+    case CR = 'cr';
+
+    case CV = 'cv';
+
+    case CW = 'cw';
+
+    case CY = 'cy';
+
+    case CZ = 'cz';
+
+    case DE = 'de';
+
+    case DJ = 'dj';
+
+    case DK = 'dk';
+
+    case DM = 'dm';
+
+    case DO = 'do';
+
+    case DZ = 'dz';
+
+    case EC = 'ec';
+
+    case EE = 'ee';
+
+    case EG = 'eg';
+
+    case ES = 'es';
+
+    case ET = 'et';
+
+    case FI = 'fi';
+
+    case FJ = 'fj';
+
+    case FR = 'fr';
+
+    case GA = 'ga';
+
+    case GB = 'gb';
+
+    case GD = 'gd';
+
+    case GE = 'ge';
+
+    case GF = 'gf';
+
+    case GG = 'gg';
+
+    case GH = 'gh';
+
+    case GM = 'gm';
+
+    case GN = 'gn';
+
+    case GP = 'gp';
+
+    case GQ = 'gq';
+
+    case GR = 'gr';
+
+    case GT = 'gt';
+
+    case GU = 'gu';
+
+    case GW = 'gw';
+
+    case GY = 'gy';
+
+    case HK = 'hk';
+
+    case HN = 'hn';
+
+    case HR = 'hr';
+
+    case HT = 'ht';
+
+    case HU = 'hu';
+
+    case ID = 'id';
+
+    case IE = 'ie';
+
+    case IL = 'il';
+
+    case IM = 'im';
+
+    case IN = 'in';
+
+    case IQ = 'iq';
+
+    case IR = 'ir';
+
+    case IS = 'is';
+
+    case IT = 'it';
+
+    case JE = 'je';
+
+    case JM = 'jm';
+
+    case JO = 'jo';
+
+    case JP = 'jp';
+
+    case KE = 'ke';
+
+    case KG = 'kg';
+
+    case KH = 'kh';
+
+    case KN = 'kn';
+
+    case KR = 'kr';
+
+    case KW = 'kw';
+
+    case KY = 'ky';
+
+    case KZ = 'kz';
+
+    case LA = 'la';
+
+    case LB = 'lb';
+
+    case LC = 'lc';
+
+    case LK = 'lk';
+
+    case LR = 'lr';
+
+    case LS = 'ls';
+
+    case LT = 'lt';
+
+    case LU = 'lu';
+
+    case LV = 'lv';
+
+    case LY = 'ly';
+
+    case MA = 'ma';
+
+    case MC = 'mc';
+
+    case MD = 'md';
+
+    case ME = 'me';
+
+    case MF = 'mf';
+
+    case MG = 'mg';
+
+    case MK = 'mk';
+
+    case ML = 'ml';
+
+    case MM = 'mm';
+
+    case MN = 'mn';
+
+    case MO = 'mo';
+
+    case MQ = 'mq';
+
+    case MR = 'mr';
+
+    case MT = 'mt';
+
+    case MU = 'mu';
+
+    case MV = 'mv';
+
+    case MW = 'mw';
+
+    case MX = 'mx';
+
+    case MY = 'my';
+
+    case MZ = 'mz';
+
+    case NA = 'na';
+
+    case NC = 'nc';
+
+    case NE = 'ne';
+
+    case NG = 'ng';
+
+    case NI = 'ni';
+
+    case NL = 'nl';
+
+    case NO = 'no';
+
+    case NP = 'np';
+
+    case NZ = 'nz';
+
+    case OM = 'om';
+
+    case PA = 'pa';
+
+    case PE = 'pe';
+
+    case PF = 'pf';
+
+    case PG = 'pg';
+
+    case PH = 'ph';
+
+    case PK = 'pk';
+
+    case PL = 'pl';
+
+    case PR = 'pr';
+
+    case PS = 'ps';
+
+    case PT = 'pt';
+
+    case PY = 'py';
+
+    case QA = 'qa';
+
+    case RE = 're';
+
+    case RO = 'ro';
+
+    case RS = 'rs';
+
+    case RU = 'ru';
+
+    case RW = 'rw';
+
+    case SA = 'sa';
+
+    case SC = 'sc';
+
+    case SD = 'sd';
+
+    case SE = 'se';
+
+    case SG = 'sg';
+
+    case SI = 'si';
+
+    case SK = 'sk';
+
+    case SL = 'sl';
+
+    case SM = 'sm';
+
+    case SN = 'sn';
+
+    case SO = 'so';
+
+    case SR = 'sr';
+
+    case SS = 'ss';
+
+    case ST = 'st';
+
+    case SV = 'sv';
+
+    case SX = 'sx';
+
+    case SY = 'sy';
+
+    case SZ = 'sz';
+
+    case TC = 'tc';
+
+    case TD = 'td';
+
+    case TG = 'tg';
+
+    case TH = 'th';
+
+    case TJ = 'tj';
+
+    case TL = 'tl';
+
+    case TM = 'tm';
+
+    case TN = 'tn';
+
+    case TR = 'tr';
+
+    case TT = 'tt';
+
+    case TW = 'tw';
+
+    case TZ = 'tz';
+
+    case UA = 'ua';
+
+    case UG = 'ug';
+
+    case US = 'us';
+
+    case UY = 'uy';
+
+    case UZ = 'uz';
+
+    case VC = 'vc';
+
+    case VE = 've';
+
+    case VG = 'vg';
+
+    case VI = 'vi';
+
+    case VN = 'vn';
+
+    case YE = 'ye';
+
+    case YT = 'yt';
+
+    case ZA = 'za';
+
+    case ZM = 'zm';
+
+    case ZW = 'zw';
+}
diff --git a/tests/Services/WebTest.php b/tests/Services/WebTest.php
index 6a50237..55fa08d 100644
--- a/tests/Services/WebTest.php
+++ b/tests/Services/WebTest.php
@@ -182,6 +182,7 @@ public function testSearchWithOptionalParams(): void
 
         $result = $this->client->web->search(
             query: 'x',
+            country: 'af',
             excludeDomains: ['string'],
             freshness: 'last_24_hours',
             includeDomains: ['string'],
@@ -197,6 +198,7 @@ public function testSearchWithOptionalParams(): void
                 'useMainContentOnly' => true,
                 'waitForMs' => 0,
             ],
+            numResults: 10,
             queryFanout: true,
             timeoutMs: 1000,
         );
@@ -227,6 +229,7 @@ public function testWebCrawlMdWithOptionalParams(): void
 
         $result = $this->client->web->webCrawlMd(
             url: 'https://example.com',
+            country: 'de',
             excludeSelectors: ['string'],
             followSubdomains: true,
             includeFrames: true,
@@ -271,6 +274,7 @@ public function testWebScrapeHTMLWithOptionalParams(): void
 
         $result = $this->client->web->webScrapeHTML(
             url: 'https://example.com',
+            country: 'de',
             excludeSelectors: ['string'],
             headers: ['foo' => 'J!'],
             includeFrames: true,
@@ -346,6 +350,7 @@ public function testWebScrapeMdWithOptionalParams(): void
 
         $result = $this->client->web->webScrapeMd(
             url: 'https://example.com',
+            country: 'de',
             excludeSelectors: ['string'],
             headers: ['foo' => 'J!'],
             includeFrames: true,