refactor: rename location_geo_code to country in search

Matches FetchConfig.country naming convention. Serializes as
locationGeoCode on the wire for API compatibility.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: VinciGit00

scrapegraph-py/MIGRATION_V2.md

@@ -155,7 +155,7 @@ response = client.search(
     num_results=5,
     prompt="Extract key findings",
     schema=MyModel,
-    location_geo_code="us",
+    country="us",
     time_range="past_week",
 )
 ```
@@ -167,7 +167,7 @@ response = client.search(
 | `output_schema` | `schema` (now requires `prompt`) |
 | `extraction_mode` | Removed (always AI extraction) |
 | `stealth` | Removed (use `fetch_config=FetchConfig(mode=...)`) |
-| `location_geo_code` | `location_geo_code` (unchanged) |
+| `location_geo_code` | `country` (renamed, matches `FetchConfig.country`) |
 | `time_range` | `time_range` (values: `past_hour`, `past_24_hours`, `past_week`, `past_month`, `past_year`) |
 | `mock` | Removed |
 | `return_toon` | Removed |

scrapegraph-py/scrapegraph_py/async_client.py

@@ -370,7 +370,7 @@ async def search(
         self,
         query: str,
         num_results: int = 3,
-        location_geo_code: Optional[str] = None,
+        country: Optional[str] = None,
         *,
         schema: Optional[Any] = None,
         prompt: Optional[str] = None,
@@ -384,7 +384,7 @@ async def search(
         Args:
             query: The search query
             num_results: Number of results (1-20, default 3)
-            location_geo_code: Geo code for geo-targeted results
+            country: Two-letter country code for geo-targeted results (e.g. 'us', 'it')
         """
         logger.info(f"Searching: {query}")
         return await self._make_request(
@@ -393,7 +393,7 @@ async def search(
             json=build_search_payload(
                 query=query,
                 num_results=num_results,
-                location_geo_code=location_geo_code,
+                country=country,
                 schema=schema,
                 prompt=prompt,
                 format=format,

scrapegraph-py/scrapegraph_py/client.py

@@ -414,7 +414,7 @@ def search(
         self,
         query: str,
         num_results: int = 3,
-        location_geo_code: Optional[str] = None,
+        country: Optional[str] = None,
         *,
         schema: Optional[Any] = None,
         prompt: Optional[str] = None,
@@ -428,7 +428,7 @@ def search(
         Args:
             query: The search query
             num_results: Number of results (1-20, default 3)
-            location_geo_code: Geo code for geo-targeted results
+            country: Two-letter country code for geo-targeted results (e.g. 'us', 'it')
         """
         logger.info(f"Searching: {query}")
         return self._make_request(
@@ -437,7 +437,7 @@ def search(
             json=build_search_payload(
                 query=query,
                 num_results=num_results,
-                location_geo_code=location_geo_code,
+                country=country,
                 schema=schema,
                 prompt=prompt,
                 format=format,

scrapegraph-py/scrapegraph_py/models/search.py

@@ -30,10 +30,11 @@ class SearchRequest(CamelModel):
         validation_alias="schema",
         description="JSON Schema defining the structure of extracted search data",
     )
-    location_geo_code: Optional[str] = Field(
+    country: Optional[str] = Field(
         default=None,
         max_length=10,
-        description="Geo code for localized search results",
+        serialization_alias="locationGeoCode",
+        description="Two-letter country code for geo-targeted results (e.g. 'us', 'it')",
     )
     time_range: Optional[str] = Field(
         default=None,

scrapegraph-py/scrapegraph_py/utils/request_builders.py

@@ -131,7 +131,7 @@ def build_search_payload(
     *,
     query: str,
     num_results: int = 3,
-    location_geo_code: Optional[str] = None,
+    country: Optional[str] = None,
     schema: Optional[Any] = None,
     prompt: Optional[str] = None,
     format: str = "markdown",
@@ -148,7 +148,7 @@ def build_search_payload(
         format=format,
         mode=mode,
         fetch_config=fetch_config,
-        location_geo_code=location_geo_code,
+        country=country,
         time_range=time_range,
     )
     return request.model_dump()

scrapegraph-py/tests/test_async_client.py

@@ -123,7 +123,7 @@ async def fake_request(method, url, **kwargs):
         num_results=1,
         prompt="Extract titles",
         schema={"type": "object", "properties": {"title": {"type": "string"}}},
-        location_geo_code="it",
+        country="it",
         time_range="past_week",
     )
 

scrapegraph-py/tests/test_client.py

@@ -144,7 +144,7 @@ def fake_request(method, url, **kwargs):
         num_results=1,
         prompt="Extract titles",
         schema={"type": "object", "properties": {"title": {"type": "string"}}},
-        location_geo_code="it",
+        country="it",
         time_range="past_week",
     )