v2.20.0

2.20.0 (2026-09-23)

Features

• answers: add live web research with fast and ultra modes (#954) (653bc8c)
• api-keys: enforce scoped API key permissions (#1038) (f883f60)
• api: api update (3c5c2c3)
• api: api update (3a29950)
• api: api update (0a68836)
• api: api update (288c743)
• api: api update (2bdb356)
• api: api update (2ac4e0c)
• api: api update (68cb98c)
• api: api update (253db7d)
• api: api update (740b2d4)
• api: api update (07e8016)
• api: api update (499fb3f)
• api: api update (853f56b)
• api: api update (b2b2312)
• api: api update (040f31d)
• api: api update (cbf9c43)
• api: api update (06c5d6c)
• api: api update (3935a16)
• api: api update (6f0f3fb)
• api: api update (d9a026d)
• api: api update (da261be)
• api: api update (3688eab)
• api: api update (63b8964)
• api: api update (6d99f45)
• api: api update (ff409ed)
• api: api update (925ed2c)
• api: api update (3f3a903)
• api: api update (226b29c)
• api: api update (bbcd1c1)
• api: api update (4432665)
• api: api update (94fa1f1)
• api: api update (4ae29fb)
• api: api update (08d9b02)
• api: api update (8592c63)
• api: api update (7d2dfb5)
• api: api update (1aa99f7)
• api: api update (dac3f38)
• api: api update (921eaa8)
• api: api update (3e75380)
• api: api update (3b9e64f)
• api: api update (9f486e7)
• api: api update (94c1bb6)
• api: api update (d0f20d7)
• api: api update (4fb738f)
• api: api update (a72ac3e)
• api: api update (b34463f)
• api: api update (964c4b0)
• api: api update (fa060eb)
• api: api update (f63569e)
• api: api update (79826c4)
• api: api update (4bbf3b1)
• api: api update (41ee2e8)
• api: api update (000bd7c)
• api: api update (a2650d4)
• api: api update (c15ed56)
• api: api update (fd00858)
• api: api update (789eb86)
• api: api update (33f8f8a)
• api: api update (de020ba)
• api: api update (e9fb3b8)
• api: api update (5e04d2a)
• api: api update (5c97d99)
• api: api update (619b078)
• api: api update (fc0ae29)
• api: api update (6721d0b)
• api: api update (713964b)
• api: api update (69e2b8a)
• api: api update (06f5e93)
• api: api update (7ef921a)
• api: api update (dc7ab0d)
• api: api update (2b2246d)
• api: api update (cd90e97)
• api: api update (edeabb0)
• api: api update (5b94819)
• api: api update (cd6cf45)
• api: api update (9ce9d85)
• api: api update (cc8337c)
• api: api update (3758473)
• api: api update (d41b2b0)
• api: api update (23cc0fb)
• api: api update (e3419e4)
• api: api update (9706153)
• api: api update (3649236)
• api: api update (0784f70)
• api: api update (cd23fbc)
• api: api update (aed2184)
• api: api update (4fea286)
• api: api update (c24a182)
• api: api update (c9c388e)
• api: api update (000bcaf)
• api: api update (4414309)
• api: api update (494fae6)
• api: api update (83063fc)
• api: api update (7ce5f5b)
• api: api update (90dcf23)
• api: api update (512bf26)
• api: api update (f98376c)
• api: api update (9ddc161)
• api: api update (639075e)
• api: api update (707a6c3)
• api: api update (bbc2458)
• api: api update (241bacf)
• api: api update (648e71b)
• api: api update (656e585)
• api: api update (3fc9944)
• api: api update (b9374f5)
• api: api update (51e02cd)
• api: api update (cb80f56)
• api: api update (b6df2d5)
• api: api update (e74edce)
• api: api update (f502ad6)
• api: api update (e04913b)
• api: api update (38a4e7f)
• api: api update (4a10229)
• api: api update (c4538b4)
• api: api update (5cc1e7d)
• api: enable ZDR on remaining AI endpoints via OpenAI (#1099) (0dcc693)
• api: manual updates (4f84467)
• api: manual updates (a62c8a4)
• api: manual updates (d26f4e8)
• api: manual updates (f32255d)
• api: manual updates (e75ea61)
• api: manual updates (538a766)
• api: manual updates (4aa172e)
• api: manual updates (63d9bdf)
• api: manual updates (f80c306)
• api: manual updates (9aecc62)
• api: manual updates (1ebc67e)
• api: manual updates (bce4c91)
• api: manual updates (b79c985)
• api: manual updates (93da641)
• api: manual updates (48fb2f9)
• api: manual updates (d23341d)
• api: manual updates (985bdda)
• api: manual updates (2af78a4)
• api: manual updates (d6acbc6)
• api: manual updates (ec8ff2d)
• api: manual updates (e40b811)
• api: manual updates (8304083)
• api: manual updates (3285d21)
• api: return request_id on every response (6904a7c)
• api: unify timeout configuration and return partial results (#1030) (3677eab)
• billing: charge for 404s and skip fraud accounting (#1152) (fc642b8)
• initial stlc build (bab3e14)
• internal/types: support eagerly validating pydantic iterators (6386dc9)
• internal: implement indices array format for query and form serialization (6f40553)
• logs: expose request log endpoints in SDKs (#1025) (74461ed)
• monitors: add page selector filters (#1037) (b48d886)
• products: extract ProductGroup variants with images (#1124) (2fdcf25)
• scrape: add cache age support to byte downloads (#1171) (542c639)
• scrape: add CSS extraction rules to HTML scraping (#1146) (53fa41c)
• scrape: add highlights format to POST /web/scrape (#1210) (1f0f7af)
• scrape: add json output format to POST /web/scrape (#1213) (cdb570f)
• scrape: add product extraction format to POST /web/scrape (#1212) (73f3596)
• scrape: add unified scrape API (#1182) (cfec05f)
• scrape: align timeout options and public SDK methods (#1207) (d95d38f)
• scrape: support country for image scraping (#1172) (542c639)
• scrape: support custom screenshot headers (#1169) (f8b192d)
• scrape: support waitForMs for byte downloads (#1170) (65fa0fe)
• sitemap: add subdomain discovery (ba3478c)
• stlc: configurable CI runner and private-production-repo support in workflow templates (b66fcc2)
• support setting headers via env (90d2e4e)
• web: add raw bytes scraping endpoint (#1081) (7b4539c)
• web: add URL-based scrape screenshot endpoint (#1150) (25975e2)
• webhooks: add configurable retries and manual replay (3b219e5)
• webhooks: simplify delivery APIs (8b485b3)

Bug Fixes

• api: guarantee search descriptions and align response types (#1089) (9926fba)
• api: honour maxAgeMs=0 on brand retrieve, styleguide and fonts endpoints (#998) (85ac787)
• api: lower partial scrape timeout minimum to five seconds (#1118) (c8c4975)
• api: reject timeoutMS too short for waitForMs (ca4de4e)
• client: add missing f-string prefix in file type error message (3159495)
• client: preserve hardcoded query params when merging with user params (57c6a22)
• deps: bump minimum typing-extensions version (4695dbc)
• ensure file data are only sent as 1 parameter (7c314a2)
• internal: resolve build failures (e373980)
• pydantic: do not pass by_alias unless set (b1723b9)
• sanitize endpoint path params (8ccc27d)
• scrape: reuse legacy caches across all output formats (#1197) (71ad00b)
• use correct field name format for multipart file arrays (95fd70e)
• webhooks: format Slack webhook notifications (#1045) (309f8f9)

Performance Improvements

• client: optimize file structure copying in multipart requests (573a70c)

Chores

• configure new SDK language (0277c2c)
• internal: more robust bootstrap script (c0a50fe)
• internal: reformat pyproject.toml (d781abc)
• internal: tweak CI branches (0dbacf7)
• release 2.17.0 (9d4a05f)
• sync repo (4003edb)
• update SDK settings (5cb4d7b)
• update SDK settings (604b2b5)
• update SDK settings (d0ad046)
• update SDK settings (0c90793)
• update SDK settings (154e20a)
• update SDK settings (212e987)