fix: align search defaults and migration doc with v2 API contract

- Default num_results changed from 5 to 3 to match API schema
- Fix migration doc: location_geo_code and time_range are NOT removed
- Add prompt, location_geo_code, time_range to migration example

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

Author: VinciGit00

scrapegraph-py/MIGRATION_V2.md

@@ -153,22 +153,27 @@ result = client.get_searchscraper(request_id)
 response = client.search(
     query="What is the latest version of Python?",
     num_results=5,
+    prompt="Extract key findings",
     schema=MyModel,
+    location_geo_code="us",
+    time_range="past_week",
 )
 ```
 
 | v1 parameter | v2 equivalent |
 |---|---|
 | `user_prompt` | `query` |
-| `num_results` | `num_results` (unchanged) |
-| `output_schema` | `schema` |
+| `num_results` | `num_results` (unchanged, default changed from 5 to 3) |
+| `output_schema` | `schema` (now requires `prompt`) |
 | `extraction_mode` | Removed (always AI extraction) |
-| `stealth` | Removed (use `fetch_config=FetchConfig(mode=...)` on other endpoints) |
-| `location_geo_code` | Removed |
-| `time_range` | Removed |
+| `stealth` | Removed (use `fetch_config=FetchConfig(mode=...)`) |
+| `location_geo_code` | `location_geo_code` (unchanged) |
+| `time_range` | `time_range` (values: `past_hour`, `past_24_hours`, `past_week`, `past_month`, `past_year`) |
 | `mock` | Removed |
 | `return_toon` | Removed |
 
+New parameters in v2: `format`, `mode`, `prompt`, `fetch_config`.
+
 > **Note:** `get_searchscraper()` has been removed.
 
 ---

scrapegraph-py/scrapegraph_py/async_client.py

@@ -369,7 +369,7 @@ async def extract(
     async def search(
         self,
         query: str,
-        num_results: int = 5,
+        num_results: int = 3,
         location_geo_code: Optional[str] = None,
         *,
         schema: Optional[Any] = None,
@@ -383,7 +383,7 @@ async def search(
 
         Args:
             query: The search query
-            num_results: Number of results (3-20, default 5)
+            num_results: Number of results (1-20, default 3)
             location_geo_code: Geo code for geo-targeted results
         """
         logger.info(f"Searching: {query}")

scrapegraph-py/scrapegraph_py/client.py

@@ -413,7 +413,7 @@ def extract(
     def search(
         self,
         query: str,
-        num_results: int = 5,
+        num_results: int = 3,
         location_geo_code: Optional[str] = None,
         *,
         schema: Optional[Any] = None,
@@ -427,7 +427,7 @@ def search(
 
         Args:
             query: The search query
-            num_results: Number of results (1-20, default 5)
+            num_results: Number of results (1-20, default 3)
             location_geo_code: Geo code for geo-targeted results
         """
         logger.info(f"Searching: {query}")

scrapegraph-py/scrapegraph_py/models/search.py

@@ -12,7 +12,7 @@ class SearchRequest(CamelModel):
 
     query: str = Field(..., description="The search query")
     num_results: conint(ge=1, le=20) = Field(
-        default=5, description="Number of results to return (1-20)"
+        default=3, description="Number of results to return (1-20)"
     )
     format: str = Field(default="markdown", description="Search scrape format")
     mode: str = Field(default="prune", description="HTML processing mode")

scrapegraph-py/scrapegraph_py/utils/request_builders.py

@@ -130,7 +130,7 @@ def build_extract_payload(
 def build_search_payload(
     *,
     query: str,
-    num_results: int = 5,
+    num_results: int = 3,
     location_geo_code: Optional[str] = None,
     schema: Optional[Any] = None,
     prompt: Optional[str] = None,