context-dot-dev · YahiaBakour · Sep 23, 2026 · Sep 23, 2026
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "2.19.0"
+  ".": "2.20.0"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,128 @@
 # Changelog
 
+## [2.20.0](https://github.com/context-dot-dev/context-php-sdk/compare/v2.19.0...v2.20.0) (2026-09-23)
+
+
+### Features
+
+* **answers:** add live web research with fast and ultra modes ([#954](https://github.com/context-dot-dev/context-php-sdk/issues/954)) ([5f7df63](https://github.com/context-dot-dev/context-php-sdk/commit/5f7df635b6dec3bf018860d5581f142079a43900))
+* **api-keys:** enforce scoped API key permissions ([#1038](https://github.com/context-dot-dev/context-php-sdk/issues/1038)) ([22e1313](https://github.com/context-dot-dev/context-php-sdk/commit/22e13131155ea56eaf966856266bffdfd5c9f5bd))
+* **api:** api update ([b782fd5](https://github.com/context-dot-dev/context-php-sdk/commit/b782fd576bf2d36a999c25d99c37c2ed5ffde217))
+* **api:** api update ([251478e](https://github.com/context-dot-dev/context-php-sdk/commit/251478ecc8e0ea5db2ce136aa9c78b84b775543c))
+* **api:** api update ([84e2387](https://github.com/context-dot-dev/context-php-sdk/commit/84e23875b946b62c378ddd8f4f3c70c76e3bba47))
+* **api:** api update ([3dbbac2](https://github.com/context-dot-dev/context-php-sdk/commit/3dbbac273b81d666b1dc7584e125bd5ce0ba3d9a))
+* **api:** api update ([6884bcc](https://github.com/context-dot-dev/context-php-sdk/commit/6884bccdb59931c30a1778e0ce6dfe8566eac781))
+* **api:** api update ([12c8df5](https://github.com/context-dot-dev/context-php-sdk/commit/12c8df51b59e9fefe8ebf3dd17ee2ddbc8ef3af7))
+* **api:** api update ([5f91017](https://github.com/context-dot-dev/context-php-sdk/commit/5f910173f3c49527bd7d5408a198885b11c4fd29))
+* **api:** api update ([d3850f6](https://github.com/context-dot-dev/context-php-sdk/commit/d3850f664710af378454958f6b35c3512dd1be5d))
+* **api:** api update ([4da1136](https://github.com/context-dot-dev/context-php-sdk/commit/4da11366e88ecc0fb25ecc230ce91927c969dd50))
+* **api:** api update ([9c6bfd1](https://github.com/context-dot-dev/context-php-sdk/commit/9c6bfd1c14cdb0394a17f4d26c005c902b365a1e))
+* **api:** api update ([0e1448d](https://github.com/context-dot-dev/context-php-sdk/commit/0e1448d609afec7df8d16031c39922d6b8cc5cba))
+* **api:** api update ([2f3a923](https://github.com/context-dot-dev/context-php-sdk/commit/2f3a923880a205a86d61f10d2aad236496f56144))
+* **api:** api update ([ff6e987](https://github.com/context-dot-dev/context-php-sdk/commit/ff6e9870b85a7e2c9b6f88928ae9fd3ab0af5d4b))
+* **api:** api update ([1b83bad](https://github.com/context-dot-dev/context-php-sdk/commit/1b83bad5cc2fec1d3659f6109fc6b7ce30446add))
+* **api:** api update ([5932741](https://github.com/context-dot-dev/context-php-sdk/commit/5932741da1376f8eba94cb6736f356efc8d9e455))
+* **api:** api update ([985cbbd](https://github.com/context-dot-dev/context-php-sdk/commit/985cbbd5032c78418d6235faf14641dfe3782cb4))
+* **api:** api update ([dd60dca](https://github.com/context-dot-dev/context-php-sdk/commit/dd60dca30260506e86c70a674f10e9892788109b))
+* **api:** api update ([841bd43](https://github.com/context-dot-dev/context-php-sdk/commit/841bd435edb55d3539afb1162993ac28c427fcd0))
+* **api:** api update ([3797497](https://github.com/context-dot-dev/context-php-sdk/commit/3797497dd171a1b3b6ca8260ea34c0e6bccda217))
+* **api:** api update ([1d85418](https://github.com/context-dot-dev/context-php-sdk/commit/1d8541856e8aab69cf19e207dbb8984aea0bf686))
+* **api:** api update ([76e2e1a](https://github.com/context-dot-dev/context-php-sdk/commit/76e2e1ac2a08536679a582f8cd5807a1eab8349a))
+* **api:** api update ([c244d40](https://github.com/context-dot-dev/context-php-sdk/commit/c244d408ae90844b902d0efd9bca304e115f4880))
+* **api:** api update ([b59e9c6](https://github.com/context-dot-dev/context-php-sdk/commit/b59e9c6dc3fcfd6009c0446923fd637f4f061cc6))
+* **api:** api update ([dfc48ee](https://github.com/context-dot-dev/context-php-sdk/commit/dfc48eeff2f2d8bcbdbe8943c50fa60621196e30))
+* **api:** api update ([dd8d83a](https://github.com/context-dot-dev/context-php-sdk/commit/dd8d83aebc6aad41b51ce8781ac6608d6ac1c017))
+* **api:** api update ([ead89a6](https://github.com/context-dot-dev/context-php-sdk/commit/ead89a68d802e28bce49e8fbbecd9afbd064abfc))
+* **api:** api update ([61f098d](https://github.com/context-dot-dev/context-php-sdk/commit/61f098d3e54db1a7ed6e927cfd0a4b036ceb97c9))
+* **api:** api update ([010f4c0](https://github.com/context-dot-dev/context-php-sdk/commit/010f4c0c535137516b46f722b1d768422d4107b8))
+* **api:** api update ([b81393a](https://github.com/context-dot-dev/context-php-sdk/commit/b81393a0e2ad8b2e184555a4cbefff55c9f78085))
+* **api:** api update ([31e96ec](https://github.com/context-dot-dev/context-php-sdk/commit/31e96ec38f5746807e2d0bb2a58d5fee86e628c9))
+* **api:** api update ([c0beeca](https://github.com/context-dot-dev/context-php-sdk/commit/c0beecafa76546b693bc4fc21ba2a5d866c3a800))
+* **api:** api update ([4545026](https://github.com/context-dot-dev/context-php-sdk/commit/454502638c42c3f616a4b05182ccfadbedc4094e))
+* **api:** api update ([ea009c4](https://github.com/context-dot-dev/context-php-sdk/commit/ea009c4ebae36d4f2fbe2bf2bccce55f0148dfe8))
+* **api:** api update ([8e18458](https://github.com/context-dot-dev/context-php-sdk/commit/8e18458a35402f1b085547b472601a563c77ae5b))
+* **api:** api update ([1399297](https://github.com/context-dot-dev/context-php-sdk/commit/13992978b08998d403e9dada6abf5df6b44841c3))
+* **api:** api update ([5f6925d](https://github.com/context-dot-dev/context-php-sdk/commit/5f6925d87d9adf3fa204e2707429b82905196549))
+* **api:** api update ([0b9b38e](https://github.com/context-dot-dev/context-php-sdk/commit/0b9b38e55a8c52f6aca3b191fdc59d5856a6de32))
+* **api:** api update ([5889365](https://github.com/context-dot-dev/context-php-sdk/commit/588936589a271abf52be663cd4e6c94f0e4a6255))
+* **api:** api update ([70de3e2](https://github.com/context-dot-dev/context-php-sdk/commit/70de3e2d6f801f5f91b2c6eac2d49ab758d56a4c))
+* **api:** api update ([4379e97](https://github.com/context-dot-dev/context-php-sdk/commit/4379e97f952247e5c473b0c8bba5790ea2b352f9))
+* **api:** api update ([50c3528](https://github.com/context-dot-dev/context-php-sdk/commit/50c35289242fd7e81f8a60614506fe5fc9984b6d))
+* **api:** api update ([14b65ba](https://github.com/context-dot-dev/context-php-sdk/commit/14b65ba7875c717bb23af5a2e980218b3ad93161))
+* **api:** api update ([7638330](https://github.com/context-dot-dev/context-php-sdk/commit/7638330d9020cc4ba1326845700619d110dffe54))
+* **api:** api update ([efb4692](https://github.com/context-dot-dev/context-php-sdk/commit/efb469262cfa86a8b362131a90c0ccacabf3e7c9))
+* **api:** api update ([5e090db](https://github.com/context-dot-dev/context-php-sdk/commit/5e090db2c8b5430cf5818984c928831952dcbb32))
+* **api:** api update ([3503b7b](https://github.com/context-dot-dev/context-php-sdk/commit/3503b7b911e5e6992406040ecb82c6d8f7711243))
+* **api:** api update ([5b92377](https://github.com/context-dot-dev/context-php-sdk/commit/5b9237711f3ad827a51e6166d71e69fab8fd37dd))
+* **api:** api update ([a109b94](https://github.com/context-dot-dev/context-php-sdk/commit/a109b94c372f554a6f9d6c669dd01fc3afe37c85))
+* **api:** api update ([fc46359](https://github.com/context-dot-dev/context-php-sdk/commit/fc4635910c2035f4edffb817e4a7259b82e1c39c))
+* **api:** api update ([b6570c0](https://github.com/context-dot-dev/context-php-sdk/commit/b6570c0cad69d665d2cce99f57c2b85fb6ff408e))
+* **api:** api update ([61d8ed4](https://github.com/context-dot-dev/context-php-sdk/commit/61d8ed4cb6be1d1c2caad265f97987b5e93f620d))
+* **api:** api update ([16b3c1e](https://github.com/context-dot-dev/context-php-sdk/commit/16b3c1efb31c9d1da12ab3a2a5e65f4bfcd74247))
+* **api:** api update ([b96c262](https://github.com/context-dot-dev/context-php-sdk/commit/b96c26218eb833e9227dee9551ee9eb2b94b9abd))
+* **api:** api update ([4589097](https://github.com/context-dot-dev/context-php-sdk/commit/45890973be2637f7e69fb82cc5b5e52840420ca1))
+* **api:** api update ([b635a05](https://github.com/context-dot-dev/context-php-sdk/commit/b635a0588edc056550fbf1ddce2a239f4b4b29b2))
+* **api:** api update ([f7a3ee5](https://github.com/context-dot-dev/context-php-sdk/commit/f7a3ee5f797c5bd286293a69db0b50cd402d56fe))
+* **api:** api update ([787f92f](https://github.com/context-dot-dev/context-php-sdk/commit/787f92feb6e1fb84d0661b5ae60cf12981b4f558))
+* **api:** api update ([e99ca05](https://github.com/context-dot-dev/context-php-sdk/commit/e99ca05a38a1c1ceaf20a572a306d2ac550498d2))
+* **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))
+* **api:** api update ([e984607](https://github.com/context-dot-dev/context-php-sdk/commit/e984607de54b77c8cd7991636bc1c5d95ca42e1e))
+* **api:** enable ZDR on remaining AI endpoints via OpenAI ([#1099](https://github.com/context-dot-dev/context-php-sdk/issues/1099)) ([133be34](https://github.com/context-dot-dev/context-php-sdk/commit/133be34fbabf9ee38341369a40c49fb9e6ea042f))
+* **api:** manual updates ([3771cd3](https://github.com/context-dot-dev/context-php-sdk/commit/3771cd3b5c34b4fc205ae37d4e97f5696e4bef34))
+* **api:** manual updates ([7de1574](https://github.com/context-dot-dev/context-php-sdk/commit/7de1574a2177b6842269fdd4f453f4e5829557fb))
+* **api:** manual updates ([5a35e94](https://github.com/context-dot-dev/context-php-sdk/commit/5a35e9456fbed83f7a6b96ee69c1443974246d2c))
+* **api:** manual updates ([899b0c9](https://github.com/context-dot-dev/context-php-sdk/commit/899b0c946eb9d92294f5d0b5d3ef2d1c50f8ac20))
+* **api:** manual updates ([e6af5a4](https://github.com/context-dot-dev/context-php-sdk/commit/e6af5a4a974d252d12b03fa44e0e4258dd217412))
+* **api:** manual updates ([9e19712](https://github.com/context-dot-dev/context-php-sdk/commit/9e19712ccb456f95249e56ed34f3c7369536192d))
+* **api:** manual updates ([33c37e5](https://github.com/context-dot-dev/context-php-sdk/commit/33c37e56e87ef187161361879db3cc25c12e663e))
+* **api:** manual updates ([d3c55dc](https://github.com/context-dot-dev/context-php-sdk/commit/d3c55dc909d9431595788c4e140a608e7cea5c5d))
+* **api:** manual updates ([d1b85dd](https://github.com/context-dot-dev/context-php-sdk/commit/d1b85ddef694ea143f27b352a9bca54f77b07512))
+* **api:** manual updates ([af06555](https://github.com/context-dot-dev/context-php-sdk/commit/af065558a8581b19ce46dd87f3e2809d436216e4))
+* **api:** manual updates ([ccdd487](https://github.com/context-dot-dev/context-php-sdk/commit/ccdd487df0a216fc3a1aa25d636e14883c9b3331))
+* **api:** return request_id on every response ([ad2cd5c](https://github.com/context-dot-dev/context-php-sdk/commit/ad2cd5c05480b70e58f9f60685adeac3028aa410))
+* **api:** unify timeout configuration and return partial results ([#1030](https://github.com/context-dot-dev/context-php-sdk/issues/1030)) ([65009da](https://github.com/context-dot-dev/context-php-sdk/commit/65009da2a653b2e4fd9f8fb1f2606d6ce6ecd58f))
+* **billing:** charge for 404s and skip fraud accounting ([#1152](https://github.com/context-dot-dev/context-php-sdk/issues/1152)) ([780b335](https://github.com/context-dot-dev/context-php-sdk/commit/780b335c451883490d44a76e67f1aebad4cd1596))
+* initial stlc build ([c21c1eb](https://github.com/context-dot-dev/context-php-sdk/commit/c21c1ebf2ab3db0e2b8eae00a518a4fb5eb90106))
+* **logs:** expose request log endpoints in SDKs ([#1025](https://github.com/context-dot-dev/context-php-sdk/issues/1025)) ([222b53a](https://github.com/context-dot-dev/context-php-sdk/commit/222b53a1f02d7b5e30a82fa3d27082c07a831ed5))
+* **monitors:** add page selector filters ([#1037](https://github.com/context-dot-dev/context-php-sdk/issues/1037)) ([ba3ef54](https://github.com/context-dot-dev/context-php-sdk/commit/ba3ef54919ec64356568d4c6e16a2838a8cb3ebb))
+* **products:** extract ProductGroup variants with images ([#1124](https://github.com/context-dot-dev/context-php-sdk/issues/1124)) ([eae00ad](https://github.com/context-dot-dev/context-php-sdk/commit/eae00ad91bb3dd7cd87f3c739598ee1c9f6c72dc))
+* **scrape:** add cache age support to byte downloads ([#1171](https://github.com/context-dot-dev/context-php-sdk/issues/1171)) ([c8c9ed3](https://github.com/context-dot-dev/context-php-sdk/commit/c8c9ed3873fa84a4c61e1f8748f9009377aeeb76))
+* **scrape:** add CSS extraction rules to HTML scraping ([#1146](https://github.com/context-dot-dev/context-php-sdk/issues/1146)) ([3f110e4](https://github.com/context-dot-dev/context-php-sdk/commit/3f110e410162d35f640adae429851852633eb603))
+* **scrape:** add highlights format to POST /web/scrape ([#1210](https://github.com/context-dot-dev/context-php-sdk/issues/1210)) ([89485cb](https://github.com/context-dot-dev/context-php-sdk/commit/89485cb5b736a6f5f898ac8a5ec1b9fa9e23b776))
+* **scrape:** add json output format to POST /web/scrape ([#1213](https://github.com/context-dot-dev/context-php-sdk/issues/1213)) ([babaf1d](https://github.com/context-dot-dev/context-php-sdk/commit/babaf1d3dbf107b12b63008391ddc5e2a3288011))
+* **scrape:** add product extraction format to POST /web/scrape ([#1212](https://github.com/context-dot-dev/context-php-sdk/issues/1212)) ([d4ad692](https://github.com/context-dot-dev/context-php-sdk/commit/d4ad6928e878f0259daac8bb4598b01124195693))
+* **scrape:** add unified scrape API ([#1182](https://github.com/context-dot-dev/context-php-sdk/issues/1182)) ([7de59fc](https://github.com/context-dot-dev/context-php-sdk/commit/7de59fc620ff26f9ba6373bbdb62a69521d2ff57))
+* **scrape:** align timeout options and public SDK methods ([#1207](https://github.com/context-dot-dev/context-php-sdk/issues/1207)) ([42e8a3d](https://github.com/context-dot-dev/context-php-sdk/commit/42e8a3d0a05191157857741f8df4b7b4bdb13d92))
+* **scrape:** support country for image scraping ([#1172](https://github.com/context-dot-dev/context-php-sdk/issues/1172)) ([c8c9ed3](https://github.com/context-dot-dev/context-php-sdk/commit/c8c9ed3873fa84a4c61e1f8748f9009377aeeb76))
+* **scrape:** support custom screenshot headers ([#1169](https://github.com/context-dot-dev/context-php-sdk/issues/1169)) ([ac70e57](https://github.com/context-dot-dev/context-php-sdk/commit/ac70e57b21323850343b2711be98c5c046afa648))
+* **scrape:** support waitForMs for byte downloads ([#1170](https://github.com/context-dot-dev/context-php-sdk/issues/1170)) ([a270ff4](https://github.com/context-dot-dev/context-php-sdk/commit/a270ff4334781f06ccdd227ca2d2978287eb66f7))
+* **sitemap:** add subdomain discovery ([4c7527b](https://github.com/context-dot-dev/context-php-sdk/commit/4c7527bb1078312bf9ccb96905fa2145e6e6b062))
+* **stlc:** configurable CI runner and private-production-repo support in workflow templates ([ffd1499](https://github.com/context-dot-dev/context-php-sdk/commit/ffd14997114f4bfc701996334a6d39a479f17b2f))
+* **web:** add raw bytes scraping endpoint ([#1081](https://github.com/context-dot-dev/context-php-sdk/issues/1081)) ([c9949f9](https://github.com/context-dot-dev/context-php-sdk/commit/c9949f9cb164200882e44e73ed80dff9ccfe7884))
+* **web:** add URL-based scrape screenshot endpoint ([#1150](https://github.com/context-dot-dev/context-php-sdk/issues/1150)) ([25b9c1c](https://github.com/context-dot-dev/context-php-sdk/commit/25b9c1c2d6e48ff938a57342a7a9550366300991))
+* **webhooks:** add configurable retries and manual replay ([aa77746](https://github.com/context-dot-dev/context-php-sdk/commit/aa777466766153ec04c4e70c4a82b0278bd49f81))
+* **webhooks:** simplify delivery APIs ([8b4861b](https://github.com/context-dot-dev/context-php-sdk/commit/8b4861b53f95a3822b7f3178b53610677dc9d393))
+
+
+### Bug Fixes
+
+* **api:** guarantee search descriptions and align response types ([#1089](https://github.com/context-dot-dev/context-php-sdk/issues/1089)) ([a12acad](https://github.com/context-dot-dev/context-php-sdk/commit/a12acadba0f6ee2651313d772b1b45e85dfeb6aa))
+* **api:** honour maxAgeMs=0 on brand retrieve, styleguide and fonts endpoints ([#998](https://github.com/context-dot-dev/context-php-sdk/issues/998)) ([2854d7c](https://github.com/context-dot-dev/context-php-sdk/commit/2854d7cfeb81a801717099b3d9e5e04d80dadb2e))
+* **api:** lower partial scrape timeout minimum to five seconds ([#1118](https://github.com/context-dot-dev/context-php-sdk/issues/1118)) ([c6c30a3](https://github.com/context-dot-dev/context-php-sdk/commit/c6c30a34d8c6d1f64d65306d17ec5214812c2c94))
+* **api:** reject timeoutMS too short for waitForMs ([f48fa21](https://github.com/context-dot-dev/context-php-sdk/commit/f48fa21836c263354e256d157304f321fb70104b))
+* **scrape:** reuse legacy caches across all output formats ([#1197](https://github.com/context-dot-dev/context-php-sdk/issues/1197)) ([424354f](https://github.com/context-dot-dev/context-php-sdk/commit/424354f8c9b4fff8316c20f1a345ffca269831af))
+* **webhooks:** format Slack webhook notifications ([#1045](https://github.com/context-dot-dev/context-php-sdk/issues/1045)) ([b936e81](https://github.com/context-dot-dev/context-php-sdk/commit/b936e8167831ae89856fc1cdb2f17343a7401ca0))
+
+
+### Chores
+
+* configure new SDK language ([99718fc](https://github.com/context-dot-dev/context-php-sdk/commit/99718fc516e6729428e569fa4bcfa8383ab1e298))
+* **internal:** codegen related update ([dc83cc4](https://github.com/context-dot-dev/context-php-sdk/commit/dc83cc446beff270d9352e6962eec7541219a691))
+* **internal:** codegen related update ([a1ec0f0](https://github.com/context-dot-dev/context-php-sdk/commit/a1ec0f0938eef801f1d08821904a5c2dba617583))
+* release 2.17.1 ([3d1d54e](https://github.com/context-dot-dev/context-php-sdk/commit/3d1d54e3502d0a6ad110b978cc7a3b764abe6536))
+* update SDK settings ([f2a0d39](https://github.com/context-dot-dev/context-php-sdk/commit/f2a0d3925603e5877bf5e628b5e9a6228abb25fe))
+
 ## [2.19.0](https://github.com/context-dot-dev/context-php-sdk/compare/v2.18.0...v2.19.0) (2026-09-22)
 
 

diff --git 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 2.19.0"
+composer require "context-dev/context-dev-php 2.20.0"
 ```
 
 <!-- x-release-please-end -->

diff --git a/src/Version.php b/src/Version.php
@@ -5,5 +5,5 @@
 namespace ContextDev;
 
 // x-release-please-start-version
-const VERSION = '2.19.0';
+const VERSION = '2.20.0';
 // x-release-please-end