Simple Search

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

Authorization: Bearer $PIPELLM_API_KEY

Query Parameters

Parameter	Type	Required	Description
`q`	string	Yes	Search query

Example Request

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

Response Shape

{
  "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.

Deep Search

Use retrieval and reranking when you need richer context

News Search

Search recent news articles instead of general web results

WebSearch Overview

Product overview and full route matrix

Deep Search Reader

Overview

Reference

Packages

Endpoint

Authentication

Query Parameters

Example Request

Response Shape

Notes

Deep Search

News Search

WebSearch Overview

​Endpoint

​Authentication

​Query Parameters

​Example Request

​Response Shape

​Notes

​Related Docs

Deep Search

News Search

WebSearch Overview

Endpoint

Authentication

Query Parameters

Example Request

Response Shape

Notes

Related Docs