News Search

Use this route when you want recent news articles instead of general web results.

Endpoint

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

Authentication

Authorization: Bearer $PIPELLM_API_KEY

Query Parameters

Parameter	Type	Required	Description
`q`	string	Yes	News query

Example Request

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

Response Shape

{
  "code": 200,
  "message": "ok",
  "took_ms": 4200,
  "data": {
    "organic": [
      {
        "title": "Latest OpenAI news",
        "link": "https://example.com/news",
        "snippet": "Recent product and research updates...",
        "contexts": [
          {
            "idx": 0,
            "text": "..."
          }
        ]
      }
    ]
  }
}

Notes

This route proxies to the internal /api/search-news handler.
It uses the news-specific search source, then applies the same retrieval flow as deep search.
If no results are found, this route returns 404 with code: 404 and message: "no search results".
Successful requests cost $0.08 each and are recorded with internal model name websearch-news.
PipeLLM derives the model name from the route; clients do not send it.

Deep Search

Search the general web with retrieval support

Simple Search

Fast snippets when you do not need news-specific retrieval

WebSearch Overview

Product overview and route matrix

Overview

Reference

Packages

Endpoint

Authentication

Query Parameters

Example Request

Response Shape

Notes

Deep Search

Simple Search

WebSearch Overview

​Endpoint

​Authentication

​Query Parameters

​Example Request

​Response Shape

​Notes

​Related Docs

Deep Search

Simple Search

WebSearch Overview

Endpoint

Authentication

Query Parameters

Example Request

Response Shape

Notes

Related Docs