Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lithtrix.ai/llms.txt

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

GET /v1/search?q={query}&num_results={n}
Authorization: Bearer ltx_your_key

​
Parameters

ParamTypeRequiredDescription
qstringYesSearch query (1–500 chars)
num_resultsintegerNoResults to return (1–20, default 10)

​
Providers and provider_used

The API tries Brave first. If Brave fails and the host has SEARCH_FALLBACK_ENABLED=true and a TAVILY_API_KEY, the server may answer from Tavily once. There is no query parameter to pick a provider. Successful responses include provider_used: "brave" or "tavily". Brave responses may be cached in Redis (same query + num_results); Tavily responses are not cached in iteration 46, so repeat queries after a fallback miss still hit the providers.

​
Response

{
  "status": "success",
  "query": "Singapore climate policy",
  "provider_used": "brave",
  "results": [
    {
      "title": "Singapore Green Plan 2030",
      "url": "https://www.greenplan.gov.sg",
      "snippet": "...",
      "source": "www.greenplan.gov.sg",
      "credibility_score": 1.0,
      "published_date": null
    }
  ],
  "usage": {
    "calls_total": 42,
    "calls_remaining": 258,
    "over_limit": false,
    "upgrade_url": "/v1/billing/setup"
  },
  "cached": false,
  "response_time_ms": 312
}