Skip to main content
POST
/
search
/
sources
curl --request POST \
  --url https://api.lava.so/v1/search/sources \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "q": "GLP-1 cardiovascular outcomes meta-analyses 2026"
}
'
{
  "results": [
    {
      "source": "<string>",
      "title": "<string>",
      "url": "<string>",
      "snippet": "<string>",
      "published_at": "2023-11-07T05:31:56Z",
      "score": 123,
      "raw": {}
    }
  ],
  "sources_failed": [
    {
      "provider": "<string>",
      "reason": "<string>"
    }
  ],
  "cost": {
    "breakdown": {},
    "markup": "<string>",
    "total": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://lava.so/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer token authentication used for standard API calls. Format: 'Bearer YOUR_API_KEY'

Body

application/json
​
q
string
required

The search query

​
providers
string[] | null

Optional subset of providers to query. Defaults to all 9. Valid ids: tavily, exa, jina, parallel, perplexity, firecrawl, lava_news, serper, brave_search.

​
max_results_per_source
integer | null

Max results per provider (default 10, max 50)

Required range: 1 <= x <= 50
​
since
string<date-time> | null

ISO 8601 timestamp; only results published after this date are returned (provider-dependent — not all upstream APIs honor this).

Response

Aggregated results across the requested providers, with explicit partial-failure surfacing.

​
results
object[]
required
​
sources_failed
object[]
required
​
cost
object
required