fix(python-sdk): map min_age to minAge in scrape options (firecrawl#4002)

saivedant169 · web-flow · commit 929392070402 · 2026-07-20T10:15:05.000+02:00
diff --git a/apps/python-sdk/firecrawl/__tests__/unit/v2/methods/test_parse_request_preparation.py b/apps/python-sdk/firecrawl/__tests__/unit/v2/methods/test_parse_request_preparation.py
@@ -87,3 +87,16 @@ def test_prepare_parse_request_strips_lockdown(self):
 
         payload = json.loads(fields["options"])
         assert "lockdown" not in payload
+
+    def test_prepare_parse_request_strips_min_age(self):
+        options = ParseOptions(formats=["markdown"], min_age=1000)
+        fields, _ = _prepare_parse_request(
+            b"<html><body><h1>Parse</h1></body></html>",
+            options,
+            filename="upload.html",
+            content_type="text/html",
+        )
+
+        payload = json.loads(fields["options"])
+        assert "minAge" not in payload
+        assert "min_age" not in payload
diff --git a/apps/python-sdk/firecrawl/__tests__/unit/v2/utils/test_validation.py b/apps/python-sdk/firecrawl/__tests__/unit/v2/utils/test_validation.py
@@ -387,4 +387,14 @@ def test_prepare_parsers_max_pages_model(self):
 
         result = prepare_scrape_options(options)
 
-        assert result["parsers"][0]["maxPages"] == 5
+        assert result["parsers"][0]["maxPages"] == 5
+
+    def test_prepare_min_age_maps_to_camel_case(self):
+        """min_age must be sent as minAge; the server drops the snake_case key."""
+        options = ScrapeOptions(min_age=1000, max_age=5000)
+
+        result = prepare_scrape_options(options)
+
+        assert result["minAge"] == 1000
+        assert "min_age" not in result
+        assert result["maxAge"] == 5000
diff --git a/apps/python-sdk/firecrawl/v2/utils/validation.py b/apps/python-sdk/firecrawl/v2/utils/validation.py
@@ -566,6 +566,7 @@ def prepare_scrape_options(options: Optional[ScrapeOptions]) -> Optional[Dict[st
         "block_ads": "blockAds",
         "store_in_cache": "storeInCache",
         "max_age": "maxAge",
+        "min_age": "minAge",
         "redact_pii": "redactPII",
         "threat_protection": "threatProtection",
     }

Original file line number	Diff line number	Diff line change
`@@ -566,6 +566,7 @@ def prepare_scrape_options(options: Optional[ScrapeOptions]) -> Optional[Dict[st`
`566`	`566`	`"block_ads": "blockAds",`
`567`	`567`	`"store_in_cache": "storeInCache",`
`568`	`568`	`"max_age": "maxAge",`
	`569`	`+ "min_age": "minAge",`
`569`	`570`	`"redact_pii": "redactPII",`
`570`	`571`	`"threat_protection": "threatProtection",`
`571`	`572`	`}`