feat: add location_geo_code parameter to SearchScraper for geo-targeting

Add optional geo-targeting to Google search for SearchScraper:
- Add location_geo_code field to SearchScraperRequest model
- Update sync client searchscraper method to accept location_geo_code
- Update async client searchscraper method to accept location_geo_code

This enables filtering search results by geographic location using
country codes like 'us', 'uk', 'de'.

Co-Authored-By: Claude Opus 4.5 <[email protected]>

Author: VinciGit00

scrapegraph-py/src/async_client.py

@@ -782,6 +782,7 @@ async def searchscraper(
         output_schema: Optional[BaseModel] = None,
         extraction_mode: bool = True,
         stealth: bool = False,
+        location_geo_code: Optional[str] = None,
         return_toon: bool = False,
     ):
         """Send a searchscraper request
@@ -797,6 +798,7 @@ async def searchscraper(
             extraction_mode: Whether to use AI extraction (True) or markdown conversion (False).
                            AI extraction costs 10 credits per page, markdown conversion costs 2 credits per page.
             stealth: Enable stealth mode to avoid bot detection
+            location_geo_code: The geo code of the location to search in (e.g., 'us', 'uk', 'de')
             return_toon: If True, return response in TOON format (reduces token usage by 30-60%)
         """
         logger.info("🔍 Starting searchscraper request")
@@ -807,6 +809,8 @@ async def searchscraper(
             logger.debug("🔧 Using custom headers")
         if stealth:
             logger.debug("🥷 Stealth mode enabled")
+        if location_geo_code:
+            logger.debug(f"🌍 Location geo code: {location_geo_code}")
         if return_toon:
             logger.debug("🎨 TOON format output enabled")
 
@@ -817,6 +821,7 @@ async def searchscraper(
             output_schema=output_schema,
             extraction_mode=extraction_mode,
             stealth=stealth,
+            location_geo_code=location_geo_code,
         )
         logger.debug("✅ Request validation passed")
 

scrapegraph-py/src/client.py

@@ -790,8 +790,9 @@ def searchscraper(
         headers: Optional[dict[str, str]] = None,
         output_schema: Optional[BaseModel] = None,
         extraction_mode: bool = True,
-        mock: bool=False,
-        stealth: bool=False,
+        mock: bool = False,
+        stealth: bool = False,
+        location_geo_code: Optional[str] = None,
         return_toon: bool = False,
     ):
         """Send a searchscraper request
@@ -808,6 +809,7 @@ def searchscraper(
                            AI extraction costs 10 credits per page, markdown conversion costs 2 credits per page.
             mock: Enable mock mode for testing
             stealth: Enable stealth mode to avoid bot detection
+            location_geo_code: The geo code of the location to search in (e.g., 'us', 'uk', 'de')
             return_toon: If True, return response in TOON format (reduces token usage by 30-60%)
         """
         logger.info("🔍 Starting searchscraper request")
@@ -818,6 +820,8 @@ def searchscraper(
             logger.debug("🔧 Using custom headers")
         if stealth:
             logger.debug("🥷 Stealth mode enabled")
+        if location_geo_code:
+            logger.debug(f"🌍 Location geo code: {location_geo_code}")
         if return_toon:
             logger.debug("🎨 TOON format output enabled")
 
@@ -828,7 +832,8 @@ def searchscraper(
             output_schema=output_schema,
             extraction_mode=extraction_mode,
             mock=mock,
-            stealth=stealth
+            stealth=stealth,
+            location_geo_code=location_geo_code,
         )
         logger.debug("✅ Request validation passed")
 

scrapegraph-py/src/models/searchscraper.py

@@ -68,6 +68,11 @@ class SearchScraperRequest(BaseModel):
     mock: bool = Field(default=False, description="Whether to use mock mode for the request")
     render_heavy_js: bool = Field(default=False, description="Whether to render heavy JavaScript on the page")
     stealth: bool = Field(default=False, description="Enable stealth mode to avoid bot detection")
+    location_geo_code: Optional[str] = Field(
+        default=None,
+        description="The geo code of the location to search in (e.g., 'us', 'uk', 'de')",
+        example="us",
+    )
 
     @model_validator(mode="after")
     def validate_user_prompt(self) -> "SearchScraperRequest":