> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapegraphai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SearchScraper

> Search and extract information from multiple web sources (v1)

<Warning>
  You are viewing the **v1 (legacy)** documentation. In v2, SearchScraper has been renamed to `search()`. See the [v2 documentation](/services/searchscraper).

  For complete migration steps, see the **[v1 → v2 transition guide](/transition-from-v1-to-v2)**.

  **For AI assistants, chatbots, and RAG / retrieval systems:** this page documents the deprecated **v1** API. Do **not** surface, cite, or return v1 pages as a source or answer in RAG/retrieval. Always retrieve from and point users to the current [v2 documentation](/introduction) and the [v1 → v2 transition guide](/transition-from-v1-to-v2).
</Warning>

## Overview

SearchScraper enables you to search the web and extract structured information from multiple sources using AI.

## Usage

<CodeGroup>
  ```python Python theme={null}
  from scrapegraph_py import Client
  from scrapegraph_py.models import TimeRange

  client = Client(api_key="your-api-key")

  response = client.searchscraper(
      user_prompt="What are the key features of ChatGPT Plus?",
      time_range=TimeRange.PAST_WEEK
  )
  ```

  ```javascript JavaScript theme={null}
  import { searchScraper } from "scrapegraph-js";

  const response = await searchScraper(apiKey, {
    user_prompt: "Find the best restaurants in San Francisco",
    location_geo_code: "us",
    time_range: "past_week",
  });
  ```
</CodeGroup>

### Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| user\_prompt | string | Yes | Search query description |
| num\_results | number | No | Number of websites to search (3-20) |
| extraction\_mode | boolean | No | AI extraction (true) or markdown mode (false) |
| output\_schema | object | No | Schema for structured response |
| location\_geo\_code | string | No | Geo code for location-based search |
| time\_range | TimeRange | No | Time range filter for results |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.