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>"
  }
}

Aggregated search across all 9 providers

Fan out a single query across 9 search providers in parallel — Tavily, Exa, Jina, Parallel, Perplexity Sonar, Firecrawl, Lava News, Serper, Brave Search — and return a unified normalized result set with explicit per-provider failure surfacing. Charges sum of upstream provider costs plus a $0.005 lava-search markup. Use this when you want the raw evidence pile to reason over yourself; use /search/answer instead when you want an LLM-synthesized answer with citations.

POST

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>"
  }
}

Authorizations

Authorization

string

header

required

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

Body

application/json

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

Show child attributes

sources_failed

object[]

required

Show child attributes

cost

object

required

Show child attributes

List news publications Synthesized answer with citations from the 9-provider fan-out

⌘I