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

# Simple Search

> Fast web search snippets through PipeLLM WebSearch

Use this route when you want faster search results without page extraction,
embedding, or reranking.

## Endpoint

| Method | Endpoint                                            |
| ------ | --------------------------------------------------- |
| `GET`  | `https://api.pipellm.ai/v1/websearch/simple-search` |

## Authentication

```text theme={null}
Authorization: Bearer $PIPELLM_API_KEY
```

## Query Parameters

| Parameter | Type   | Required | Description  |
| --------- | ------ | -------- | ------------ |
| `q`       | string | Yes      | Search query |

## Example Request

```bash theme={null}
curl -X GET "https://api.pipellm.ai/v1/websearch/simple-search?q=latest+AI+news" \
  -H "Authorization: Bearer $PIPELLM_API_KEY"
```

## Response Shape

```json theme={null}
{
  "code": 200,
  "message": "ok",
  "took_ms": 950,
  "data": {
    "answerBox": {
      "title": "Latest AI news",
      "snippet": "..."
    },
    "organic": [
      {
        "title": "AI News",
        "link": "https://example.com",
        "snippet": "Latest updates..."
      }
    ]
  }
}
```

## Notes

* This route proxies to the internal `/api/simple-search` handler.
* It returns search results quickly and does not add `contexts` via deep retrieval.
* Successful requests use WebSearch billing.

## Related Docs

<Columns cols={3}>
  <Card title="Deep Search" icon="magnifying-glass" href="/websearch/search-api">
    Use retrieval and reranking when you need richer context
  </Card>

  <Card title="News Search" icon="newspaper" href="/websearch/news-search">
    Search recent news articles instead of general web results
  </Card>

  <Card title="WebSearch Overview" icon="globe" href="/websearch/overview">
    Product overview and full route matrix
  </Card>
</Columns>