Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.polynode.dev/llms.txt

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

Beta. This endpoint is designed for low-volume context enrichment. Results are best-effort, cached, and may be partial when upstream search engines throttle or fail.

​
Endpoint

GET /v2/search/online
Search the public web and return normalized organic results. PolyNode runs this through an internal metasearch adapter and caches responses to keep the endpoint lightweight. 
curl "https://api.polynode.dev/v2/search/online?q=Cavaliers%20Knicks%20injury%20news&max_results=5" \
  -H "x-api-key: YOUR_KEY"

​
Query parameters

ParameterDescription
qSearch query. Required.
max_resultsNumber of normalized organic results. Defaults to 10, capped at 20.
enginesComma-separated engine adapters. Defaults to bing,duckduckgo. brave is available as an opt-in adapter.
languageSearch language. Defaults to en-US.
time_rangeOptional freshness filter when supported: day, week, month, year.
safe_searchSafe-search mode: 0, 1, or 2. Defaults to 0.
cache_ttl_secondsCache TTL for this query. Defaults to 600, capped at 3600.
Rate limit: 3 requests per 10 seconds per API key, in addition to your normal tier limit.

​
Response

{
  "query": "Cavaliers Knicks injury news",
  "source": "search_online",
  "adapter": "searxng",
  "status": "ok",
  "cached": false,
  "engines_requested": ["bing", "duckduckgo"],
  "unresponsive_engines": [],
  "result_count": 2,
  "results": [
    {
      "title": "Cleveland Cavaliers Injury Status - ESPN",
      "url": "https://www.espn.com/nba/team/injuries/_/name/cle/cleveland-cavaliers",
      "domain": "espn.com",
      "snippet": "Visit ESPN for the current injury situation...",
      "engines": ["duckduckgo"],
      "score": 1,
      "category": "general",
      "published_at": null
    }
  ],
  "answers": [],
  "suggestions": [],
  "fetched_at": "2026-05-25T11:10:00.000Z",
  "elapsed_ms": 1200
}
status may be partial when one engine fails but other engines still return results.