Skip to main content
Use this route when you want recent news articles instead of general web results.

​
Endpoint

MethodEndpoint
GEThttps://api.pipellm.ai/v1/websearch/search-news

​
Authentication

Authorization: Bearer $PIPELLM_API_KEY

​
Query Parameters

ParameterTypeRequiredDescription
qstringYesNews 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".

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